Best take
已上线Send up to eight takes of the same shot. Get them ranked best first on sharpness, exposure and how often a face is in frame.
Best take
输入
video_urlsPublic https links to takes of the same shot.- mirror-take-1-eaf3e67f.mp4
- mirror-take-2-61c522e6.mp4
- mirror-take-3-b3ddf51c.mp4
Takes of the same shot, up to 8, each up to 10 minutes.
Free: nothing is held or charged.
These tools need an API key with the api:opennan scope: paste one under Use API key to run them.
运作方式
- 01Send the takesUp to eight https links to the same shot.
- 02We score themSharpness, exposure and faces, frame by frame.
- 03Pick the bestEvery take scored, best first.
从代码调用 Best take
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/qc/best-takes \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"video_urls":["https://cdn.opennan.com/examples/best-take/mirror-take-1-eaf3e67f.mp4","https://cdn.opennan.com/examples/best-take/mirror-take-2-61c522e6.mp4","https://cdn.opennan.com/examples/best-take/mirror-take-3-b3ddf51c.mp4"]}' # 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 服务器加到你的智能体中，然后调用此工具。
- 工具
- best_take_score
- 示例参数
{ "video_urls": [ "https://cdn.opennan.com/examples/best-take/mirror-take-1-eaf3e67f.mp4", "https://cdn.opennan.com/examples/best-take/mirror-take-2-61c522e6.mp4", "https://cdn.opennan.com/examples/best-take/mirror-take-3-b3ddf51c.mp4" ] }
Best take：常见问题
Best take 多少钱？
免费：it needs an API key with the api:opennan scope, and runs are rate limited per account。
如何从代码调用？
带上 API 密钥发送 POST https://api.opennan.com/v1/qc/best-takes。返回任务 ID：查询 https://api.opennan.com/v1/tasks/{id}，直到任务成功或失败。
我的 AI 智能体能用吗？
能。添加 MCP 服务器 https://api.opennan.com/v1/mcp 并调用 best_take_score 工具，或让智能体阅读 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.