Skip to content

获取视频任务状态

根据视频任务 ID 查询任务进度。

重要提示 (关于 New API / One API 兼容性)

New API / One API 平台目前不支持 /v1/videos/{id} 接口。 由于中转分发平台不支持非标准的 OpenAI 路由,无法通过中转平台查询此状态。请直接向本站地址 https://api.gemai.cc 发起请求,或者使用完美兼容中转平台的 OpenAI 兼容视频查询 接口。

接口信息

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

代码示例

bash
curl --location 'https://api.gemai.cc/v1/videos/video_task_xxx' \
  --header "Authorization: Bearer $GEMAI_API_KEY"
javascript
const taskId = 'video_task_xxx'
const response = await fetch(`https://api.gemai.cc/v1/videos/${taskId}`, {
  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/video_task_xxx',
    headers={'Authorization': f"Bearer {os.environ['GEMAI_API_KEY']}"},
    timeout=120,
)

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

返回示例

json
{
  "id": "video_task_xxx",
  "status": "processing",
  "progress": 42
}

注意事项

  • 常见状态包括 queuedprocessingsucceededfailed
  • 未完成时继续轮询即可。