0. 接入须知（先看这里）
GET
/docs/v2/overview
1. 基本信息
Authorization: Bearer <你的令牌>application/json（推荐）；需要直接上传本 地文件时用 multipart/form-data2. 尺寸：两种写法二选一
| 写法 | 字段 | 示例 | 说明 |
|---|---|---|---|
| OpenAI 标准写法 | size | "1280x720" | 宽x高像素。平台会换算成模型支持的清晰度档位和宽高比 |
| 比例 + 档位 | aspect_ratio + resolution | "16:9" + "720p" | 不用记像素，按模型支持的比例和档位选 |
parameter_conflict）。aspect_ratio 和 resolution 可以只传其中一个，没传的那个用模型默认值。size 是实际输出尺寸。3. 图片、视频、音频素材怎么传
| 传法 | 适用 | 说明 |
|---|---|---|
| 公网 URL | 图片、视频、音频 | 必须是 http / https 直链，服务端能直接下载；不要传需要登录的网页地址或即将过期的临时链接 |
| data URL | 图片（视频、音频也可以，但需平台转存，建议用 URL） | 形如 data:image/png;base64,xxxx；单张建议不超过 10MB，更大的请用 URL 或文件上传 |
| 文件上传 | 图片、视频、音频 | 使用 multipart/form-data 直接上传文件 |
reference_images），也兼容 reference_images[] 这种写法；数字和布尔值按文本传（例如 seconds=5、generate_audio=true）。4. 参数校验规则
missing_required_parameter。unsupported_parameter，不会被忽略。invalid_parameter。parameter_conflict。invalid_media。素材的时长、分辨率、宽高比由模型服务校验，不符合时返回 upstream_rejected 或任务失败。metadata 等厂商原生透传字段，请使用本文档列出的字段。5. 视频任务流程
1.
POST /v2/videos 创建任务，立即返回任务对象（status=queued）。2.
GET /v2/videos/{video_id} 查询一次，直到 status 变为 completed 或 failed。生成通常需要几分钟；超过 30 分钟仍未完成的任务会被判定失败（error.code=timeout）。3.
video_url 下载视频（在 expires_at 之前有效，一般为完成后 24 小时），也可以调用 GET /v2/videos/{video_id}/content 下载。6. 计费
请求参数
无
请求示例代码
返回响应
修改于 2026-09-30 13:54:50