Consistency reference

提供中

Name a character, a location or an object and describe it. Get one clean reference image to keep it looking the same across every shot you make.

From $0.1313 per imageFailed runs are not charged.

入力

What to drawkindcharacter, location or object.

A wide, empty establishing view of the place.

NamenameWhat it is called.

What it looks like任意descriptionWhat it looks like.

163 / 500

Style任意styleThe visual style, e.g. anime or film noir.

For example: anime, film noir, warm 3D animation.

$0.1963 per image.

These tools need an API key with the api:opennan scope: paste one under Use API key to run them.

例

出力の例Made with these inputs Consistency reference

仕組み

01Describe itA name, a look and a style; a photo for a character if you have one.
02We draw the referenceA portrait, an empty establishing view or a product shot.
03Reuse itSend it as a reference image with every shot.

コードから Consistency reference を呼び出す

One endpoint and one key, on the same balance as the playground. The request below is the example's own.

POSThttps://api.opennan.com/v1/consistency/references

API キーを取得
コンソールでキーを作成します。プレイグラウンドと同じ残高を使います。
キーを作成

最初のリクエストを送る

プレイグラウンドが送るのと同じリクエストです。OPENNAN_KEY にキーを設定してください。

curl https://api.opennan.com/v1/consistency/references \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"location","name":"Snowy log cabin","description":"A small wooden log cabin on a snowy mountain slope at dusk, warm light glowing in the windows, smoke from a stone chimney, pine trees and snow-covered peaks behind","style":"warm 3D animation"}'

# Then poll until "status" is "succeeded" or "failed":
curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"

タスクを確認する
呼び出すとすぐにタスク ID が返ります。終わるまでタスクを確認します:
GEThttps://api.opennan.com/v1/tasks/{id}
queued
ワーカーの空き待ち
running
生成中
succeeded
完了: outputs[].url にファイルがあります
failed
失敗: 料金はかかりません

エラーと直し方

401キーがない、または間違っている
コンソールで作ったキーを Authorization: Bearer ヘッダーで送ってください。
402残高不足
請求ページで残高を追加し、同じ呼び出しをもう一度送ってください。
400受け付けられない値がある
error.message にフィールド名が出ます。パラメーター表の値を使ってください。
429リクエストが多すぎる
数秒待ってから再試行し、429 が続くたびに待ち時間を延ばしてください。

AI アプリに Opennan を追加

一度の設定で、AI が Opennan のすべてのツールを使えます：動画、画像、チャット、音声、音楽、効果音、3D、字幕、吹き替え。お使いのアプリを選んで手順に従ってください。

MCP サーバーhttps://api.opennan.com/v1/mcp

Codex CLI、Codex アプリ、Codex の IDE 拡張で使えます（共通の ~/.codex/config.toml）。アプリや IDE が OPENNAN_KEY を読めない場合は、キーを書いた config.toml の方法を使ってください。Codex はツールを呼ぶ前に確認するので、承認して続けます。

API キーを取得
コンソールでキーを作成します。sk- で始まり、サイトと同じ残高を使います。
キーを作成

キーを OPENNAN_KEY として保存

# macOS / Linux (zsh shown; bash: ~/.bashrc)
echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell), then open a new terminal
setx OPENNAN_KEY "sk-..."

3
Opennan プラグインをインストール：サーバーと、モデル選び・価格確認・結果待ちを AI に教えるスキルが入ります
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

またはサーバーだけを追加

codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY

または ~/.codex/config.toml にこれを追加

[mcp_servers.opennan]
url = "https://api.opennan.com/v1/mcp"
http_headers = { Authorization = "Bearer sk-..." }

4
opennan が一覧にあるか確認
```
codex mcp list
```
Codex を再起動して、何でも頼んでください
“ネオン街に降る雨の 5 秒動画と、それに合う曲とポスター画像を作って。”

sk-... をご自身のキーに置き換え、他人に見せないでください。キーを持つ人は残高を使えます。キーがなくてもツール一覧は表示できますが、生成にはキーが必要です。

AI エージェントから使う

エージェントに Opennan の MCP サーバーを追加して、このツールを呼び出します。

ツール: generate_reference_image
引数の例: { "kind": "location", "name": "Snowy log cabin", "description": "A small wooden log cabin on a snowy mountain slope at dusk, warm light glowing in the windows, smoke from a stone chimney, pine trees and snow-covered peaks behind", "style": "warm 3D animation" }