Story shots

Disponible

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

Entrée

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

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

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

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

Prêt

Your shot list shows here

The scene as camera shots, each with its length.

Comment ça marche

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.

Appelez Story shots depuis votre code

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

Obtenez une clé d’API
Créez une clé dans la console. Elle utilise le même solde que le playground.
Créer une clé

Envoyez votre première requête

La même requête que celle du playground. Définissez OPENNAN_KEY avec votre clé.

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"

Suivez la tâche
L’appel répond tout de suite avec un id de tâche. Interrogez la tâche jusqu’à ce qu’elle se termine :
GEThttps://api.opennan.com/v1/tasks/{id}
queued
En attente d’un worker
running
En cours de création
succeeded
Terminé : outputs[].url contient les fichiers
failed
Échec : rien n’est facturé

Erreurs et solutions

401Clé manquante ou incorrecte
Envoyez l’en-tête Authorization: Bearer avec une clé de la console.
402Solde insuffisant
Ajoutez du crédit dans Facturation, puis renvoyez le même appel.
400Une valeur est refusée
Lisez error.message : il nomme le champ. Utilisez une valeur du tableau des paramètres.
429Trop de requêtes
Attendez quelques secondes et réessayez, un peu plus longtemps après chaque 429.

Ajoutez Opennan à votre app d’IA

Une seule installation donne à votre IA tous les outils Opennan : vidéo, images, chat, voix, musique, effets sonores, 3D, sous-titres et doublage. Choisissez votre app et suivez les étapes.

Serveur MCPhttps://api.opennan.com/v1/mcp

Fonctionne dans Codex CLI, l’app Codex et l’extension Codex pour IDE : elles partagent ~/.codex/config.toml. Si l’app ou l’IDE ne voit pas OPENNAN_KEY, utilisez l’option config.toml avec votre clé. Codex demande avant chaque appel d’outil : approuvez pour continuer.

Obtenez une clé API
Créez une clé dans la console. Elle commence par sk- et utilise le même solde que le site.
Créer une clé

Enregistrez votre clé sous 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
Installez le plugin Opennan : le serveur et un skill qui apprend à votre IA à choisir les modèles, confirmer les prix et attendre les résultats
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

Ou ajoutez seulement le serveur

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

Ou ajoutez ceci à ~/.codex/config.toml

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

4
Vérifiez que opennan est dans la liste
```
codex mcp list
```
Redémarrez Codex, puis demandez ce que vous voulez
“Fais une vidéo de 5 secondes de pluie dans une rue au néon, une chanson pour l’accompagner et une affiche.”

Remplacez sk-... par votre propre clé et gardez-la privée : toute personne qui l’a peut dépenser votre solde. Votre app peut lister les outils sans clé ; il en faut une pour créer quoi que ce soit.

Utilisez-le depuis un agent IA

Ajoutez le serveur MCP d’Opennan à votre agent et appelez cet outil.

Outil: generate_camera_shots
Arguments d’exemple: { "description": "A traveler runs toward a train as its doors begin to close.", "total_duration": 10 }

Story shots : questions

Combien coûte Story shots ?

$0.078 per run. The Run button shows the exact price for your input before you start.

Comment l’appeler depuis mon code ?

Envoyez POST https://api.opennan.com/v1/story/shots avec votre clé d’API. La réponse est un id de tâche : interrogez https://api.opennan.com/v1/tasks/{id} jusqu’à la réussite ou l’échec de la tâche.

Mon agent IA peut-il l’utiliser ?

Oui. Ajoutez le serveur MCP https://api.opennan.com/v1/mcp et appelez l’outil generate_camera_shots, ou indiquez https://api.opennan.com/llms.txt à votre agent.

Que se passe-t-il si une exécution échoue ?

Une exécution en échec n’est pas facturée. Vous ne payez que les résultats.

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

Entrée

Sortie

Comment ça marche

Appelez Story shots depuis votre code

Obtenez une clé d’API

Envoyez votre première requête

Suivez la tâche

Erreurs et solutions

Ajoutez Opennan à votre app d’IA

Utilisez-le depuis un agent IA

Story shots : questions