Story shots

Ao vivo

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

Entrada

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

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

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

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

Preparado

Your shot list shows here

The scene as camera shots, each with its length.

Como funciona

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.

Chame Story shots pelo seu código

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

Pegue uma chave de API
Crie uma chave no console. Ela usa o mesmo saldo do playground.
Criar uma chave

Envie sua primeira requisição

A mesma requisição que o playground envia. Defina OPENNAN_KEY com sua chave.

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"

Consulte a tarefa
A chamada responde na hora com um id de tarefa. Consulte a tarefa até ela terminar:
GEThttps://api.opennan.com/v1/tasks/{id}
queued
Esperando um worker
running
Em produção
succeeded
Pronto: outputs[].url traz os arquivos
failed
Falhou: nada é cobrado

Erros e como resolver

401Chave ausente ou errada
Envie o cabeçalho Authorization: Bearer com uma chave do console.
402Saldo insuficiente
Adicione crédito em Faturamento e envie a mesma chamada de novo.
400Um valor não é aceito
Leia error.message: ele indica o campo. Use um valor da tabela de parâmetros.
429Requisições demais
Aguarde alguns segundos e tente de novo, esperando mais após cada 429.

Adicione a Opennan ao seu app de IA

Uma instalação dá à sua IA todas as ferramentas da Opennan: vídeo, imagens, chat, voz, música, efeitos sonoros, 3D, legendas e dublagem. Escolha seu app e siga os passos.

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

Funciona no Codex CLI, no app do Codex e na extensão do Codex para IDE: todos usam ~/.codex/config.toml. Se o app ou a IDE não enxergar OPENNAN_KEY, use a opção config.toml com sua chave. O Codex pede aprovação antes de cada ferramenta: aprove para seguir.

Pegue uma chave de API
Crie uma chave no console. Ela começa com sk- e usa o mesmo saldo do site.
Criar uma chave

Salve sua chave como 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
Instale o plugin da Opennan: o servidor e uma skill que ensina sua IA a escolher modelos, confirmar preços e esperar os resultados
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

Ou adicione só o servidor

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

Ou adicione isto a ~/.codex/config.toml

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

4
Confira se opennan aparece na lista
```
codex mcp list
```
Reinicie o Codex e peça o que quiser
“Faça um vídeo de 5 segundos de chuva numa rua de neon, uma música para acompanhar e uma imagem de pôster.”

Troque sk-... pela sua chave e mantenha-a em segredo: quem tiver a chave pode gastar seu saldo. Seu app lista as ferramentas sem chave; para criar algo, você precisa de uma.

Use a partir de um agente de IA

Adicione o servidor MCP da Opennan ao seu agente e chame esta ferramenta.

Ferramenta: generate_camera_shots
Argumentos de exemplo: { "description": "A traveler runs toward a train as its doors begin to close.", "total_duration": 10 }

Story shots: perguntas

Quanto custa Story shots?

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

Como chamo pelo meu código?

Envie POST https://api.opennan.com/v1/story/shots com sua chave de API. A resposta é um id de tarefa: consulte https://api.opennan.com/v1/tasks/{id} até a tarefa concluir ou falhar.

Meu agente de IA pode usar?

Sim. Adicione o servidor MCP https://api.opennan.com/v1/mcp e chame a ferramenta generate_camera_shots, ou aponte seu agente para https://api.opennan.com/llms.txt.

O que acontece se uma execução falhar?

Uma execução com falha não é cobrada. Você paga só pelos resultados.

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

Entrada

Saída

Como funciona

Chame Story shots pelo seu código

Pegue uma chave de API

Envie sua primeira requisição

Consulte a tarefa

Erros e como resolver

Adicione a Opennan ao seu app de IA

Use a partir de um agente de IA

Story shots: perguntas