Story shots

Live

Describe what happens in a scene. Get a shot list: each shot a plain description of the camera and the action, with its length in seconds.

$0.078 per runFailed runs are not charged.

Story shots

Eingabe

Scene descriptiondescriptionWhat happens in the scene, where and with whom.

0 / 4.000

What happens in the scene, in your own words.

Scene lengthtotal_durationSeconds the scene should last (3 to 60).10 s

StyleoptionalstyleThe visual style, e.g. anime or film noir.

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

Locationoptionallocation_nameWhere the scene happens.

$0.078 per run.

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

Bereit

Your shot list shows here

The scene as camera shots, each with its length.

So funktioniert’s

01Describe the sceneWhat happens, who is in it and where.
02We plan the shotsCamera moves and action, checked to flow as one scene.
03Get the listPlain descriptions with their lengths, ready to film or generate.

Story shots aus deinem Code aufrufen

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/story/shots

API-Schlüssel holen
Erstelle einen Schlüssel in der Konsole. Er nutzt dasselbe Guthaben wie der Playground.
Schlüssel erstellen

Erste Anfrage senden

Dieselbe Anfrage, die der Playground sendet. Setze OPENNAN_KEY auf deinen Schlüssel.

curl https://api.opennan.com/v1/story/shots \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"A traveler runs toward a train as its doors begin to close.","total_duration":10}'

# 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.

MCP-Serverhttps://api.opennan.com/v1/mcp

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 erstellen

Speichere 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-..."

3
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@opennan
```

Oder füge nur den Server hinzu

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

Oder füge das in ~/.codex/config.toml ein

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

4
Prüfe, ob opennan aufgelistet ist
```
codex mcp list
```
Starte 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_camera_shots
Beispielargumente: { "description": "A traveler runs toward a train as its doors begin to close.", "total_duration": 10 }

Story shots: Fragen

Was kostet Story shots?

$0.078 per run. 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/story/shots 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_camera_shots 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.

Story shots

Eingabe

Ausgabe

So funktioniert’s

Story shots aus deinem Code aufrufen

API-Schlüssel holen

Erste Anfrage senden

Task abfragen

Fehler und wie du sie behebst

Opennan zu deiner KI-App hinzufügen

Aus einem KI-Agenten nutzen

Story shots: Fragen