Seedance 2.5 视频 API 调用指南(30 秒长片, 50 个参考素材)

Seedance 2.5 是字节最新一代视频生成模型,已在 RelayDance 上线,走与其他模型完全相同的 OpenAI 兼容任务 API。不排队,无需实名。本文覆盖 2.5 的新能力、准确的模型名、按秒定价和可直接复制的示例。

相比 2.0 的新能力

单条最长 30 秒(2.0 上限 15 秒),需显式传 "seconds": "30"。
单次最多 50 个参考素材:产品图、角色设定、风格帧。
纯音频参考:可以用一段语音或环境音作为参考输入。
视频参考支持 .mov(与 .mp4 并列)。
原生支持 11 种 prompt 语言,中英日都在内。
分辨率:仅 480p 与 720p。2.5 没有 1080p/4K 档;需要高清请用 Seedance 2.0 Pro 1080p、原生 4K,或对 2.5 产物走 4K 超分端点。

模型与定价

模型	分辨率	每秒输出价格	5 秒	30 秒
`doubao-seedance-2-5-480p`	480p	$0.130	$0.65	$3.90
`doubao-seedance-2-5-720p`	720p	$0.289	$1.44	$8.67

按真实输出秒数计费:提交时按最坏情况预扣,任务完成后按实际时长重算,差额自动退回。生成失败全额退款。

提交任务

curl -X POST https://relaydance.com/v1/video/generations \
  -H "Authorization: Bearer $RELAYDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-720p",
    "prompt": "A chef plating a dessert in a bright kitchen, camera slowly orbiting the dish",
    "seconds": "10",
    "metadata": {
      "generate_audio": true,
      "content": [
        {"type": "image_url", "image_url": {"url": "https://example.com/dish-reference.jpg"}}
      ]
    }
  }'

轮询结果

curl https://relaydance.com/v1/videos/task_xxxxxxxx \
  -H "Authorization: Bearer $RELAYDANCE_API_KEY"

状态依次经过 queued、in_progress 到 completed,完成后响应中携带视频 URL。请始终轮询 /v1/videos/{id}。

参考素材与多图引用

参考图放在 metadata.content 的 image_url 条目里。多图时在 prompt 中用 @image1、@image2 按 content 顺序引用。多图参考与首尾帧控制互斥。已注册进 RelayDance 素材库的文件,用 asset:// URL 填入 image_url.url 字段引用。

上生产前要知道的两个行为

编辑、续写、首尾帧任务必须使用自适应比例:这些任务类型固定 ratio 会被上游驳回,留空(adaptive)即可。
开音频时不要在 prompt 里描写背景音乐:要求生成歌曲/BGM 可能触发输出音轨的版权检测,画面没问题也会整条驳回。要么去掉音乐描写(环境音、说话声不受影响),要么传 "generate_audio": false 后期自行配乐,静音生成还更便宜。

何时选 2.5, 何时留在 2.0

需要长片(超过 15 秒)、大量参考素材、音频参考时选 2.5;需要 1080p / 原生 4K,或追求 720p 最低单价($0.190/秒 vs 2.5 的 $0.289/秒)时留在 2.0 Pro。两条线在同一端点,切换只改一个模型名字符串。

Updated 2026-08-29 · API reference · Pricing