创建 Seedance 视频

POST/v1/video/generations
使用文本及可选的图片、视频或音频参考素材创建异步 Seedance 2.0 视频任务；供应商回调不会替代任务轮询与计费结算。

请求体

application/json
model:必填string

对外 Seedance 模型名称。支持 seedance-2-0、seedance-2-0-fast 和 seedance-2-0-mini。

可选值seedance-2-0seedance-2-0-fastseedance-2-0-mini
示例seedance-2-0
prompt:必填string

非空的视频生成提示词，必须放在请求顶层。

示例图中的小白兔在吃橙子
seconds:必填string

视频时长，单位为秒，必须使用 JSON 字符串；支持 4～15，默认值为 "5"。

可选值456789101112131415
示例5
images:可选array

参考图片地址，支持 https:// 与 asset://。不要与 metadata.content 同时传入，后者会覆盖本字段。

metadata:可选object

Seedance 供应商扩展参数。显式传入的 false、0 和 -1 会被保留，适配层会忽略未知字段。

metadata.resolution:可选string

输出分辨率，默认值为 720p。seedance-2-0 支持 480p、720p、1080p；seedance-2-0-fast 与 seedance-2-0-mini 只支持 480p、720p。

可选值480p720p1080p
示例720p
metadata.ratio:可选string

输出视频宽高比。支持 1:1、16:9、9:16、4:3、3:4、3:2、2:3，默认值为 16:9。

可选值1:116:99:164:33:43:22:3
示例16:9
metadata.content:可选array

图片、视频、音频或混合参考素材列表。文字提示请使用顶层 prompt；本字段会覆盖 images。

metadata.content[].type:必填string

每个参考媒体项必填的类型：image_url、video_url 或 audio_url。

可选值image_urlvideo_urlaudio_url
metadata.content[].image_url:可选object

type=image_url 时填写，并配合 role=reference_image。

metadata.content[].image_url.url:可选string

图片参考地址，支持 https:// 或 asset://。

示例https://example.com/reference.png
metadata.content[].video_url:可选object

type=video_url 时填写，并配合 role=reference_video。

metadata.content[].video_url.url:可选string

视频参考地址，支持 https:// 或 asset://。

示例https://example.com/reference.mp4
metadata.content[].audio_url:可选object

type=audio_url 时填写，并配合 role=reference_audio。

metadata.content[].audio_url.url:可选string

音频参考地址，支持 https:// 或 asset://。

示例https://example.com/reference.mp3
metadata.content[].role:可选string

参考媒体角色。reference_image、reference_video、reference_audio 应与 type 和 URL 字段保持一致。

可选值reference_imagereference_videoreference_audio
metadata.callback_url:可选string

由供应商直接回调的绝对 HTTP/HTTPS 地址；不会替代 UnifyLLM 的任务轮询与计费结算。

示例https://example.com/callback/seedance
metadata.return_last_frame:可选boolean

要求供应商返回尾帧；当前 UnifyLLM 查询响应不会公开尾帧地址。

metadata.service_tier:可选string

供应商服务等级，可选 default 或 flex。

可选值defaultflex
metadata.execution_expires_after:可选integer

任务执行过期时间，单位为秒，范围 3600～259200。

示例172800
metadata.generate_audio:可选boolean

是否随视频生成音频。

metadata.draft:可选boolean

是否使用供应商草稿模式。

metadata.tools:可选array

生成期间可使用的工具；当前文档支持的工具类型为 web_search。

metadata.tools[].type:必填string

必填的工具类型；Schema 当前唯一支持的值为 web_search。

可选值web_search
metadata.safety_identifier:可选string

最长 64 字符的可打印 ASCII 安全标识，建议使用不可逆的用户标识。

示例user-7f83a19c
metadata.priority:可选integer

任务优先级，范围 0～9，默认值为 0。

可选值0123456789
示例0
metadata.frames:可选integer

可选总帧数，支持 29～289 且满足 25 + 4n。

可选值293337414549535761656973778185899397101105109113117121125129133137141145149153157161165169173177181185189193197201205209213217221225229233237241245249253257261265269273277281285289
示例57
metadata.seed:可选integer

随机种子，范围 -1～4294967295；默认值为 -1，表示随机生成。

示例-1
metadata.camera_fixed:可选boolean

是否固定镜头。

metadata.watermark:可选boolean

是否添加水印。

响应

200

成功时返回 JSON 响应。完整示例显示在右侧代码面板中。

兼容格式参考

以下外部文档可用于了解兼容供应商格式中的扩展参数。