02-查询视频生成任务
查询视频生成任务
文档版本：v1.0.0 | 最后更新：2026-06-11 本平台已完整适配豆包 Seedance 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。
GET https://studio.dataeyes.ai/seedance/api/v3/contents/generations/tasks/{id}路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | 视频生成任务 ID，由创建接口返回 |
请求示例
响应示例
任务成功
{
"id": "cgt-20250611100000-abcde",
"model": "doubao-seedance-2-0-v2-250528",
"status": "succeeded",
"error": null,
"created_at": 1749600000,
"updated_at": 1749600120,
"content": {
"video_url": "https://cdn.example.com/video/output.mp4",
"last_frame_url": ""
},
"seed": 1234567890,
"resolution": "720p",
"ratio": "16:9",
"duration": 10,
"framespersecond": 24,
"generate_audio": true,
"tools": [],
"safety_identifier": "",
"priority": 0,
"service_tier": "default",
"execution_expires_after": 172800,
"usage": {
"completion_tokens": 240,
"total_tokens": 240
}
}任务失败
{
"id": "cgt-20250611100000-abcde",
"model": "doubao-seedance-2-0-v2-250528",
"status": "failed",
"error": {
"code": "content_filter",
"message": "The content was filtered by the safety system."
},
"created_at": 1749600000,
"updated_at": 1749600060
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 任务 ID |
model | string | 模型名称-版本 |
status | string | 任务状态，取值见任务状态值 |
error | object / null | 成功时为 null；失败时包含 code（错误码）和 message（错误描述） |
created_at | integer | 任务创建时间（Unix 时间戳，秒） |
updated_at | integer | 任务最后更新时间（Unix 时间戳，秒） |
content | object | 生成结果对象 |
content.video_url | string | 生成视频的 MP4 下载地址，有效期 24 小时 |
content.last_frame_url | string | 末帧图片地址（仅当创建时 return_last_frame=true 时返回） |
seed | integer | 实际使用的随机种子 |
resolution | string | 实际输出分辨率 |
ratio | string | 实际输出画面比例 |
duration | integer | 实际视频时长（秒）。与 frames 二选一返回 |
frames | integer | 实际视频帧数。与 duration 二选一返回 |
framespersecond | integer | 视频帧率 |
generate_audio | boolean | 是否生成了音频（仅 2.0 系列及 1.5 pro 返回） |
tools | object[] | 实际使用的工具列表 |
safety_identifier | string | 终端用户标识 |
priority | integer | 任务优先级 |
draft | boolean | 是否为样片模式（仅 1.5 pro 返回） |
draft_task_id | string | 关联的样片任务 ID |
service_tier | string | 推理服务层级 |
execution_expires_after | integer | 任务超时时间（秒） |
usage | object | 用量统计 |
usage.completion_tokens | integer | 生成 token 数 |
usage.total_tokens | integer | 总 token 数 |
usage.tool_usage.web_search | integer | 网络搜索调用次数（使用 tools 时返回） |
任务状态值
| 状态 | 含义 |
|---|---|
queued | 排队中 |
running | 生成中 |
succeeded | 生成成功 |
failed | 生成失败 |
cancelled | 已取消 |
expired | 已过期 |
建议：采用轮询方式查询，建议轮询间隔不低于 10 秒，直至状态为 succeeded或failed。视频下载地址有效期为 24 小时，过期后需重新查询获取新地址。
