文档中心

火山方舟

视频生成 API

查询视频生成任务

GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}

查询视频生成任务的状态。

说明

仅支持查询最近 7 天的任务记录，时间区间为 [T-7 天, T)，其中 T 为请求发起时刻的 UTC 时间戳（精确到秒）。

视频 URL 有效期为 24 小时，请及时下载或转存。

Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

API Key 鉴权，请在 API Key 管理页面，获取长效 API Key。

请求参数

Path 参数

id string 必选 | 任务 ID

响应参数

id string | 任务 ID

model string | 模型名称与版本

status string | 任务状态

content object | 输出内容

created_at integer | 创建时间

duration integer | 视频时长（秒）

error object | 错误信息

execution_expires_after integer | 任务超时阈值（秒）

frames integer | 视频帧数

framespersecond integer | 视频帧率

generate_audio boolean | 是否生成同步音频

output_format string | 输出格式

priority integer | 执行优先级

ratio string | 宽高比

resolution string | 分辨率

safety_identifier string | 终端用户标识

seed integer | 随机种子

service_tier string | 服务等级

tools object[] | 实际使用的工具

updated_at integer | 更新时间

usage object | token 用量

默认

发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！

Request

TASK_ID="your_task_id"
curl -X GET "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY"

Response

{
    "id": "cgt-2026****-****",
    "model": "doubao-seedance-2-0-260128",
    "status": "succeeded",
    "content": {
        "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx"
    },
    "usage": {
        "completion_tokens": 108900,
        "total_tokens": 108900
    },
    "created_at": 1779348818,
    "updated_at": 1779348874,
    "seed": 78674,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "framespersecond": 24,
    "service_tier": "default",
    "execution_expires_after": 172800,
    "generate_audio": true,
    "draft": false,
    "priority": 0
}

最近更新时间：2026.09.29 14:30:13

这个页面对您有帮助吗？

有用

无用