跳转至

参数字典

顶层字段

字段 类型 必填 说明
model string 是 Seedance 模型 ID
prompt string 是 视频内容、镜头、动作和风格描述
metadata object 否 所有扩展参数容器

metadata 字段

字段 类型 常用值 说明
content array 见下节 图片、视频、音频参考素材
duration integer 4–15 时长（秒）；未传时通常按上游默认值
ratio string 21:9 16:9 4:3 1:1 3:4 9:16 adaptive adaptive 通常跟随首帧图片
resolution string 480p 720p 1080p Fast/Mini 通常只支持 480p、720p
generate_audio boolean true / false 是否生成音频，默认行为以模型为准
watermark boolean true / false 是否添加水印
seed integer 任意合法整数 随机种子；相同种子不保证像素级复现
camera_fixed boolean true / false 是否尽量固定镜头
return_last_frame boolean true / false 是否请求返回末帧
draft boolean true / false 草稿或低质量预览模式（若模型支持）
callback_url string HTTPS URL 回调地址（若当前渠道支持）

content 元素

字段名必须与 type 匹配，URL 必须嵌套在同名对象内。

{
  "type": "image_url",
  "image_url": {"url": "https://example.com/image.jpg"},
  "role": "reference_image"
}

{
  "type": "video_url",
  "video_url": {"url": "https://example.com/reference.mp4"},
  "role": "reference_video"
}

{
  "type": "audio_url",
  "audio_url": {"url": "https://example.com/reference.mp3"},
  "role": "reference_audio"
}

role 值

素材类型 role 用途
图片 first_frame 约束起始画面；图片未填 role 时通常按首帧处理
图片 last_frame 约束结束画面
图片 reference_image 角色、商品、服装或风格参考，可多张
视频 reference_video 运镜、节奏或动作参考
音频 reference_audio 背景音乐或声音参考

错误写法：

{"type": "image_url", "url": "https://example.com/image.jpg"}

正确写法：

{"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}

参考素材必须能被服务器直接访问。避免登录态链接、局域网地址、短时效链接，以及禁止外部抓取的防盗链地址。