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" }