快速开始
鉴权方式、接口一览、完整调用流程与最小可运行示例。
素材与参数
参考图 / 视频 / 音频的统一写法、字段别名与素材要求。
模型清单
各系列模型的分辨率、画幅、参考素材与时长支持，以及各自的参数位置差异。
查询与下载
轮询任务状态、状态枚举、失败原因排查与成片下载。
计费与错误
计费规则、HTTP 状态码、错误返回结构与重试建议。
OpenAI 兼容路径
已按 OpenAI 视频接口对接的业务，可使用的等价路径说明。
接口一览
| 用途 | Method | 路径 |
|---|---|---|
| 创建视频任务 | POST | /v1/video/generations |
| 查询任务状态 | GET | /v1/video/generations/{task_id} |
| 下载成片 | GET | /v1/videos/{task_id}/content |
| 下载成片（带下载头） | GET | /v1/videos/{task_id}/download |
| 图片生成 | POST | /v1/images/generations |
用 AI 写对接代码？点右上角「复制文档」，会把完整对接文档（Markdown 格式，含参数表、示例代码与要点提醒）复制到剪贴板，直接粘贴给 AI 助手即可。
两点最容易出错的地方：① 请求参数 seconds 必须传字符串（"8"），传裸数字 8 会返回 400；② 判断任务是否完成，只认 data.status，不要用 data.data.status 或 progress。