03-查询视频生成任务列表
查询视频生成任务列表
文档版本：v1.0.0 | 最后更新：2026-06-11 本平台已完整适配豆包 Seedance 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。
GET https://platform.shuyanai.com/seedance/api/v3/contents/generations/tasks请求参数
查询参数（Query Parameters）
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
page_num | integer | 否 | 1 | 页码，从 1 开始 |
page_size | integer | 否 | 20 | 每页返回数量，取值范围：[1, 100] |
请求体（可选）
object| 字段 | 类型 | 说明 |
|---|---|---|
filter.status | string[] | 按任务状态筛选，可传入多个状态值。枚举值：queued、running、succeeded、failed、cancelled、expired |
filter.model | string[] | 按模型 ID 筛选，可传入多个模型 ID |
filter.created_at_start | integer | 按创建时间筛选的起始时间，Unix 时间戳（秒），包含该时刻 |
filter.created_at_end | integer | 按创建时间筛选的结束时间，Unix 时间戳（秒），包含该时刻 |
filter.service_tier | string | 按服务等级筛选。枚举值：default（在线推理）、flex（离线推理） |
请求头
| 头部 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API_KEY} |
Content-Type | 否 | 传入筛选条件时需设为 application/json |
请求示例
基础分页查询
按状态筛选
按时间范围和模型筛选
响应参数
object[]id、model、content、status、created_at、updated_at、service_tier、duration、seed、error、usage、metadata 等字段。integerintegerinteger响应示例
{
"items": [
{
"id": "cgt-20250611100000-xxxxx",
"model": "{MODEL_ID}",
"content": [
{
"type": "video_url",
"video_url": "https://example.com/generated_video_1.mp4"
}
],
"status": "succeeded",
"created_at": 1749619200,
"updated_at": 1749619320,
"service_tier": "default",
"duration": 5,
"seed": 11,
"usage": {
"completion_tokens": 12000,
"total_tokens": 12000
},
"metadata": {
"draft": false
}
},
{
"id": "cgt-20250611110000-yyyyy",
"model": "{MODEL_ID}",
"content": [],
"status": "running",
"created_at": 1749622800,
"updated_at": 1749622860,
"service_tier": "default",
"metadata": {
"draft": false
}
}
],
"total": 42,
"page_num": 1,
"page_size": 10
}注意事项
created_at 开始计算），超时后自动清除，不可再查询。cancelled）在取消后 24 小时自动删除。content.video_url 有效期为 24 小时，如需长期保存请及时下载或转存。