Seedance
Seedance 2.0 文生视频、图生视频与视频续写
Seedance 2.0 支持文生视频、图生视频、视频续写与声生视频，提供标准版与低延迟的 fast 版两个档位。
所有任务均为异步：提交后轮询任务状态，再下载结果。完整生命周期见「视频生成与查询」页。
模型一览
seedance-2.0 — 标准版，画质优先。
seedance-2.0-fast — 快速版，延迟更低，不支持 1080p。
提交生成任务
按请求体中的 model 字段路由到对应模型。
任务创建非幂等，视频路由禁用 failover 重试。
/v1/videos兼容别名POST/v1/video/generations请求
字段JSON 请求体。
modelstringRequiredSeedance 模型 ID。
seedance-2.0seedance-2.0-fastpromptstringOptional视频描述提示词。纯文生视频时必填；通过 image、images 或 metadata.content 提供视觉输入时可选——prompt 与视觉输入至少其一。
imagestringOptional图生视频参考图（作为首帧），支持 URL 或 base64。
imagesarray<string>Optional多图参考，支持 URL 或 base64。
durationintegerOptional视频时长（秒）：整数 4–15，或 -1（由模型智能选择）。顶层字段优先级高于 metadata.duration。
secondsstringOptionalduration 的字符串形式（纯数字）。
metadataobjectOptional
Seedance 特有参数容器。
metadata.resolutionstringOptional分辨率。seedance-2.0-fast 不支持 1080p。
480p720p1080pmetadata.ratiostringOptional宽高比，adaptive 表示跟随输入图像。
16:94:31:13:49:1621:9adaptivemetadata.durationintegerOptional时长（秒）：整数 4–15，或 -1（智能选择）。会被顶层 duration 覆盖。
metadata.seedintegerOptional随机种子，-1 至 2^32 - 1，-1 表示随机。
metadata.watermarkbooleanOptional是否添加水印。
metadata.generate_audiobooleanOptional是否同步生成音频。
metadata.service_tierstringOptional服务档位。
autodefaultprioritymetadata.execution_expires_afterintegerOptional任务超时时间（秒），如 172800。
metadata.return_last_framebooleanOptional是否同时返回最后一帧图像。
metadata.callback_urlstringOptional任务完成时的回调 URL。
metadata.frames / metadata.camera_fixed / metadata.draftinteger | booleanOptional为向后兼容保留，但在 seedance-2.0 系列上不生效，可省略。
metadata.content[]array<object>Optional
多模态输入，用于进阶用法：视频续写、声生视频、多图参考。
content[].typestringOptional输入类型。
textimage_urlvideo_urlaudio_urlcontent[].textstringOptionaltype 为 text 时填提示词。
content[].image_url.urlstringOptionaltype 为 image_url 时填图片 URL。
content[].video_url.urlstringOptionaltype 为 video_url 时填源视频 URL（视频续写）。
content[].audio_url.urlstringOptionaltype 为 audio_url 时填音频 URL（声生视频）。
content[].rolestringOptional图片项的角色；多图输入时每张图必填。
first_framelast_framereference_image响应
字段提交回执。字段平铺在 JSON 顶层（无 data 包装）。
idstringOptional任务 ID（task_xxx）。与 task_id 相同，供 OpenAI SDK 兼容使用。
task_idstringOptional任务 ID，用于后续轮询与下载。
objectstringOptional固定值 video。
modelstringOptional请求中传入的模型名。
statusstringOptional提交后初始状态，通常为 QUEUED。
SUBMITTEDQUEUEDIN_PROGRESSSUCCESSFAILUREprogressintegerOptional进度 0–100，刚提交时通常为 0。
created_atintegerOptional任务创建时间（秒级时间戳）。
顶层 duration 字段优先级高于 metadata.duration。
请通过 GET /v1/videos/{task_id}/content 下载结果，不要把 result_url 当作长期存储地址。
成功与业务失败均返回 HTTP 200。调用失败时响应体不含回执字段，而是携带 error 对象——{ "error": { "message", "type", "code" } }——请通过是否存在 error 字段区分。
查询与下载
轮询任务直到进入终态 SUCCESS 或 FAILURE（建议间隔 10–15 秒，不要低于 5 秒），然后下载结果。下载接口支持 Range 请求（HTTP 206），可断点续传、拖拽播放。
/v1/videos/{task_id}兼容别名GET/v1/video/generations/{task_id}/v1/videos/{task_id}/content响应
字段以下为核心字段。完整的任务详情字段、状态生命周期与轮询建议见「视频生成与查询」页。
statusstringOptional任务状态。
SUBMITTEDQUEUEDIN_PROGRESSSUCCESSFAILUREprogressstringOptional进度百分比字符串，如 "50%"。
result_urlstringOptional结果视频下载地址，仅 status 为 SUCCESS 时返回。形如 /v1/videos/{task_id}/content。
fail_reasonstringOptional失败原因，仅 status 为 FAILURE 时返回。