视频分析
已上线上传最长 120 秒的视频。获得每个镜头的时间范围和画面帧、发生了什么、转折点和结局，以及翻拍时应保留的内容。
Break down video
把视频变成逐镜头报告，附带画面帧和时间点。
按次付费 · 视频最长 120 秒 · 每小时 3 次分析
Files are processed privately and are not published. Analysis sends selected media to an AI model; temporary source files are removed afterward.
Open image generation and editingAPI endpoint
POST /v1/media/video-breakdownAuthenticate with an API key. Download accepts JSON with url and optional max_height; inspection accepts multipart file. Keys stay in memory.
示例输出这是对一部知识共享许可预告片的真实运行结果。使用你自己的链接或文件即可替换。
Big Buck Bunny trailer (CC) Blender Foundation | www.bigbuckbunny.org — CC BY 3.0, via Wikimedia Commons
运作方式
- 01添加视频上传最长 120 秒的片段，或先通过链接下载。
- 02获取报告每个镜头的时间范围、画面帧和内容。
- 03检查并复用点击画面帧跳转到对应时刻，查看标记的细节，并将报告保存为 JSON。
从代码调用 视频分析
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/media/video-breakdown \ -H "Authorization: Bearer $OPENNAN_KEY" \ -F "[email protected]"读取结果
结果在同一个响应里返回。X-Usage-Cost-Usd 响应头写明本次调用的费用。
错误及解决方法
401缺少密钥或密钥错误
用 Authorization: Bearer 请求头发送控制台中的密钥。
402余额不足
在账单页面充值，然后重新发送同一请求。
400有值不被接受
查看 error.message，它会指出字段。请使用参数表中的值。
429请求过多
等几秒再试，每次遇到 429 都等得更久一些。
视频分析：常见问题
视频分析 多少钱？
按每次运行实际使用的 AI token 付费。先从余额中预留单次运行的最高费用，多余部分退回。在 AI 读取文件之前失败的运行不收费；AI 读取文件后，即使运行随后失败，也会按已使用的 token 收费。
如何从代码调用？
带上 API 密钥发送 POST https://api.opennan.com/v1/media/video-breakdown。结果在同一个响应里返回。
我的 AI 智能体能用吗？
能。让智能体阅读 https://api.opennan.com/llms.txt，里面说明了这个接口和其他所有接口。
运行失败会怎样？
失败的请求不收费。只为实际使用的 token 付费。