Storyboard
已上线Describe a scene, optionally with its shots and pictures of your characters. Get one storyboard sheet, a panel per shot, and every panel as its own image, in reading order.
Storyboard
输入
descriptionWhat happens in the scene, where and with whom.panel_countHow many panels to draw (or cut).4styleThe visual style, e.g. anime or film noir.aspect_ratioThe frame shape of each panel.referencesReference images the panels follow: image_url, kind (character, object or location) and a character's name.
explorer-thumbnail-a45a7f1e.pngLeo
Pictures of characters the panels keep the same, up to 4.
From $1.014 per sheet, by panels and reference images.
These tools need an API key with the api:opennan scope: paste one under Use API key to run them.
4 panels4 panels
4 panels
Full sheet
运作方式
- 01Describe the sceneWhat happens, where and with whom, up to 2,000 characters, with a style and panel shape.
- 02We draw the sheetOne panel per shot, keeping your characters the same.
- 03Get the panelsThe full sheet and each panel as its own image.
从代码调用 Storyboard
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/获取 API 密钥
在控制台创建密钥。它与试用区使用同一余额。
创建密钥发送第一个请求
与试用区发送的请求相同。把 OPENNAN_KEY 设为你的密钥。
curl https://api.opennan.com/v1/storyboards \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"description":"Leo, a cheerful young explorer in a green jacket with a big backpack, climbs a snowy mountain trail at dusk, spots a log cabin with warm glowing windows, steps inside and finds an old map pinned to the wall showing a hidden lake beyond the peaks.","panel_count":4,"style":"warm 3D animation, soft volumetric light","aspect_ratio":"16:9","references":[{"image_url":"https://cdn.opennan.com/examples/3d/explorer-thumbnail-a45a7f1e.png","kind":"character","name":"Leo"}]}' # 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、字幕和配音。选择你的应用，按步骤操作。
https:/适用于 Codex CLI、Codex 应用和 Codex IDE 扩展：它们共用 ~/.codex/config.toml。如果应用或 IDE 读不到 OPENNAN_KEY，请用写入密钥的 config.toml 方式。Codex 每次调用工具前会询问，批准即可继续。
把密钥保存为 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-..."安装 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-..." }确认列表里有 opennan
codex mcp list重启 Codex，然后让它做任何事
“做一段 5 秒的霓虹街道下雨视频，再配一首歌和一张海报图。”
把 sk-... 换成你自己的密钥并妥善保管：拿到它的人可以花你的余额。没有密钥时应用也能列出工具，但生成内容需要密钥。
在 AI 智能体中使用
把 Opennan MCP 服务器加到你的智能体中，然后调用此工具。
- 工具
- generate_storyboard_sheet
- 示例参数
{ "description": "Leo, a cheerful young explorer in a green jacket with a big backpack, climbs a snowy mountain trail at dusk, spots a log cabin with warm glowing windows, steps inside and finds an old map pinned to the wall showing a hidden lake beyond the peaks.", "panel_count": 4, "style": "warm 3D animation, soft volumetric light", "aspect_ratio": "16:9", "references": [ { "image_url": "https://cdn.opennan.com/examples/3d/explorer-thumbnail-a45a7f1e.png", "kind": "character", "name": "Leo" } ] }
Storyboard：常见问题
Storyboard 多少钱？
From $1.014 per sheet. The Run button shows the exact price for your input before you start.
如何从代码调用？
带上 API 密钥发送 POST https://api.opennan.com/v1/storyboards。返回任务 ID：查询 https://api.opennan.com/v1/tasks/{id}，直到任务成功或失败。
我的 AI 智能体能用吗？
能。添加 MCP 服务器 https://api.opennan.com/v1/mcp 并调用 generate_storyboard_sheet 工具，或让智能体阅读 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.