MetaMirror

Seedance · 火山方舟格式

查询视频生成任务

用任务 ID 查询任务的状态，任务成功后返回视频地址。请求参数和返回结果与火山方舟「查询视频生成任务」接口一致。

GEThttps://your-domain/ark/api/v3/contents/generations/tasks/{id}

请求参数

路径参数

idstring必填
任务 ID，即创建视频生成任务返回的 id。只能查询自己账号下的任务，用 OpenAI 格式创建的 Seedance 任务也可以查询。

返回参数

idstring
任务 ID。
modelstring
模型 ID，和创建任务时传入的 model 相同。
statusstring
任务状态：queued、running、succeeded、failed、cancelled 或 expired，见任务状态。
errorobject
任务失败（status 为 failed）时返回，其他状态不返回。
子字段
codestring
错误码，见失败原因。
messagestring
错误信息。
contentobject
任务成功时返回。
子字段
video_urlstring

视频地址，mp4 格式。视频生成后会转存到本平台，可以长期访问，没有火山方舟 24 小时的有效期限制。

转存失败时返回模型服务商的原始地址，这种地址可能在 24 小时后失效，建议拿到视频后及时下载到自己的存储。

usageobject
任务成功时返回。按 token 计费的模型，这里是实际计费的 token 数；按秒或按条计费的模型，这里的 token 数只用于和火山方舟的用量对照，不影响费用。
子字段
completion_tokensinteger
生成视频消耗的 token 数，按火山方舟的方法计算，见用量字段。
total_tokensinteger
本次请求消耗的 token 总数。视频生成不统计输入 token，所以和 completion_tokens 相等。
created_atinteger
任务创建时间，Unix 时间戳（秒）。
updated_atinteger
任务状态最后一次更新的时间，Unix 时间戳（秒）。
resolutionstring
视频分辨率。
ratiostring
视频宽高比。任务成功后是视频实际的宽高比；画幅跟随素材的任务（例如图生视频传了 adaptive、视频编辑和延长）在完成前返回 adaptive。
durationinteger
视频时长，单位秒。由模型决定时长的任务（duration 传了 -1、Seedance 2.5 没传 duration，以及视频编辑）在完成前返回 -1，成功后是视频的实际时长。
framespersecondinteger
视频帧率，固定为 24。
generate_audioboolean
视频是否带有与画面同步的声音。
safety_identifierstring
创建任务时传入的终端用户标识，没有传时不返回。
service_tierstring
服务等级，固定为 default。
execution_expires_afterinteger
任务超时时间，单位秒，固定为 43200（12 小时）。
draftboolean
是否为样片，固定为 false。
priorityinteger
任务优先级，固定为 0。
output_formatstring
视频格式，固定为 mp4。
本平台不支持样片、尾帧和联网搜索，火山方舟返回的 seed、frames、tools、draft_task_id、content.last_frame_url 不会返回。

任务状态

status说明
queued排队中
running生成中
succeeded生成成功，content.video_url 是视频地址，同时完成扣费
failed生成失败，error 是失败原因，冻结的费用全部退回
cancelled排队中的任务被取消，冻结的费用全部退回
expired任务超过 12 小时没有完成，自动结束，冻结的费用全部退回

succeeded、failed、cancelled、expired 是最终状态，之后不会再变化。生成时间与模型、分辨率和时长有关，通常需要几分钟，建议每 10 秒以上查询一次。不想轮询的话，可以在创建任务时传 callback_url，见回调通知。

Java SDK 0.9.0 的任务状态枚举里没有 expired，查询到超时的任务时会抛出解析异常，可以捕获异常后按任务超时处理。

失败原因

任务失败时，error.code 是火山方舟的错误码，error.message 说明具体原因。常见的错误码：

error.code说明
InputTextSensitiveContentDetected、InputImageSensitiveContentDetected 等输入的提示词或素材未通过审核，请修改后重新提交
OutputVideoSensitiveContentDetected 等生成的视频未通过审核，可以调整提示词后重新提交
InvalidParameter请求的参数或素材不被模型接受
InternalServiceError生成过程出错，可以稍后重新提交

审核类错误码的完整列表见错误码。失败的任务不扣费。