Seedance 视频
任务查询与轮询
通过 task_id 或 request_id 查询 / 找回视频生成任务
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_PROGRESS、SUCCESS),视频地址在data.result_url,上游原始 JSON(含usage)在data.dataGET /v1/videos/{task_id}(OpenAI 兼容)→ 扁平{id, object, status, progress, metadata.url},status为小写(如in_progress、completed)
路径参数
string
required
视频生成任务 ID(提交响应中的
id / task_id)。请求头
string
required
API Key 鉴权信息,格式为
Bearer YOUR_API_KEY。按 request_id 找回任务
提交接口超时、客户端未读到 body,但服务端可能已创建成功时:string
网关请求 ID。与路径参数
task_id 二选一场景使用:本接口为查询串形式,无 path 中的 task_id。响应体(/v1/video/generations/{task_id})
string
任务状态:
QUEUED、IN_PROGRESS、SUCCESS、FAILURE 等。string
进度百分比字符串,如
"50%"。string
生成成功后的视频 URL(平台提取自上游响应)。
integer
Token 计费模型(
doubao-seedance-2-0 / -fast)的上游真实输出 token,用于差额结算。轮询建议
状态通常按以下顺序变化:result_url 约 24 小时内有效,请及时 下载。