You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
视频生成 API
查询视频生成任务列表
复制全文
下载 pdf
查询视频生成任务列表
GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks​
通过传入筛选参数,查询符合条件的视频生成任务。​
说明​
  • 视频任务 ID 存在有效期(从 created_at 时间戳开始计算),超时后将自动失效。​
  • Draft 视频任务 ID:2026 年 10 月 28 日 10:00(UTC+8)及之后创建的 Draft 视频任务 ID 有效期为 14 天,此前创建的 Draft 视频任务 ID 有效期仍为 7 天。超出有效期后,无法使用该 Draft 视频生成正式视频。​
  • 其他视频任务 ID:有效期均为 7 天。​
  • 视频 URL 有效期为 24 小时,请及时下载或转存。​
  • Seedance 2.5 模型生成的产物 URL 下载次数上限为 100 次。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。​
​​
请求参数​
Query 参数​
在 URL Query String 中传入。​
filter object | 筛选条件​
​
page_num integer 默认值 1 | 页码​
​
page_size integer 默认值 20 | 每页数量​
​
​
响应参数​
items object[] | 任务列表​
​
total integer | 任务总数​
​
​

Request

curl https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks?page_size=2&filter.status=succeeded& \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY"

Response

{
    "total": 30,
    "items": [
        {
            "id": "cgt-2026****-****",
            "model": "doubao-seedance-2-0-260128",
            "status": "succeeded",
            "content": {
                "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/xxx"
            },
            "usage": {
                "completion_tokens": 109586,
                "total_tokens": 109586
            },
            "created_at": 1779354227,
            "updated_at": 1779354426,
            "seed": 70172,
            "resolution": "720p",
            "ratio": "4:3",
            "duration": 5,
            "framespersecond": 24,
            "service_tier": "default",
            "execution_expires_after": 172800,
            "generate_audio": true,
            "draft": false,
            "priority": 0
        },
        {
            "id": "cgt-2026****-****",
            "model": "doubao-seedance-2-0-260128",
            "status": "succeeded",
            "content": {
                "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/xxx"
            },
            "usage": {
                "completion_tokens": 49761,
                "total_tokens": 49761
            },
            "created_at": 1779353985,
            "updated_at": 1779354268,
            "seed": 68292,
            "resolution": "480p",
            "ratio": "3:4",
            "duration": 5,
            "framespersecond": 24,
            "service_tier": "default",
            "execution_expires_after": 172800,
            "generate_audio": true,
            "draft": false,
            "priority": 0
        },
        {
            "id": "cgt-2026****-****",
            "model": "doubao-seedance-2-0-260128",
            "status": "succeeded",
            "content": {
                "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/xxx"
            },
            "usage": {
                "completion_tokens": 109586,
                "total_tokens": 109586
            },
            "created_at": 1779353885,
            "updated_at": 1779354215,
            "seed": 39832,
            "resolution": "720p",
            "ratio": "3:4",
            "duration": 5,
            "framespersecond": 24,
            "service_tier": "default",
            "execution_expires_after": 172800,
            "generate_audio": true,
            "draft": false,
            "priority": 0
        }
    ]
}
最近更新时间:2026.10.28 10:00:16
这个页面对您有帮助吗?
有用
有用
无用
无用