提交视频生成请求
/v1/videos提交归一化的视频生成请求并创建异步任务。API 会根据 frame_images 与 input_references 的角色推断生成工作流。响应会返回视频任务 id；使用 GET /v1/videos/{video_id} 轮询该 id，即可查看生成状态并获取最终结果。
如需在任务进入终态时接收 Webhook，请提供可选的 callback_url 字段。投递行为、重试和回调载荷详见 Webhook。
身份验证
Authorization Bearer
在 Authorization header 中使用 API key 作为 Bearer token。
Request Body
modelstringrequired视频模型 ID。
Example: "seedance-2.0"
promptstringrequired要生成的视频文本描述。
durationinteger所选模型支持时的生成视频时长，单位秒。
resolutionenum<string>所选模型支持时的分辨率枚举。
Available options: 360p 480p 540p 720p 1080p 1K 2K 4K
aspect_ratioenum<string>所选模型支持时的输出视频宽高比。
Available options: adaptive 16:9 9:16 1:1 4:3 3:4 21:9 9:21
generate_audioboolean所选模型支持时，是否同时生成音频。
seedinteger所选模型支持时可传随机种子。
watermarkboolean所选模型支持时控制是否带水印。
return_last_frameboolean所选模型支持时，是否返回生成视频的最后一帧图片。
execution_expires_afterinteger所选模型支持时的供应商任务执行过期时间，单位秒。
safety_identifierstring所选模型支持时透传给供应商的安全或审计标识。
callback_urlstring视频任务进入终态时接收 Webhook 的 HTTPS URL。
metadataobject随任务保存的自定义键值数据。
Response
idstring视频任务 ID。
objectstring固定为 video。
statusenum<string>任务状态。
Available options: queued in_progress completed failed
modelstring使用的模型。
promptstring输入提示词。
created_atintegerUnix 时间戳。
parametersobject归一化后的任务参数。
contentobject供应商返回时包含的额外生成资产。
content.last_frame_urlstring当 return_last_frame=true 且供应商返回最后一帧时的图片 URL。