跳转到主要内容
POST
cURL
这是 Seedance 视频生成 API 的查询接口。通过 id 查询视频生成任务的状态和结果。

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

路径参数

id
string
必填

任务 ID

响应

200 - application/json

请求成功

id
string
必填

任务 ID。仅保存 7 天(从 created_at 开始计算)。

status
enum<string>
必填

任务状态:queued=排队中、running=运行中、succeeded=成功、failed=失败、cancelled=已取消、expired=超时

可用选项:
queued,
running,
succeeded,
failed,
cancelled,
expired
model
string

模型名称与版本,格式为 模型名称-版本

content
object

输出内容

created_at
integer

创建时间(Unix 时间戳,秒)

updated_at
integer

更新时间(Unix 时间戳,秒)

draft
boolean

是否为样片视频(true=样片,false=正式视频)

duration
integer

视频时长(秒)。实际总帧数 / 24(向下取整)。与 frames 只返回一个。

frames
integer

视频帧数。与 duration 只返回一个。

framespersecond
integer

视频帧率

error
object

错误信息。成功时返回 null,失败时返回错误数据。

execution_expires_after
integer

任务超时阈值(秒)

generate_audio
boolean

是否生成同步音频

output_format
enum<string>

输出格式

可用选项:
mp4,
mov
priority
integer

执行优先级(0~9)

ratio
string

宽高比

resolution
enum<string>

分辨率

可用选项:
480p,
720p,
1080p,
4k
safety_identifier
string

终端用户标识

seed
integer

随机种子

service_tier
enum<string>

服务等级

可用选项:
default,
flex
tools
object[]

实际使用的工具

usage
object

token 用量

最后修改于 2026年10月22日