获取视频生成任务状态
get/v1/video/generations/{task_id}
查询视频生成任务的状态和结果。
任务状态：
queued: 排队中in_progress: 生成中completed: 已完成failed: 失败
鉴权
把 OLETOKEN 的 API Key 作为 Bearer Token 放进 Authorization 请求头。密钥在控制台的「API 密钥」页创建。
Authorization: Bearer $OLETOKEN_API_KEY请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_idpath | string | 任务 ID |
响应
200成功获取任务状态
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | — | 任务 ID |
| status | stringqueuedin_progresscompletedfailed | — | 任务状态 |
| url | string | — | 视频资源 URL（成功时） |
| format | string | — | 视频格式 |
| metadata | VideoTaskMetadata | — | — |
| duration | number | — | 实际生成的视频时长 |
| fps | integer | — | 实际帧率 |
| width | integer | — | 实际宽度 |
| height | integer | — | 实际高度 |
| seed | integer | — | 使用的随机种子 |
| error | VideoTaskError | — | — |
| code | integer | — | 错误码 |
| message | string | — | 错误信息 |
404任务不存在
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| error | object | — | — |
| message | string | — | 错误信息 |
| type | string | — | 错误类型 |
| param | string | null | — | 相关参数 |
| code | string | null | — | 错误代码 |
请求示例
curl -X GET 'https://api.oletoken.ai/v1/video/generations/{task_id}' \
-H "Authorization: Bearer $OLETOKEN_API_KEY"