Consistency reference
LiveName 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.
Consistency reference
Eingabe
kindcharacter, location or object.A wide, empty establishing view of the place.nameWhat it is called.descriptionWhat it looks like.styleThe visual style, e.g. anime or film noir.$0.1963 per image.
These tools need an API key with the api:opennan scope: paste one under Use API key to run them.
So funktioniert’s
- 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 aus deinem Code aufrufen
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/API-Schlüssel holen
Erstelle einen Schlüssel in der Konsole. Er nutzt dasselbe Guthaben wie der Playground.
Schlüssel erstellenErste Anfrage senden
Dieselbe Anfrage, die der Playground sendet. Setze OPENNAN_KEY auf deinen Schlüssel.
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"Task abfragen
Der Aufruf antwortet sofort mit einer Task-ID. Frag den Task ab, bis er fertig ist:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- Wartet auf einen Worker
- running
- Wird erstellt
- succeeded
- Fertig: outputs[].url enthält die Dateien
- failed
- Fehlgeschlagen: wird nicht berechnet
Fehler und wie du sie behebst
401Schlüssel fehlt oder ist falsch
Sende den Header Authorization: Bearer mit einem Schlüssel aus der Konsole.
402Guthaben zu niedrig
Lade unter Abrechnung Guthaben auf und sende denselben Aufruf erneut.
400Ein Wert wird nicht akzeptiert
Lies error.message: Dort steht das Feld. Nimm einen Wert aus der Parametertabelle.
429Zu viele Anfragen
Warte ein paar Sekunden und versuche es erneut, nach jedem 429 etwas länger.
Opennan zu deiner KI-App hinzufügen
Eine Installation gibt deiner KI jedes Opennan-Tool: Video, Bilder, Chat, Stimme, Musik, Soundeffekte, 3D, Untertitel und Synchronisation. Wähle deine App und folge den Schritten.
https:/Funktioniert in der Codex CLI, der Codex-App und der Codex-IDE-Erweiterung: Sie teilen ~/.codex/config.toml. Sieht die App oder IDE OPENNAN_KEY nicht, nimm die config.toml-Variante mit deinem Schlüssel. Codex fragt vor jedem Tool-Aufruf: Bestätige, um weiterzumachen.
API-Schlüssel holen
Erstelle einen Schlüssel in der Konsole. Er beginnt mit sk- und nutzt dasselbe Guthaben wie die Website.
Schlüssel erstellenSpeichere deinen Schlüssel als 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-..."Installiere das Opennan-Plugin: der Server plus ein Skill, der deiner KI beibringt, Modelle zu wählen, Preise zu bestätigen und auf Ergebnisse zu warten
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanOder füge nur den Server hinzu
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOder füge das in ~/.codex/config.toml ein
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Prüfe, ob opennan aufgelistet ist
codex mcp listStarte Codex neu und frag nach allem, was du willst
“Mach ein 5-Sekunden-Video von Regen auf einer Neonstraße, einen passenden Song und ein Posterbild.”
Ersetze sk-... durch deinen eigenen Schlüssel und halte ihn geheim: Wer ihn hat, kann dein Guthaben ausgeben. Deine App kann die Tools ohne Schlüssel auflisten; zum Erstellen brauchst du einen.
Aus einem KI-Agenten nutzen
Füge deinem Agenten den Opennan-MCP-Server hinzu und rufe dieses Tool auf.
- Tool
- generate_reference_image
- Beispielargumente
{ "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" }
Consistency reference: Fragen
Was kostet Consistency reference?
From $0.1313 per image. The Run button shows the exact price for your input before you start.
Wie rufe ich es aus meinem Code auf?
Sende POST https://api.opennan.com/v1/consistency/references mit deinem API-Schlüssel. Die Antwort ist eine Task-ID: Frag https://api.opennan.com/v1/tasks/{id} ab, bis der Task fertig oder fehlgeschlagen ist.
Kann mein KI-Agent es nutzen?
Ja. Füge den MCP-Server https://api.opennan.com/v1/mcp hinzu und rufe das Tool generate_reference_image auf, oder verweise deinen Agenten auf https://api.opennan.com/llms.txt.
Was passiert, wenn ein Durchlauf fehlschlägt?
Ein fehlgeschlagener Durchlauf wird nicht berechnet. Du zahlst nur für Ergebnisse.
Which API key do I need?
A key with the api:opennan scope. A full api key does not include it: create one with that scope in the console, then use it here under Use API key or in your code.