Seedance 全系接口概览

Seedance 全系共用官方 content 和通用视频两种接口，标准、Fast、Mini、Max、2.5 与 Dreamina/Doubao 别名使用相同入口。

Seedance 全系通过异步任务生成视频：先创建任务，再按任务 ID 轮询状态。支持草稿模式的新版本网关在原生查询成功后返回 content.video_url；规范化查询 GET /v1/videos/{task_id} 返回 video_url。旧版网关或直接第三方接口可能返回 outputs[0]。2.5 的任务类型配置与完整返回字段见请求与返回参数。

Seedance 2.5 还支持先生成 480p 草稿、确认效果后再生成 1080p 正式片。完整两步流程、公共任务 ID 用法和版本要求见草稿（样片）模式；其他系列及渠道别名是否支持，以实际上游能力为准。

素材支持自动上传。 在官方格式或通用视频格式的图片、视频、音频素材字段中，直接传入公网可访问的 https:// 链接，系统会自动识别并上传素材，无需提前调用 /api/assets/upload。

项目	说明
官方格式创建任务	`POST /api/v3/contents/generations/tasks`
官方格式查询任务	`GET /api/v3/contents/generations/tasks/{task_id}`
通用视频创建任务	`POST /v1/video/generations`
通用视频查询任务	`GET /v1/video/generations/{task_id}`
素材上传	`POST /api/assets/upload`
素材详情	`GET /api/assets/{id}`
适用系列	Seedance 1.x、2.0 标准 / Fast / Mini、2.5、Max，以及 Dreamina / Doubao 别名

全系统一调用

全系使用上表中的同一组官方与通用任务接口。参考 doubao-seedance-2-0-260128 的调用方式，只需替换完整 model ID；不需要为 Fast、Mini、Max、2.5 或 Dreamina 别名单独更换接口路径。分辨率、时长、参考素材及编辑/延长能力以具体模型版本为准。

当前目录的 16 个 Seedance 模型均使用这两个入口：

dreamina-seedance-2-5-260628
doubao-seedance-2-5-260628
dreamina-seedance-2-0-mini-260615
doubao-seedance-2-0-mini-260615
dreamina-seedance-2-0-260128
dreamina-seedance-2-0-fast-260128
doubao-seedance-2-0-260128
doubao-seedance-2-0-fast-260128
doubao-seedance-2-0-260128-max
doubao-seedance-2-0-fast-260128-max
doubao-seedance-2-0-mini-260615-max
doubao-seedance-2-5-260628-max
dreamina-seedance-2-0-260128-max
dreamina-seedance-2-0-fast-260128-max
dreamina-seedance-2-0-mini-260615-max
dreamina-seedance-2-5-260628-max

两种请求格式

官方格式适合需要精确控制 content[] 中图片、视频、音频素材角色的场景：

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "一只金色柴犬在樱花树下奔跑，镜头缓缓上升"
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "watermark": false
}

通用视频格式适合使用统一 /v1/video/generations 接口的业务，使用 prompt、image、metadata.video_url、metadata.audio_url 表达同样的输入：

{
  "model": "doubao-seedance-2-0-fast-260128",
  "prompt": "让画面中的人物缓缓转身微笑",
  "image": "https://example.com/photo.jpg",
  "duration": 5,
  "size": "720p",
  "metadata": {
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }
}

参数速查

字段	说明
`resolution` / `size`	2.5：`480p`、`720p`、`1080p`；2.0 标准版还支持 `4k`，fast/mini 仅 `480p`、`720p`
`ratio`	默认 `adaptive`；还可用 `16:9`、`9:16`、`3:4`、`1:1`、`4:3`、`21:9`；2.5 编辑、延长、首帧/首尾帧必须为 `adaptive`
`duration`	2.5 默认 `-1`，可选 `-1` 或 4–30 秒；2.0 可选 `-1` 或 4–15 秒；2.5 编辑必须为 `-1`
`omni_reference_task_type`	仅 2.5：`auto`（默认）、`reference`、`edit`、`extend`
`generate_audio`	是否生成与画面同步的声音，默认 `true`
`watermark`	是否添加水印，默认 `false`
`draft`	2.5 草稿模式：`true` 创建 480p 草稿；正式片使用草稿公共任务 ID，分辨率为 `1080p`

图片可以使用公网 URL；官网支持 Base64 Data URL，单张图片小于 30 MB、请求体不超过 64 MB，渠道可能采用更小限制。视频素材必须使用公网可访问 URL，不支持 Base64。

需要通过素材 ID 复用图片、视频或音频时，也可以手动调用 /api/assets/upload 上传 URL 素材，等素材状态为 Active 后，在官方格式或通用视频格式中使用 asset://<asset_id> 引用。详见素材上传与管理。

Seedance 全系接口概览

全系统一调用

两种请求格式

参数速查

On this page