任务查询进度

部分视频任务可以通过通用视频任务接口查询进度。该页面通常用于兼容异步视频任务和需要查看 progress 的场景。

接口信息

项目	值
方法	GET
路径	/v1/videos/{task_id}
示例地址	https://api.gemai.cc/v1/videos/task_abc123def456
鉴权	Authorization: Bearer sk-你的令牌

请求示例

cURL

curl --location 'https://api.gemai.cc/v1/videos/task_abc123def456' \
  --header "Authorization: Bearer $GEMAI_API_KEY"

JavaScript

const response = await fetch('https://api.gemai.cc/v1/videos/task_abc123def456', {
  headers: {
    Authorization: `Bearer ${process.env.GEMAI_API_KEY}`,
  },
})

console.log(await response.json())

Python

import os
import requests

response = requests.get(
    'https://api.gemai.cc/v1/videos/task_abc123def456',
    headers={'Authorization': f"Bearer {os.environ['GEMAI_API_KEY']}"},
    timeout=120,
)

response.raise_for_status()
print(response.json())

返回示例

{
  "id": "task_abc123def456",
  "task_id": "task_abc123def456",
  "status": "in_progress",
  "progress": 50,
  "model": "doubao-seedance-2-0-260128",
  "created_at": 1712345678
}

注意事项

• 该接口返回格式会随任务类型略有差异，请以实际响应为准。
• 如果你使用的是 OpenAI 兼容提交接口，优先使用 OpenAI 兼容任务查询。
• 如果任务已经完成，可以查看 任务查询结果 获取视频内容。