Seedance 官方版视频 API 规范

本页是 Seedance 官方版视频模型的调用规范。它们与其他视频模型共用 POST /v1/videos 创建、GET /v1/videos/{id} 轮询的流程；鉴权、素材上传、轮询状态、结果下载和错误处理见 视频 API 完整调用规范，本页只列出这组模型特有的字段和规则。

更新于 2026-10-10。本组模型只支持轮询：提交时不要设置 callback_url，否则请求会被拒绝。SD 云厂商版（SD2.0、SD2.5）和 Seedance 官转的能力与本组不同，分别见 SD 云厂商版 和 Seedance 官转。

模型一览

模型名必须与 GET /v1/models 返回的 id 完全一致，包括 官方版 后缀。每个系列只有一个模型名，用 resolution 选择输出档位并按该档位计费；后续新增档位时模型名不变。

通用规则

• 分辨率：resolution 填上表中的档位，大小写均可（720p 与 720P 等价）；不传时使用最低档。填写该系列不支持的档位会返回 400，不会自动降档。
• 时长：duration（或字符串形式的 seconds）填整数秒；不传时使用上表的默认时长。
• 比例：ratio（或 aspect_ratio）可选 16:9、9:16、1:1、4:3、3:4、21:9，默认 16:9。不支持 auto。
• 提示词：prompt 必填。
• 音频：不提供生成音频开关，请不要发送 generate_audio。
• 可选字段：negative_prompt（负面提示词）、seed（整数）。

参考素材

• 参考图片放顶层 images 数组。
• 参考视频放 metadata.referenceVideos，参考音频放 metadata.referenceAudios。
• 同一类素材只用一个字段提交；同时提交多个别名时只取其中一组，不会合并。
• 素材 URL 要求和本地文件上传方式见 素材 URL 要求 与 本地素材上传。

{
  "model": "seedance-2.5官方版",
  "resolution": "720p",
  "prompt": "使用参考图的产品外观、参考视频的镜头节奏和参考音频的声音氛围，制作科技广告",
  "duration": 10,
  "ratio": "16:9",
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-detail.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"],
    "referenceAudios": ["https://cdn.example.com/sound-reference.mp3"]
  }
}

首尾帧

首帧和尾帧放在 metadata.firstFrame 与 metadata.lastFrame。lastFrame 必须与 firstFrame 同时提供；首尾帧不能与参考图片、参考视频或参考音频混用。

{
  "model": "seedance-2.0官方版",
  "prompt": "从清晨的空旷广场平滑过渡到夜晚灯光亮起的同一构图",
  "duration": 8,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

文件上传

也可以用 multipart/form-data 直接上传 1 个本地图片文件，字段名为 input_reference；此时不能再同时提交 images 或 image。参考视频和音频不能以文件形式提交，请先按 本地素材上传 取得 URL。

旧模型名

此前带档位的模型名 Seedance-2.5-720p官方版、Seedance-2.0-720p官方版、Seedance-2.0-fast-720p官方版、seedance-2.0-mini-480p、seedance-2.0-mini-720p 仍可调用，输出和计费固定为名称中的档位，会忽略 resolution。它们已不在模型广场展示，新接入请使用上表的系列名加 resolution。