Skip to main content
GET
查询视频任务

查询与状态判断

将 <TASK_ID> 替换为返回的 id,每 10 到 15 秒查询一次:
生成可能需要数分钟;查询成功返回 HTTP 200 时,也要检查任务状态。

读取成功结果

成功响应的关键字段如下,下载地址以实际响应为准:
任务成功后,按 下载视频 保存文件。

失败与重试

查询断线后使用原 id 继续查询。任务记录保留 7 天;找不到任务时,请确认任务标识和 API 令牌所属账号。failed、cancelled、expired 都应停止轮询。 收到 429 或临时不可用错误时,等待后重试查询,不要重新创建任务。查询不到任务时,确认任务标识和 API 令牌所属账号。

授权

Authorization
string
header
必填

API key (sk-xxx)

路径参数

task_id
string
必填

创建任务时返回的 id

响应

任务对象

视频任务对象。

id
string

任务 ID

示例:

"task_ADQ5XK6AKWg36WePoJ3sZRyDvWl1ogGZ"

model
string
示例:

"doubao-seedance-2-5-260628"

status
enum<string>

任务状态

可用选项:
queued,
running,
succeeded,
failed,
cancelled,
expired
error
object | null

任务未成功时的错误,成功时为 null。

content
object | null

状态为 succeeded 时的产物地址,下载时携带同一个 API 令牌。

usage
object
output_format
string
示例:

"mp4"

framespersecond
integer
示例:

24

resolution
string

运行中为请求值,成功后为实际交付值。

ratio
string

运行中为请求值,成功后为实际交付值。

duration
integer

运行中为请求值,成功后为实际交付值。

generate_audio
boolean
priority
integer
service_tier
string
示例:

"default"

execution_expires_after
integer
示例:

172800

safety_identifier
string
created_at
integer

创建时间(Unix 秒)

updated_at
integer

最近更新时间(Unix 秒)