Skip to main content
GET
提交视频任务 后，使用返回的 task_id 轮询查询进度与结果。若提交响应丢失，可用创建时响应头中的 X-Oneapi-Request-Id 做 按 request_id 找回。

​
路径参数

​
string
required
视频生成任务 ID，由提交接口返回。

​
请求头

​
string
required
API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。

​
按 request_id 找回任务

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

​
响应体（/v1/video/generations/{task_id}）

​
string
任务 ID，与提交响应中的 task_id 一致。
​
string
任务状态：queued、running、completed、failed。
​
number
进度百分比（0–100）。
​
string
生成成功后的视频 URL。有时效，请尽快下载保存；部分响应格式字段可能为 result_url，以实际 JSON 为准。
​
integer
上游真实输出 token 数，Token 计费模型的结算依据（与 usage.total_tokens 一致）。

​
轮询建议

状态通常按以下顺序变化：
  • 建议每 5–8 秒 查询一次
  • 成功后的视频 URL 有时效，请尽快下载保存
  • 也可在提交时传入 callback_url 接收完成回调，免去轮询（并非每个渠道都支持，具体适配的渠道请咨询客服；见 任务回调）
  • OpenAI 兼容查询：GET /v1/videos/{task_id}

​
常见问题

一直 queued / failed？ 检查 API Key 余额、分组是否支持该模型。 completed 但没有 video_url？ 不同响应格式字段可能为 result_url 或 output.video_url，以实际 JSON 为准。