查询任务

  • 查询以豆包原生格式提交的视频任务状态与结果
  • 状态流转：pending → processing → succeeded / failed
  • 建议每 5 秒查询一次，10 分钟仍未完成可放弃
GET/doubao/api/v3/contents/generations/tasks/{task_id}

认证

string必填

所有接口均使用 Bearer Token 进行认证。

Seedance 系列的接口需要在 ark 站 单独获取 Key，与 api 站的 Key 不通用。

请求时在请求头中添加：

Authorization: Bearer YOUR_ARK_KEY

路径参数

string必填

提交任务时返回的任务 ID。

状态流转

pending -> processing -> succeeded   成片可取
                      -> failed      查看 error 字段
  • pending：已受理，排队中
  • processing：生成中
  • succeeded：已完成，成片地址在 content.video_url
  • failed：已失败，原因在 error.message

轮询节奏：每 5 秒一次，总超时约 10 分钟。多数 Seedance 任务在 1 到 3 分钟内完成。

响应

string

任务 ID。

string

实际使用的模型。

string

取值 pending、processing、succeeded、failed。

content 的元素字段
string

成功时返回的成片地址。

string

末帧图片地址。提交时把 return_last_frame 设为 true 才会返回，与成片同时产出，同样是带签名的临时地址。

integer

本次实际使用的种子。

string

实际输出分辨率。

integer

实际输出秒数。

string

实际输出画幅比例。

integer

实际输出帧率。

string

实际生效的服务档位。

usage 的元素字段 · 2 项
integer

上游返回时才有。

integer

上游返回时才有。

error 的元素字段 · 2 项
string

失败时返回，如 content_policy_violation。

string

失败时的错误描述。

integer

创建时间，Unix 秒。

integer

状态更新时间，Unix 秒。

错误码

HTTP含义
401Token 缺失或无效，type 为 authentication_error

更多状态码与重试建议见错误码与限流，常见报错的排查步骤见常见问题。

使用示例