跳转到主要内容
查询视频生成任务
使用创建任务返回的 id 和同一账号的 API Key 查询。Seedance 2.0、2.5 共用此接口。点击“试一试”,自动带入本次会话中最近创建的任务 ID 和 API Key,也可手动填写。 创建成功后也可直接点击“查询任务”,无需重复填写。API Key 仅在当前页面会话内共用,刷新或关闭页面后清除。 queued 表示已排队,running 表示处理中;succeeded 时读取 content.video_url。若状态为 failed、cancelled 或 expired,查看 error.code 和 error.message。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

id
string
必填

创建接口返回的本地任务 ID,仅可查询当前用户任务。

响应

OK

id
string
必填
model
string
必填
status
enum<string>
必填
可用选项:
queued,
running,
succeeded,
failed,
cancelled,
expired
content
object
必填
usage
object
必填
created_at
integer<int64>
必填
updated_at
integer<int64>
必填
error
object
framespersecond
integer
draft_task_id
string
resolution
string

分辨率;参数组合及可用值取决于模型和实际通道。

ratio
string

宽高比,支持 adaptive。

duration
integer

视频时长(秒),支持 -1 自动选择;frames 优先。

frames
integer

生成帧数,受模型能力限制。

seed
integer

随机种子,受模型能力限制。

execution_expires_after
integer

任务执行有效期(秒),2.0、2.5 均转发。

generate_audio
boolean

是否生成同步音频。

tools
object[]

工具列表,保留嵌套参数。

output_format
string

输出格式,按模型契约填写。

service_tier
string

服务等级;如 flex 等级受模型限制。

draft
boolean

样片模式,受模型能力限制。

priority
integer

执行优先级,0–9。

必填范围: 0 <= x <= 9
safety_identifier
string

调用方安全标识。