查询视频任务

查询视频生成任务状态和结果

GET /v1/videos/{task_id}

查询视频任务

cURL

curl --request GET \
  --url https://api.chenyu.cn/v1/videos/{task_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "object": "<string>",
  "model": "<string>",
  "status": "<string>",
  "url": "<string>",
  "error": {}
}

查询视频任务

根据任务 ID 查询视频生成任务状态和结果。

请求参数

task_id · string · required

视频任务 ID，由 创建视频任务 返回

响应参数

id · string

视频任务 ID

object · string

固定为 video

model · string

模型 ID

status · string

任务状态，如 queued、running、succeeded、failed

url · string

视频地址。仅任务完成后返回

error · object

失败信息。仅任务失败时返回

代码示例

Python

import requests

task_id = "cgt-20260602154730-twmv2"
url = f"https://api.chenyu.cn/v1/videos/{task_id}"
headers = {"Authorization": "Bearer your_api_key"}

response = requests.get(url, headers=headers)
print(response.json())

响应示例

{
  "id": "cgt-20260602154730-twmv2",
  "object": "video",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "succeeded",
  "url": "https://example.com/video.mp4"
}