查询视频任务 ​

查询已创建的视频生成任务状态和结果。

接口信息 ​

接口：GET https://api-ai.xku.com/doubao/v3/contents/generations/tasks/{task_id}

请求参数 ​

参数说明必填
task_id视频任务 ID是

使用示例 ​

bash
curl -X GET \
  https://api-ai.xku.com/doubao/v3/contents/generations/tasks/{task_id} \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应参数 ​

字段说明
id任务 ID
model使用的模型
status任务状态
content视频内容信息
content.video_url视频下载地址
usageToken 使用量
created_at创建时间
updated_at更新时间
seed随机种子
resolution视频分辨率
ratio视频比例
duration视频时长
framespersecond帧率
service_tier服务等级
execution_expires_after任务过期时间
generate_audio是否包含音频

任务状态说明 ​

状态说明
queued排队中
running任务运行中
succeeded任务成功
failed任务失败
expired任务超时

响应示例 ​

成功响应 ​

json
{
    "id": "doubao.cgt-20250101000000-0000",
    "model": "doubao-seedance-2-0-260128",
    "status": "succeeded",
    "content": {
        "video_url": "https://api-ai.xku.com/videos/xxx.mp4"
    },
    "usage": {
        "completion_tokens": 108900,
        "total_tokens": 108900
    },
    "created_at": 1743414619,
    "updated_at": 1743414673,
    "seed": 10,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "framespersecond": 24,
    "service_tier": "default",
    "execution_expires_after": 172800,
    "generate_audio": true,
    "draft": false
}

处理中响应 ​

json
{
    "id": "doubao.cgt-20250101000000-0000",
    "model": "doubao-seedance-2-0-260128",
    "status": "running",
    "created_at": 1743414619,
    "updated_at": 1743414620
}

注意事项 ​

  1. 视频生成任务为异步任务，需要轮询查询直到状态变为 succeeded 或 failed
  2. 视频下载地址有时效性，请及时下载保存
  3. 任务超时时间默认为 172800 秒（48 小时）
  4. 建议轮询间隔：2-5 秒