Skip to main content
GET
视频生成任务提交后,通过 task_id 轮询查询任务状态与生成结果。SD2 推荐路径GET /v1/video/generations/{task_id}。若提交响应丢失,可用创建时响应头中的 X-Oneapi-Request-Id按 request_id 找回
两种查询路径返回结构不同,请与提交路径保持一致:
  • GET /v1/video/generations/{task_id}(SD2 主路径)→ {code, data: TaskDto}status 为大写(如 IN_PROGRESSSUCCESS),视频地址在 data.result_url,上游原始 JSON(含 usage)在 data.data
  • GET /v1/videos/{task_id}(OpenAI 兼容)→ 扁平 {id, object, status, progress, metadata.url}status 为小写(如 in_progresscompleted

路径参数

string
required
视频生成任务 ID(提交响应中的 id / task_id)。

请求头

string
required
API Key 鉴权信息,格式为 Bearer YOUR_API_KEY

按 request_id 找回任务

提交接口超时、客户端未读到 body,但服务端可能已创建成功时:
生产集成优先在提交时带 Idempotency-Key,用同一业务键重试即可拿回原任务;request_id 找回适合「没带幂等键、但保存了响应头」的补救路径。
string
网关请求 ID。与路径参数 task_id 二选一场景使用:本接口为查询串形式,无 path 中的 task_id。

响应体(/v1/video/generations/{task_id}

string
任务状态:QUEUEDIN_PROGRESSSUCCESSFAILURE 等。
string
进度百分比字符串,如 "50%"
string
生成成功后的视频 URL(平台提取自上游响应)。
integer
Token 计费模型(doubao-seedance-2-0 / -fast)的上游真实输出 token,用于差额结算。

轮询建议

状态通常按以下顺序变化:
成功后的 result_url 约 24 小时内有效,请及时 下载