模型与请求参数

创建和 Remix 接口使用相同的 Seedance 字段白名单。创建时必须传 model；Remix 会锁定原任务模型和渠道，不接受新的模型选择。

请求字段

字段	类型	创建必填	说明
`model`	string	是	`doubao-seedance-2-0-260128` 或 `doubao-seedance-2-0-fast-260128`
`prompt`	string	是	非空视频提示词；Remix 同样必填
`duration`	integer/string	否	时长，`1-3600` 秒
`seconds`	string	否	OpenAI 兼容时长，内容必须是整数，`1-3600`
`resolution`	string	否	`480p`、`720p`、`1080p`；Fast 模型不支持 `1080p`
`ratio`	string	否	`16:9`、`9:16`、`1:1`
`image`	string	否	单张参考图 URL
`images`	string[]	否	多张参考图 URL
`generate_audio`	boolean	否	是否生成音频；显式 `false` 会保留
`watermark`	boolean	否	是否添加水印
`return_last_frame`	boolean	否	是否返回尾帧
`camera_fixed`	boolean	否	是否固定镜头
`safety_identifier`	string	否	调用方安全标识，最多 64 个字符
`metadata`	object	否	多模态内容和高级参数

不支持的顶层字段返回 unsupported_field。顶层 content、priority 和 input_reference 不属于当前契约。

参数优先级

重复字段按以下顺序解析：

duration > seconds > metadata.duration
顶层 resolution > metadata.resolution
顶层 ratio > metadata.ratio
顶层布尔字段 > metadata 中的同名布尔字段
metadata.content > 顶层 image / images

metadata 只允许以下字段：

content
duration
resolution
ratio
generate_audio
watermark
return_last_frame
camera_fixed

出现其他 metadata 字段会返回 invalid_metadata。

顶层图片参考

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "保持产品主体一致，生成电影感广告运镜",
  "duration": 8,
  "resolution": "720p",
  "ratio": "16:9",
  "images": [
    "https://cdn.example.com/product-front.png",
    "https://cdn.example.com/product-side.png"
  ]
}

metadata.content

type	URL 字段	role
`image_url`	`image_url.url`	空、`reference_image`、`first_frame`、`last_frame`
`video_url`	`video_url.url`	空、`reference_image`、`first_frame`、`last_frame`
`audio_url`	`audio_url.url`	空、`reference_image`、`first_frame`、`last_frame`
`text`	`text`	不支持作为提示词；该项会被忽略

每个 URL 对象只允许包含 url 字段，不支持自定义请求头。最终文本提示词始终使用顶层 prompt。

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "保持人物动作，替换为傍晚海边场景",
  "duration": 8,
  "resolution": "720p",
  "ratio": "16:9",
  "metadata": {
    "content": [
      {
        "type": "video_url",
        "video_url": {
          "url": "https://cdn.example.com/reference.mp4"
        },
        "role": "reference_image"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://cdn.example.com/reference.mp3"
        }
      }
    ]
  }
}

只要 metadata.content 中存在 video_url，任务就会按参考视频场景记录和计费。媒体必须是服务端可访问的公网 URL，不能直接通过 multipart 上传。

请求字段

参数优先级

顶层图片参考

metadata.content

目录