AI 模型接口视频（Videos）
获取视频生成任务状态
接口
GET /v1/video/generations/{task_id}
请求头
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <token> |
Accept | 建议 | application/json |
路径参数
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
task_id | 是 | string | 任务 ID |
响应参数
application/json
顶层字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 任务 ID |
task_id | string | 任务 ID 别名 |
object | string | 固定为 video |
model | string | 模型 ID |
status | string | 任务状态，支持 queued、in_progress、completed、failed、unknown |
progress | integer | 任务进度百分比 |
created_at | integer | 创建时间戳 |
completed_at | integer | 完成时间戳 |
seconds | string | 视频时长（秒） |
size | string | 尺寸信息 |
remixed_from_video_id | string | 混剪来源 ID（如有） |
metadata.url | string | 最终视频地址 |
error.message | string | 失败原因 |
error.code | string | 失败码 |
metadata
| 字段 | 类型 | 说明 |
|---|---|---|
url | string | 完成后的视频地址 |
duration | number | 实际生成时长 |
resolution | string | 实际输出分辨率 |
ratio | string | 实际输出比例 |
seed | integer | 实际随机种子 |
error
| 字段 | 类型 | 说明 |
|---|---|---|
code | string | 失败码 |
message | string | 失败原因 |
错误响应
404 Not Found
| 字段 | 类型 | 说明 |
|---|---|---|
error.message | string | 错误信息 |
error.type | string | 错误类型 |
error.param | string | null | 相关参数 |
error.code | string | null | 错误代码 |
说明
status表示任务当前进度，查询到completed后通常可以从metadata.url获取结果。error字段会在任务失败时提供更详细的错误信息。