Seedance
多图、多音频与视频参考;分辨率、比例、异步查询和下载。
用 content 数组组合提示词与参考素材;用 resolution、ratio、duration 分别控制清晰度、画面比例和时长。先提交一次,再查询同一任务,最后下载成片。
POST https://anyrouter.cc/api/v3/contents/generations/tasks
GET https://anyrouter.cc/api/v3/contents/generations/tasks/{id}
Authorization: Bearer sk-你的Key
Content-Type: application/json鉴权使用 AnyRouter.cc Key,不需要火山 Key。先按快速开始设置 AR_KEY;以下命令使用 curl 和 jq。所有示例中的素材 URL 都要替换为你自己的公网可访问链接。
模型
| 模型 | 当前网关输出档位 | 输出时长 | 适合 |
|---|---|---|---|
doubao-seedance-2-5-260628 | 480p / 720p / 1080p | 4–30 秒,或 -1 自动 | 多模态创作、长镜头 |
doubao-seedance-2-0-260128 | 480p / 720p / 1080p | 4–15 秒,或 -1 自动 | 常规创作与高清输出 |
doubao-seedance-2-0-fast-260128 | 480p / 720p | 4–15 秒,或 -1 自动 | 速度优先 |
doubao-seedance-2-0-mini-260615 | 480p / 720p | 4–15 秒,或 -1 自动 | 低成本试稿 |
本页列出对外使用的清晰度档位;不要给 fast / mini 填 1080p。你的 Key 可用型号以 GET /v1/models 为准。
多图多音频生成视频
下面是 2 张图+2 段音频的完整请求。每张图、每段音频分别占一个 content 项;不是在一个 url 中拼多个地址。
curl --fail-with-body -sS https://anyrouter.cc/api/v3/contents/generations/tasks \
-H "Authorization: Bearer $AR_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "doubao-seedance-2-5-260628",
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"generate_audio": true,
"watermark": false,
"omni_reference_task_type": "reference",
"content": [
{"type":"text","text":"用图片1的人物和图片2的街景生成一段傍晚散步镜头。参考音频1的说话声音与音频2的环境氛围,不编辑已有视频。"},
{"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
{"type":"image_url","image_url":{"url":"https://example.com/street.jpg"},"role":"reference_image"},
{"type":"audio_url","audio_url":{"url":"https://example.com/voice.mp3"},"role":"reference_audio"},
{"type":"audio_url","audio_url":{"url":"https://example.com/ambience.mp3"},"role":"reference_audio"}
]
}' > task.json
TASK_ID=$(jq -er '.id' task.json)
printf '%s\n' "$TASK_ID"提交成功时得到 {"id":"task_…"},这时还没有视频。保存这个 网关 id,后续查询始终使用它。
素材类型与角色
| 用途 | type | URL 放在哪里 | role |
|---|---|---|---|
| 提示词 | text | 内容放在 text | 不填 |
| 多张参考图 | image_url | image_url.url | reference_image |
| 多段参考音频 | audio_url | audio_url.url | reference_audio |
| 参考视频 | video_url | video_url.url | reference_video |
| 指定第一帧 | image_url | image_url.url | first_frame |
| 指定最后一帧 | image_url | image_url.url | last_frame |
提示词按同类素材出现顺序写“图片1/图片2”“音频1/音频2”“视频1”。要复用已入库的角色图片,可以把 image_url.url 换成角色素材的 asset:// 地址。
两种图片用法要区分:reference_image 是参考画面内容;first_frame / last_frame 是要求视频从指定画面开始/结束。不要在一次请求里混用首尾帧模式和多模态参考模式。
参考素材上限
以下为对应型号的上游规格,数量和媒体时长都要满足;它们不是“一个数组可以任意长”。
| 型号 | 参考图片 | 参考视频 | 参考音频 |
|---|---|---|---|
| Seedance 2.5 | 最多 30 张 | 最多 10 段,总时长不超过 30 秒 | 最多 10 段,总时长不超过 30 秒 |
| Seedance 2.0 / fast / mini | 最多 9 张 | 最多 3 段,总时长不超过 15 秒 | 最多 3 段,总时长不超过 15 秒 |
2.0 系列使用参考音频时,还需至少一张图片或一段视频;2.5 可以仅使用音频参考。输入 URL 在上游取素材时必须仍有效,不要使用只有你本机能访问的地址。媒体格式、文件大小等详细限制见官方素材规格。
分辨率与比例
原生视频请求用两个独立字段,不是图片的 size:
| 你要控制 | 字段 | 填写示例 |
|---|---|---|
| 清晰度 | resolution | "480p"、"720p"、"1080p",必须带 p |
| 画面比例 | ratio | "16:9" 横版、"9:16" 竖版、"1:1" 方形 |
| 其他比例 | ratio | "21:9"、"4:3"、"3:4"、"adaptive" |
| 时长 | duration | 整数秒,如 5;或 -1 由模型选择 |
例如:竖版 720p 传 "resolution":"720p","ratio":"9:16";横版 1080p 传 "resolution":"1080p","ratio":"16:9",并选择支持 1080p 的模型。
首帧与首尾帧
首帧图片用 role: "first_frame",尾帧用 role: "last_frame"。Seedance 2.5 首帧/首尾帧模式的 ratio 必须是 adaptive,不能强制填固定比例。想要竖版,先准备竖版的首帧图。
{
"model": "doubao-seedance-2-5-260628",
"resolution": "720p",
"ratio": "adaptive",
"duration": 5,
"content": [
{"type":"text","text":"镜头缓慢推进,从首帧自然过渡到尾帧。"},
{"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
{"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
]
}只做首帧生视频时删除最后一项;只做文生视频时,content 仅保留文字项。
参考视频、编辑与延长
参考视频放进 video_url.url 并设置 role: "reference_video"。Seedance 2.5 的任务意图会影响参数:
| 目的 | omni_reference_task_type | 比例与时长 |
|---|---|---|
| 参考素材创作新视频 | reference | 按需要指定 ratio 和 duration |
| 编辑已有视频 | edit | ratio: "adaptive"、duration: -1;参考视频 4–30 秒 |
| 延长已有视频 | extend | ratio: "adaptive",提示词明确说明延长方向 |
未知任务类型可用 auto,并按上游建议使用 ratio: "adaptive"、duration: -1;提示词与所选任务类型不符仍可能异步失败。以上任务类型参数是 2.5 的用法,不要直接套到 2.0。
常用参数
| 参数 | 含义 |
|---|---|
model、content | 必填。模型 id 和输入数组 |
resolution、ratio、duration | 输出规格,见上 |
generate_audio | 是否生成有声视频。参考音频输入与输出声音开关是两件事 |
watermark | 是否加水印 |
seed | 随机种子,不保证跨模型/版本逐像素复现 |
查询与下载
curl --fail-with-body -sS \
"https://anyrouter.cc/api/v3/contents/generations/tasks/$TASK_ID" \
-H "Authorization: Bearer $AR_KEY" > result.json
jq '{id, status, error, content}' result.jsonstatus | 下一步 |
|---|---|
queued / running | 10–20 秒后查询同一 id;不要重新提交 |
succeeded | 从 content.video_url 下载 |
failed / expired / cancelled | 查看 error 和控制台任务日志,核实费用退回 |
if VIDEO_URL=$(jq -er 'select(.status == "succeeded") | .content.video_url' result.json); then
curl --fail -sSL "$VIDEO_URL" -o out.mp4
fi下载成片时不带 AnyRouter.cc 的 Authorization 头;签名 URL 不是网关接口。原生任务返回的视频地址通常在 24 小时内有效,请及时转存,不把它当永久地址。生成通常需要几分钟,客户端提交超时后先查看控制台任务日志;查询同一任务不会重复生成或重复扣费。
价格
按 token 计费:tokens = (输入视频秒数 + 输出秒数) × 宽 × 高 × 24 ÷ 1024。提交时按这个公式预扣,完成后以上游实际用量结算。
每百万 token 单价:
| 模型 | 480p / 720p | 1080p | 有输入视频时 480p / 720p | 有输入视频时 1080p |
|---|---|---|---|---|
| Seedance 2.5 | $10.50 | $11.55 | $6.30 | $6.90 |
| Seedance 2.0 | $6.90 | $7.65 | $4.20 | $4.65 |
| Seedance 2.0 fast | $5.55 | — | $3.30 | — |
| Seedance 2.0 mini | $3.45 | — | $2.10 | — |
只用首帧、尾帧图片仍属于「无输入视频」。
5 秒视频参考价(无输入视频):
| 模型 | 480p | 720p | 1080p |
|---|---|---|---|
| Seedance 2.5 | $0.50 | $1.13 | $2.81 |
| Seedance 2.0 | $0.33 | $0.75 | $1.86 |
| Seedance 2.0 fast | $0.27 | $0.60 | — |
| Seedance 2.0 mini | $0.17 | $0.37 | — |
费用和时长成正比。
失败与费用核对
- 提交时按预计用量预扣,完成后按实际用量结算。终态失败的预扣应退回;在控制台任务日志与消费记录中核对。
- 提交返回 400 时,按模型、素材、比例与时长限制调整。
- 返回 429 时按
Retry-After退避;已有任务继续查询原 id。 - 提交超时或连接中断时,上游可能已接受任务。先查控制台,不要直接重新提交。
- 报障提供
X-Oneapi-Request-Id和网关task_…id,不提供 API Key。