Story shots

Q: 运行失败会怎样？

失败的运行不收费。只为结果付费。

已上线

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

输入

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

Style可选styleThe visual style, e.g. anime or film noir.

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

Location可选location_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.

就绪

Your shot list shows here

The scene as camera shots, each with its length.

运作方式

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

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 密钥
在控制台创建密钥。它与试用区使用同一余额。
创建密钥

发送第一个请求

与试用区发送的请求相同。把 OPENNAN_KEY 设为你的密钥。

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"

查询任务
调用会立即返回任务 ID。查询任务直到完成：
GEThttps://api.opennan.com/v1/tasks/{id}
queued
等待处理
running
生成中
succeeded
完成：outputs[].url 中是文件
failed
失败：不收费

错误及解决方法

401缺少密钥或密钥错误
用 Authorization: Bearer 请求头发送控制台中的密钥。
402余额不足
在账单页面充值，然后重新发送同一请求。
400有值不被接受
查看 error.message，它会指出字段。请使用参数表中的值。
429请求过多
等几秒再试，每次遇到 429 都等得更久一些。

把 Opennan 添加到你的 AI 应用

安装一次，你的 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_camera_shots
示例参数: { "description": "A traveler runs toward a train as its doors begin to close.", "total_duration": 10 }

Story shots：常见问题

Story shots 多少钱？

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

如何从代码调用？

带上 API 密钥发送 POST https://api.opennan.com/v1/story/shots。返回任务 ID：查询 https://api.opennan.com/v1/tasks/{id}，直到任务成功或失败。

我的 AI 智能体能用吗？

能。添加 MCP 服务器 https://api.opennan.com/v1/mcp 并调用 generate_camera_shots 工具，或让智能体阅读 https://api.opennan.com/llms.txt。

运行失败会怎样？

失败的运行不收费。只为结果付费。

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

输入

输出

运作方式

从代码调用 Story shots

获取 API 密钥

发送第一个请求

查询任务

错误及解决方法

把 Opennan 添加到你的 AI 应用

在 AI 智能体中使用

Story shots：常见问题