查询视频生成任务

本接口用于查询单个视频生成任务的当前状态与结果。创建任务后，您可以使用此接口轮询任务状态，直到状态变为 succeeded，再从返回结果中获取生成视频和其他输出信息。

提示

仅支持查询最近 7 天内创建的历史任务。时间范围以发起查询请求的时刻为基准，向前推算 7 天（精确到秒）。

请求方法

GET：<ai-api-base-url>/llm/v1/contents/generations/tasks/{task_id}

其中，<ai-api-base-url> 为您的 API Key 所属数据中心的域名：

• 北京数据中心：https://ai.rong-api.com
• 北美数据中心：https://ai.us-light-api.com

请求头参数

参数名	类型	是否必填	默认值	说明
Authorization	string	是	-	身份认证令牌，格式为 Bearer <your API key>，需替换为实际 API Key，用于验证用户权限。

路径参数

参数名	类型	是否必填	说明
task_id	string	是	创建视频生成任务时返回的任务 ID（id 字段的值）。

请求示例

cURL

bash

curl --request GET \
  --url '<ai-api-base-url>/llm/v1/contents/generations/tasks/cgt-2025xxxxxx-xxxx' \
  --header 'Authorization: Bearer <token>'

Python

python

import requests
import time

headers = {
    "Authorization": "Bearer <token>"
}

task_id = "cgt-2025xxxxxx-xxxx"  # 替换为实际任务 ID
while True:
    response = requests.get(
        f"<ai-api-base-url>/llm/v1/contents/generations/tasks/{task_id}",
        headers=headers
    )
    result = response.json()
    status = result.get("status")

    if status == "succeeded":
        print("视频生成成功")
        print("视频下载地址：", result["content"]["video_url"])
        break
    elif status in ("failed", "cancelled", "expired"):
        print(f"任务结束，状态：{status}")
        if result.get("error"):
            print("错误信息：", result["error"]["message"])
        break
    else:
        print(f"当前状态：{status}，10 秒后重试...")
        time.sleep(10)

JavaScript

JavaScript

const taskId = 'cgt-2025xxxxxx-xxxx'; // 替换为实际任务 ID

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>'
  }
};

fetch(`<ai-api-base-url>/llm/v1/contents/generations/tasks/${taskId}`, options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

返回结果

参数名	类型	是否必返	说明
id	string	是	视频生成任务 ID。
model	string	是	执行本次任务所使用的模型名称。
status	enum<string>	是	任务当前状态。可能的值：queued（排队中）、running（生成中）、succeeded（已完成）、failed（已失败）、cancelled（已取消，仅排队中任务支持取消，取消记录会在约 24 小时后自动清理）、expired（已超时，表示任务在排队或执行期间超过 execution_expires_after 阈值）。
error	object	否	任务失败时返回，包含错误详情。
error.code	string	否	错误码。
error.message	string	否	错误描述信息。
created_at	integer	是	任务创建时间（Unix 时间戳，单位：秒）。
updated_at	integer	是	任务最后更新时间（Unix 时间戳，单位：秒）。
content	object	否	任务成功后返回，包含生成内容信息。
content.video_url	string	否	生成视频的下载地址（MP4 格式）。有效期 24 小时，请及时转存。
content.last_frame_url	string	否	视频尾帧图像的下载地址（PNG 格式，无水印）。仅在创建任务时设置了 return_last_frame: true 时返回。有效期 24 小时，请及时转存。
seed	integer	否	本次生成使用的随机种子。
resolution	string	否	生成视频的分辨率，如 "720p"。
ratio	string	否	生成视频的宽高比，如 "16:9"。
duration	integer	否	生成视频时长，单位：秒。创建任务时未指定 frames 时返回此字段。
frames	integer	否	生成视频的帧数。创建任务时按帧数控制长度时返回此字段。duration 和 frames 只会返回一个。
framespersecond	integer	否	生成视频的帧率（FPS）。
generate_audio	boolean	否	生成的视频是否包含同步音频。仅 Doubao/Doubao-seedance-2.0、Doubao/Doubao-seedance-2.0-fast、Doubao/Doubao-seedance-1.5-pro 返回。
tools	object[]	否	本次任务实际使用的工具。未使用工具时不返回。
tools[].type	string	否	工具类型。当前可能返回 web_search。
safety_identifier	string	否	终端用户唯一标识符。若创建任务时设置了该字段，查询接口会原样返回。
draft	boolean	否	当前输出是否为 Draft 视频。仅 Doubao/Doubao-seedance-1.5-pro 返回。
draft_task_id	string	否	基于 Draft 视频生成正式视频时，对应的 Draft 视频任务 ID。
service_tier	string	否	实际处理任务使用的服务等级，如 default 或 flex。
execution_expires_after	integer	否	任务超时阈值，单位：秒。
usage	object	否	本次任务的 token 用量统计。
usage.completion_tokens	integer	否	生成视频消耗的输出 token 数量。对于 Seedance 2.0 系列模型，如果实际 token 用量低于最低计费门槛，则此字段返回最低计费对应的 token 数量，并按该值计费。
usage.total_tokens	integer	否	总 token 消耗。视频生成模型不统计输入 token，因此通常与 completion_tokens 相同。
usage.tool_usage	object	否	工具用量信息。
usage.tool_usage.web_search	integer	否	实际调用联网搜索工具的次数。仅使用 web_search 时返回。

返回结果示例

JSON

{
  "id": "cgt-2025xxxxxx-xxxx",
  "model": "Doubao/Doubao-seedance-2.0",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated-video.mp4",
    "last_frame_url": "https://example.com/last-frame.png"
  },
  "usage": {
    "completion_tokens": 246840,
    "total_tokens": 246840,
    "tool_usage": {
      "web_search": 1
    }
  },
  "created_at": 1765510475,
  "updated_at": 1765510559,
  "seed": 58944,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "tools": [
    {
      "type": "web_search"
    }
  ],
  "safety_identifier": "user_2f1c19a4d7",
  "service_tier": "default",
  "execution_expires_after": 172800
}