任务查询 · BytePlus
火山引擎 Doubao-Seedance-1.5-pro 视频任务查询
URL：/v3/contents/generations/tasks/:id
Method：GET
用于查询 BytePlus 视频生成任务状态，id 为提交生成接口返回的任务 id。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 路径参数，上一步返回的任务 id |
返回参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | — | 视频生成任务 ID |
| model | string | — | 任务使用的模型名称与版本（Model name-Version） |
| status | string | — | 任务状态。有效值：queued 排队中、running 执行中、cancelled 已取消（仅 queued 状态可取消）、succeeded 成功、failed 失败、expired 已过期 |
| error | object ／ null | — | 错误信息。任务成功时为 null，失败时返回错误对象（含嵌套属性）。详见 Error codes |
| created_at | integer | — | 任务创建时间，Unix 时间戳（秒） |
| updated_at | integer | — | 任务最后更新时间，Unix 时间戳（秒） |
| seed | integer | — | 本次请求使用的 seed 值 |
| resolution | string | — | 生成视频的分辨率 |
| ratio | string | — | 生成视频的宽高比 |
| duration | integer | — | 生成视频时长（秒）。与 frames 二选一返回：创建请求未指定 frames 时返回 duration |
| frames | integer | — | 生成视频的帧数。与 duration 二选一返回：创建请求指定了 frames 时返回 frames |
| framespersecond | integer | — | 生成视频的帧率 |
| generate_audio | boolean | — | （仅 Seedance 1.5 pro）生成视频是否包含与画面同步的音频。true 为带音视频，false 为静音视频 |
| draft | boolean | — | （仅 Seedance 1.5 Pro 返回）当前输出是否为 Draft 视频。true 为草稿视频，false 为标准视频 |
| execution_expires_after | integer | — | 任务过期阈值（秒） |
| usage | object | — | 本次请求的 token 用量（含嵌套属性） |
| content | object | — | 任务成功（status=succeeded）时的输出对象，属性见下方「content 对象属性」 |
content 对象属性（任务成功时返回）
仅 content 对象内的字段，与上述顶层返回参数同级区分。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content.video_url | string | — | 输出视频的 URL。出于安全考虑，输出视频 24 小时后会被删除，请及时保存 |
| content.last_frame_url | string | — | 生成视频尾帧的 URL，有效期 24 小时，请及时保存。创建视频生成任务时若设置了 return_last_frame: true 则会返回 |
cURL 示例
bash
TASK_ID="替换为上一步返回的id"
curl -X GET "$BASE_URL/v3/contents/generations/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY"