# Seedance 2.5 API：字节 30 秒视频生成 | KovAPI

> Seedance 2.5 是字节跳动 2026 年 7 月发布的视频生成模型。单条最长 30 秒，一次可以参考 30 张图、10 段视频和 10 段音频，画面和台词、音效、音乐一起生成。在 KovAPI 用 `seedance-2.5` 调用，按秒计费。

网页版: https://kovapi.com/zh/model/seedance-2.5 · 更新: 2026-11-10
价格、上限和耗时是生成这份文件时的实时值。

## 事实摘要

- 型号 ID: `seedance-2.5`
- 接口: `POST https://kovapi.com/v1/videos/generations` → `GET https://kovapi.com/v1/videos/jobs/{id}`
- 时长: 4–30 秒，整数
- 分辨率: 480P / 720P / 1080P
- 画面比例: 16:9 / 9:16 / 1:1 / 4:3 / 3:4
- 参考素材: 图片 ≤30 · 视频 ≤10（合计 ≤30 秒）· 音频 ≤10
- 提示词: ≤ 11,000 字符
- 每秒价: 480P $0.10/秒 · 720P $0.158/秒 · 1080P $0.38/秒
- 带参考视频每秒价: 480P $0.06/秒 · 720P $0.11/秒 · 1080P $0.27/秒
- 成片保留: 7 天

## 30 秒长叙事、大量参考素材、声音一起出

- **30 秒里排下 9 个镜头**: 单条最长 30 秒，能按整数秒的时间戳安排镜头。守护机器人这条用 9 个镜头讲完告别、发射、爆炸和安慰；3D 动画那条按 9 段时间轴对应 9 张关键帧。
- **六个人同时出场，各说各的台词**: 最多 30 张参考图，人物、场景、道具各管一件。家庭短剧这条放了 6 张人物三视图和 2 张场景图，按首次出场顺序上传、编号，角色和台词才对得上。
- **照着关键帧和分镜图拍**: 把分镜按顺序作为关键帧传入，画面会相对严格地对齐每一张。像素武侠这条把 6 张图逐个写进镜头，从 logo、角色特写一路切到活动界面；九宫格分镜图只提供大致的剧情和构图。
- **用白模动画定动作，渲染成成片**: 上传一段简单的 3D 白模动画，模型沿用其中的运镜和角色动画，换上提示词和关键帧里的场景、角色与材质。3D 动画这条用 30 秒白模定镜头，9 张关键帧定每一段的画面；参考视频的秒数也计费。
- **台词、音效和音色一起生成**: 每条成片都带音轨：台词按角色写清，中文、英文都可以；参考音频能指定说话的音色。「同一角色、同一声音」这条用上一条成片里截出的台词作参考音频。

## 玩法与 API 字段对照

各玩法共用 `model`（`seedance-2.5`）、`prompt`、`duration`、`resolution` 和 `size`。图片、视频、音频可以在同一个请求里一起传，各自按上传顺序编号，在提示词里用 `@Image1`、`@Video1`、`@Audio1` 点名。

| 玩法 | 传什么 | 得到什么 | 限制 |
| --- | --- | --- | --- |
| 文生视频 | 只传 `prompt` 和生成参数，不附素材。 | 按文字生成画面、动作和声音；台词、音效、音乐都写进提示词。 | 只受通用规格限制（见规格速查）。 |
| 参考图生视频 | `images` 依次放入图片，提示词里写清每张图的用途：人物、物品、场景、风格、分镜或关键帧。 | 按参考图的外观、构图或分镜生成新画面，多个角色可以同时出场。 | 最多 30 张，每张每边 300–6000 像素、宽高比 0.4–2.5。图片都按参考使用。 |
| 参考视频 | `video_references` 放视频链接（可以同时带 `images`），提示词写明参考它的动作、运镜、节奏还是白模结构。 | 沿用参考视频的运动和镜头，换上新的人物、场景和风格；也能把 3D 白模动画渲染成成片。 | 最多 10 段，合计不超过 30 秒；参考视频的秒数也计费（见价格）。时长从文件读取，不用另写。 |
| 参考音频 | `audio_reference` 放音频链接，同时附参考图或参考视频；提示词写明参考它的音色、台词还是音乐。 | 让角色用参考音频的音色说新台词，或按参考音乐的节奏安排画面。 | 最多 10 段，不另计费；必须和参考图或参考视频一起提交。 |

## 能拿 Seedance 2.5 做什么

- **电商带货短片**: 商品图定外观，卖点文字做成图片保证写对，出镜人物和口播写进提示词，一条就是完整的带货片段。
- **短剧与多人对白**: 人物三视图和场景图分别上传，每个镜头写景别、机位和一句台词，适合短剧样片和剧情预演。
- **游戏与动画宣传**: 把 logo、角色、道具和界面图按顺序作为关键帧，做一镜到底的宣传片头或活动预告。
- **3D 预演直接出片**: 用简单几何体搭出动作和运镜，再让模型按提示词渲染成完整画面，省掉精细建模和渲染。
- **自然与纪录风格**: 写实光影、动物毛发和环境音都写进提示词，生成纪录片质感的空镜和动物镜头。
- **系列内容沿用角色声音**: 把上一集里角色的一句台词截出来作为参考音频，再配上形象图，新一集的声音和外观都能接上。

## 价格

| 分辨率 | Seedance 2.5 | 带参考视频 | 字节官方价 |
| --- | --- | --- | --- |
| 480P | $0.10/秒 | $0.06/秒 | $0.103 / 带参考视频 $0.0615 |
| 720P | $0.158/秒 | $0.11/秒 | $0.231 / 带参考视频 $0.138 |
| 1080P | $0.38/秒 | $0.27/秒 | $0.569 / 带参考视频 $0.34 |

- 不带参考视频：所选分辨率的每秒单价 × 成片秒数。参考图、参考音频不另收费。
- 带参考视频：（参考视频秒数 + 成片秒数）× 表中「带参考视频」的单价，每一段参考视频都计入。
- 提交时预扣，生成失败全额退回；同一任务自动重试只结算一次。

## 案例：提示词与参数

### 守护机器人：九宫格分镜拍成 30 秒

- 用 KovAPI 生成 · 多图参考 · 30s · 720P · 16:9
- 按现价 $4.74
- 成片: https://img.kovapi.com/i/mp-8f8fe65d75a74a863d0c7e3c.mp4
- 参考图 1: https://img.kovapi.com/i/mp-467106a4c8d7cb83c354cc07.png
- 参考图 2: https://img.kovapi.com/i/mp-cf25b8d66e978ef5855cda31.png
- 参考图 3: https://img.kovapi.com/i/mp-d8e099cda9738ccccfa1bb5a.png
- 参考图 4: https://img.kovapi.com/i/mp-e01a7bd8d09d396d64099c9b.png

九宫格线稿定镜头结构，发射场图定色调，两张角色设定图定外观；9 个镜头、8 句英文台词一次生成。原文的 image3 / image4 与指南示例图的排列顺序相反，这里按提示词的编号上传。提示词和参考图出自火山方舟《[Doubao Seedance 2.5 提示词指南](https://docs.volcengine.com/docs/ark/seedance-2-5-prompt-guide?lang=zh)》，成片由 KovAPI 按原参数重新生成。

提示词原文:

```text
image1: 九宫格分镜参考，用于整体镜头结构、景别与运镜节奏。
image2: 火箭发射场黄昏草原实拍参考，用于环境构图、暖金夕照与冷暮蓝的写实彩色实拍质感基准。
image3: 主体 1 (守护机器人) 角色外观参考。
image4: 主体 2 (老奶奶) 角色外观参考。
【主体设定】
主体 1 (守护机器人): 参考 image3，近未来做旧复古机器人，做旧蓝绿色金属机身、斑驳锈蚀，圆顶头，两只发光的红色圆形机眼，细天线，细长关节四肢；体型高大，约为人类两倍高。
主体 2 (老奶奶): 参考 image4，瘦小年迈女性，银发挽成低髻，皱纹深刻，身穿明黄金色及地长裙、缀金蓝刺绣胸襟，神情不舍；身高只及机器人胸口。
环境 (黄昏草原・发射场): 参考 image2，近未来黄昏草原，暮色天空由暖金渐入冷蓝，远处地平线一座发射台矗立白色火箭、蒸汽升腾；及膝野草随风起伏，广袤空旷。
【整体风格】
真人实拍彩色电影正片，写实照片级质感，全程真实彩色画面；彩色 35mm 电影胶片质感，细腻真实胶片颗粒，浓郁饱满的电影级调色，IMAX 大画幅质感；手持摄影，呼吸感摇晃，浅景深大光圈，前景持续飘散的草叶、火星与灰烬，微微倾斜荷兰角，暖金夕照与冷暮蓝、爆炸暖橙强烈对撞，16:9 横屏。近未来温情灾难片氛围，静谧、悲壮、守护与不舍。
【严格排除】黑白、单色、灰度、去色；手绘、素描、线稿、插画、漫画、动画；分镜稿 / 故事板、草图；移轴微缩、玩偶感、塑料 CG、油腻过曝 CG。
【分镜头】(9 镜 ≈ 30s)
镜头 1 (0-3s): 超远景低机位仰视，黄昏草原两人背影仰望远方火箭。台词 (机器人): "I'm right here. I won't let go."
镜头 2 (3-6s): 正面中景手持，机器人搀扶老奶奶。
镜头 3 (6-10s): 面部特写，老奶奶眼含不舍。台词 (老奶奶): "Fly safe, my child. Come back to me."
镜头 4 (10-14s): 超远景仰摇，火箭升空拖曳浓白烟迹。台词 (老奶奶): "There he goes... there he goes."
镜头 5 (14-18s): 超远景，火箭在半空爆炸碎裂。台词 (老奶奶): "No... no, no—"
镜头 6 (18-22s): 面部大特写，老奶奶瞳孔骤缩泪滑落。台词 (老奶奶): "...he was almost there."
镜头 7 (22-25s): 特写转近景，老奶奶崩溃痛哭。台词 (老奶奶): "Bring him back! Please— bring him back!"
镜头 8 (25-28s): 超低视角近乎垂直仰拍，机器人环抱老奶奶罩成保护穹顶。台词 (机器人): "Don't look up. I've got you."
镜头 9 (28-30s): 超远景背影，两人紧紧相拥剪影。台词 (机器人): "I'm still here. I'll stay... as long as you need."
```

### 六个角色、两个场景的家庭短剧

- 用 KovAPI 生成 · 多图参考 · 15s · 720P · 9:16
- 按现价 $2.37
- 成片: https://img.kovapi.com/i/mp-46c667e5b78ca9105e0640bf.mp4
- 参考图 1: https://img.kovapi.com/i/mp-a6792abed7676768d2215f17.png
- 参考图 2: https://img.kovapi.com/i/mp-3ffc1f8f1d6e10f72f30876f.png
- 参考图 3: https://img.kovapi.com/i/mp-a597f359b98b6c84afff0b6a.png
- 参考图 4: https://img.kovapi.com/i/mp-1aa87318ba2ffa0e33a2f6f8.png
- 参考图 5: https://img.kovapi.com/i/mp-3a469285e81f868bd933d15c.png
- 参考图 6: https://img.kovapi.com/i/mp-6e5a0b7277826cf522ebc9dd.png
- 参考图 7: https://img.kovapi.com/i/mp-17786d9e48b89fa348215003.png
- 参考图 8: https://img.kovapi.com/i/mp-2ad7ea9eb1362c79e24ea40f.png

6 张人物三视图加 2 张场景图，按首次出场顺序编号，每个镜头写景别、机位和一句台词。原文镜头 2 写作「去羊城的火车票」，与前文的「大城」不一致，这里照原文提交。提示词和参考图出自火山方舟《[Doubao Seedance 2.5 提示词指南](https://docs.volcengine.com/docs/ark/seedance-2-5-prompt-guide?lang=zh)》，成片由 KovAPI 按原参数重新生成。

提示词原文:

```text
【统一风格与约束】 真实材质质感，细腻光影；角色面部和身体比例稳定，肢体结构自然，动作连贯，不僵硬，无穿模，无卡顿，无扭曲肢体，动作符合现实物理逻辑；禁止生成同款分身、双胞胎效果，同一画面中仅保留单个对应角色，不出现角色重复复刻；无字幕，无水印，无 logo，无乱码，无无关文字；无多余背景音乐。
【参考素材】 将图片 1 中的角色定义为秦秀莲； 将图片 3 中的角色定义为刘春香； 将图片 2 中的角色定义为王强； 将图片 4 中的角色定义为小乐； 将图片 5 中的角色定义为小石头； 将图片 6 中的角色定义为二妞； 将图片 7 定义为县城火车站售票处的参考场景； 将图片 8 定义为刘春香家卧室的参考场景； 将纸质车票定义为去大城的火车票。
镜头 1｜0 秒 - 2 秒
以人物为中心构图，近景，平视，正面机位，日、内，固定。 县城火车站售票处。 秦秀莲站在售票窗口前看向售票窗口。 秦秀莲说：“一张去大城的票。”
镜头 2｜2 秒 - 4 秒
局部构图，特写，平视，正面机位，日、内，固定。 县城火车站售票处。 秦秀莲握紧去羊城的火车票，低头看向车票目的地，嘴唇闭合。 秦秀莲（V.O.）说：“刘春香能做，我也能做。”
镜头 3｜4 秒 - 5 秒
三分法构图，中景，平视，斜 45 度侧面机位，夜、内，固定。 刘春香家卧室。 刘春香和王强坐在桌边清点当天收入。 刘春香看向桌上钱币，说：“七百多。”
镜头 4｜5 秒 - 7 秒
以人物为中心构图，近景，平视，正面机位，夜、内，固定。 刘春香家卧室。 王强看向桌上钱币，说：“比开业那天还多。”
镜头 5｜7 秒 - 9 秒
以人物为中心构图，近景，平视，正面机位，夜、内，固定。 刘春香家卧室。 小乐爬到刘春香身边，看向刘春香，说：“麻麻，我给你捶背！”
镜头 6｜9 秒 - 10 秒
以人物为中心构图，近景，平视，正面机位，夜、内，固定。 刘春香家卧室。 小石头看向刘春香，说：“我也来。”
镜头 7｜10 秒 - 11 秒
以人物为中心构图，近景，平视，正面机位，夜、内，固定。 刘春香家卧室。 二妞看向刘春香，说：“还有我！”
镜头 8｜11 秒 - 13 秒
对称构图，中景，平视，侧面机位，夜、内，固定。 刘春香家卧室。 小乐、小石头、二妞围着刘春香捶肩捶背。 刘春香悄悄握住王强的手，王强反握刘春香的手。
```

### 山神殿：古装群戏的表演细节

- 用 KovAPI 生成 · 多图参考 · 14s · 720P · 16:9
- 按现价 $2.212
- 成片: https://img.kovapi.com/i/mp-30e52e754ca98805ae61c525.mp4
- 参考图 1: https://img.kovapi.com/i/mp-18de79cd058f658275db14c9.png
- 参考图 2: https://img.kovapi.com/i/mp-68c995a3f3b8d3ed104fc022.png
- 参考图 3: https://img.kovapi.com/i/mp-f500ebb875a7096ed01fb75a.png
- 参考图 4: https://img.kovapi.com/i/mp-92aad676f9cac1923940bffb.png

4 张参考图定场景和人物；台词按「角色台词（情绪）：内容」拆开，要求口型同步、不出字幕。原文【资产锁定】把山神殿场景也写成了 @[图片3]（应为图片 1），这里照原文提交。提示词和参考图出自火山方舟《[Doubao Seedance 2.5 提示词指南](https://docs.volcengine.com/docs/ark/seedance-2-5-prompt-guide?lang=zh)》，成片由 KovAPI 按原参数重新生成。

提示词原文:

```text
【生成目标】 生成周婆婆在山神殿内走近林秀兰、反复确认她的面容并激动落泪的连续场景。古装悬疑奇幻真人电影风格，电影级写实质感。昏暗古朴的山神殿内有陈旧木梁、旧神龛、烛台和祭祀陈设，暖色烛火轻轻摇曳，空气中漂浮细小尘埃。
【主体与关系】 全程只有林秀兰、周婆婆、春丫、石头四人。春丫与石头分别搀扶周婆婆左右两侧；林秀兰始终站在周婆婆前方。保持参考人物的脸型、年龄、发型、服装和身高关系。周婆婆始终佩戴同一副老花眼镜。
【资产锁定】 周婆婆严格参考@[图片3] 。 林秀兰严格参考@[图片2]， 山神殿场景严格参考@[图片3] 。
【事件脚本】
0—4 秒：中景镜头围绕周婆婆缓慢向前推近。春丫与石头小心搀扶周婆婆起身，三人步履缓慢地走到林秀兰面前。周婆婆始终凝视林秀兰的脸；认出她后，脚步短暂停顿，嘴唇轻颤，双眼逐渐睁大，神情从震惊转为难以抑制的激动，仿佛见到等待多年的故人。林秀兰安静站立，困惑而警觉地回望她。结束时周婆婆在林秀兰面前站定，春丫和石头仍扶住她。
4—9 秒：切至周婆婆与林秀兰的面部近景。周婆婆先颤抖着扶正眼镜，再用一只手短暂揉一次自己的眼睛；确认没有看错后，她才伸出双手，轻轻捏住林秀兰两侧脸颊，缓慢左右拨看，再轻轻揉捏和拉扯确认。动作依次发生，不同时抢拍。手指准确接触脸颊，不遮挡眼睛、鼻子和嘴部。林秀兰被捏得轻微嘟嘴，露出错愕不解的神情，身体下意识稍稍后仰，但不挣扎、不躲开。周婆婆动作急切失态，却始终轻柔。结束时两人面部清晰可见，林秀兰的五官与脸型保持完整。
9—14 秒：镜头先切至周婆婆逐渐湿润的双眼，再平稳移至周婆婆与林秀兰的双人近景。周婆婆松开林秀兰的脸，双手轻微颤抖。周婆婆使用苍老沙哑、生涩蹩脚、带轻微异族口音但清晰可辨的普通话，周婆婆台词（难以置信）：“像……“
周婆婆台词（声音发颤）：“太像了。“
周婆婆台词（惊喜）：“终于等到你了，乡亲们有救了。“最后一个字说完时，泪水从周婆婆眼中涌出，画面停留在她含泪而欣慰的神情上。林秀兰、春丫和石头全程自然闭口，只用眼神和表情回应。
【摄影与声音】 采用稳定、缓慢、克制的电影运镜。人物面部始终清晰，背景自然虚化；暖色烛光勾勒人物轮廓，幽暗山神殿保持空间层次。表演细腻真实，不过度夸张。 <烛火轻微燃烧声、衣料摩擦声和山神殿细微声响> 极轻的低沉弦乐铺底，不遮盖台词。 没有旁白，画面不显示字幕、文字或标牌。
【保持一致】 保持四名角色的身份、数量、外貌、服装、身高关系、空间方位和视线方向连续。老花眼镜始终正确佩戴，不漂浮、不消失。搀扶、停步、揉眼、捏脸、松手和说话严格按顺序衔接。手部结构正常，手指与脸颊接触准确；捏脸过程中林秀兰不换脸，五官位置和脸部结构保持稳定。
【排除内容】 排除卡通感、滑稽恶搞、现代物品、掌掴、推搡和粗暴动作；排除人物换脸、年龄或服装变化、身高突变、角色增减、空间位置跳变和动作顺序混乱；排除手掌穿模、多余手指、手指粘连、手部畸形、脸部塌陷、五官扭曲、眼镜漂浮或消失；排除错误人物发声、多人同时说话、重复台词、漏词、口型错位和声画不同步；排除快速剪辑、跳帧、剧烈抖动、画面闪烁、字幕、文字、标志和水印。
```

### 同一角色、同一声音

- 用 KovAPI 生成 · 参考音频 · 8s · 720P · 16:9
- 按现价 $1.264
- 成片: https://img.kovapi.com/i/mp-ae1009e84d0c79cb09579e6a.mp4
- 参考图 1: https://img.kovapi.com/i/mp-f500ebb875a7096ed01fb75a.png
- 参考图 2: https://img.kovapi.com/i/mp-18de79cd058f658275db14c9.png
- 参考音频: https://img.kovapi.com/i/mp-00fbaccfff70ed326c2996f2.mp3

从「山神殿」成片里截出周婆婆的一句台词作参考音频，配她的形象图拍下一场戏，声音和外观都接着上一条。提示词按指南写法由 KovAPI 编写。

提示词原文:

```text
【素材】@图片1 是周婆婆的外观参考，全程佩戴同一副老花眼镜；@图片2 是山神殿场景参考；@音频1 是周婆婆的声音，台词的音色、语速和口音都参考它。
【概述】古装悬疑奇幻真人电影风格，电影级写实质感。清晨，周婆婆站在山神殿门口，送别画面外的人。
0-4 秒：中景，晨光从殿门斜照进来，周婆婆站在门槛边，朝画面外轻轻挥手。周婆婆台词（温和）：“山路滑，慢些走。”
4-8 秒：近景，周婆婆扶了扶老花眼镜，望着远处的山，眼里带着笑意。周婆婆台词（叮嘱）：“到了山下，记得回来报个平安。”
【贯穿全片】稳定、缓慢的镜头；暖色晨光，背景自然虚化；只保留人声、风声和远处的鸟鸣，不要背景音乐；画面不显示字幕和文字。
```

### 像素武侠：6 张关键帧一镜到底

- 用 KovAPI 生成 · 多图参考 · 15s · 720P · 9:16
- 按现价 $2.37
- 成片: https://img.kovapi.com/i/mp-d190ceb69b8b097b61b2e3b3.mp4
- 参考图 1: https://img.kovapi.com/i/mp-a8e6cafd16699c88bc205bde.png
- 参考图 2: https://img.kovapi.com/i/mp-d6a179f9802cc2abf2a287ff.png
- 参考图 3: https://img.kovapi.com/i/mp-c83b76a690b59f2c21e6ff58.png
- 参考图 4: https://img.kovapi.com/i/mp-5a28f9e51d489941e140610e.png
- 参考图 5: https://img.kovapi.com/i/mp-92c37e2d346d6d6316d76c50.png
- 参考图 6: https://img.kovapi.com/i/mp-7e7ee924787da67dc9b2d086.png

6 张图逐个写进镜头：logo、角色特写、秘籍、跃起、奔跑、活动界面，竖屏 15 秒一镜到底，配 8bit 国风音乐。提示词和参考图出自火山方舟《[Doubao Seedance 2.5 提示词指南](https://docs.volcengine.com/docs/ark/seedance-2-5-prompt-guide?lang=zh)》，成片由 KovAPI 按原参数重新生成。

提示词原文:

```text
根据 @图片1 - @图片6 制作一镜到底的像素武侠主题竖版视频，背景音乐使用国风 8bit 武侠风格音乐。全片统一浅蓝底色，像素风格统一，画面干净通透。
镜头 1：静止展示 @图片 1 的「江湖风云」水墨风格 logo，背景为统一浅蓝底色，画面保持约 1 秒静止。
镜头 2：@图片 1 中的文字区域消失后，@图片 2 的武侠男性角色像素脸部特写从画面底部滑入；角色眨眨眼看向镜头，随后快速向下位移离场；角色离场后，原本 logo 处变为 @图片 3 的蓝色「武功秘籍」像素书。
镜头 3：紧接 @图片 4，像素武侠小人角色从画面下方用力向上跃出，顶起上方的蓝色菱形问号标，问号标上方弹出深蓝色粗体字「今日闯江湖！」；角色落地后摆出 @图片 4 的站姿 pose，随后抬手打招呼，接着做出预备跑动作，转身向画面右侧奔跑（奔跑姿态参考 @图片 5），镜头跟随角色向右移动，角色从画面右侧跳出画面。
镜头 4：@图片 6 的 UI 界面从画面右侧位移入画，像素武侠角色从画面右上角跳入，落在「三月廿七日」大字的右下方，张开双臂摆出热情展示的定格姿势，最终定格在该画面。
整体像素武侠美术风格，色调统一浅蓝底，运镜连贯顺滑呈现一镜到底的连续位移与跟随，元素过渡自然、角色动作衔接流畅，画面无卡顿、无闪烁；文字与 UI 清晰稳定。
```

### 轮胎带货：商品图加三张文字图

- 用 KovAPI 生成 · 多图参考 · 16s · 720P · 3:4
- 按现价 $2.528
- 成片: https://img.kovapi.com/i/mp-87927e076c7f1080f771dab5.mp4
- 参考图 1: https://img.kovapi.com/i/mp-6d18a3f328848a8401c1d37c.png
- 参考图 2: https://img.kovapi.com/i/mp-e80747cc976af420c832baff.png
- 参考图 3: https://img.kovapi.com/i/mp-b7de1cac42d0cf89e63906d7.png
- 参考图 4: https://img.kovapi.com/i/mp-5b00ca03b6560e4b93f7390f.png

商品图定产品外观，三张文字图让屏幕大字写对，4 个镜头配中文口播；提示词在每处大字后面标出对应的参考图。提示词和参考图出自火山方舟《[Doubao Seedance 2.5 提示词指南](https://docs.volcengine.com/docs/ark/seedance-2-5-prompt-guide?lang=zh)》，成片由 KovAPI 按原参数重新生成。

提示词原文:

```text
为图1中的商品生成视频，由中国中年自然肤色黑色寸头日常户外风男模特出镜，手持商品进行动态展示与解说。镜头 1，镜头从中景缓慢推进至近景。阳光明媚的广阔户外公路旁，一位中国中年、自然肤色、黑色寸头、穿着日常户外冲锋衣的男模特，一手扶着立在地上的大品牌轮胎，面向镜头自信地进行解说。 男主播：“大品牌轮胎，伴你安心出行。” 背景音乐：节奏轻快的户外运动风纯音乐。 画面正下方显示粗体黑字“大品牌轮胎 伴你安心出行” 参考图2。镜头 2，镜头特写轮胎正面花纹。男模特的手指顺着轮胎上深深的纵向排水沟槽滑动，随后手掌有力地拍打胎面，动态展示轮胎清晰的纹理和扎实的质感。 男主播：“强效排水，稳健抓地。” 背景音乐持续，伴随轻微的摩擦音效。 画面左侧弹出黑体大字“强效排水 稳健抓地” 参考图3。镜头 3，镜头平移转至轮胎侧面特写。男模特用手掌按压轮胎侧壁展示其优良的韧性与弹性，随后手指指向侧面凸起的品牌标识区域。 男主播：“静音舒适，坚韧耐用。” 背景音乐持续。 画面右侧弹出黑体大字“静音舒适 坚韧耐用” 参考图4。镜头 4，镜头拉远回到中景。男模特双手扶住轮胎边缘，轻松地将其向前滚动半圈，随后站定，微笑着向镜头竖起大拇指，背景是充满活力的自然风光。 画外音：“你的安心之选。” 音乐高潮处有力收尾。 画面中央浮现黑体大字“伴你安心出行” 参考图2
```

### 白模加关键帧：30 秒 3D 动画

- 用 KovAPI 生成 · 参考视频 · 30s · 720P · 16:9
- 按现价 $6.60
- 成片: https://img.kovapi.com/i/mp-4c370c7b762ab0bae293f381.mp4
- 参考图 1: https://img.kovapi.com/i/mp-634ba490a460e269825e6f90.png
- 参考图 2: https://img.kovapi.com/i/mp-a51be9eda6947454338b6143.png
- 参考图 3: https://img.kovapi.com/i/mp-df1d64f97bbc630b33231d4e.png
- 参考图 4: https://img.kovapi.com/i/mp-00aea6106ad6fd195fae19d7.png
- 参考图 5: https://img.kovapi.com/i/mp-5eebe1628e0218cd71078837.png
- 参考图 6: https://img.kovapi.com/i/mp-d51ce51f1486ca0898e35865.png
- 参考图 7: https://img.kovapi.com/i/mp-12cb5d92cda9c1480119a4ef.png
- 参考图 8: https://img.kovapi.com/i/mp-a3675d2996c5a522a748a49d.png
- 参考图 9: https://img.kovapi.com/i/mp-8fb79f42e2a9f97c2ccbe27c.png
- 参考视频 (30s): https://img.kovapi.com/i/mp-c0ff18bf0ffcbccf66defe15.mp4

一段 30 秒的白模视频管运镜和角色动画，9 张关键帧管各阶段画面，按时间轴逐段对应。参考视频的 30 秒也计入费用。提示词和参考图出自火山方舟《[Doubao Seedance 2.5 提示词指南](https://docs.volcengine.com/docs/ark/seedance-2-5-prompt-guide?lang=zh)》，成片由 KovAPI 按原参数重新生成。

提示词原文:

```text
以白模参考视频 <video1> 作为整支视频唯一的运镜、镜头节奏、景别变化、主体运动轨迹和镜头调度参考，严格保持白模视频的镜头顺序、机位变化、运动方式和节奏，不改变镜头结构，不新增镜头，不改变主体运动逻辑。结合各阶段关键帧参考图，生成一部 30 秒电影级 3D 动画短片，整体风格梦幻、童话、温暖，具有儿童幻想色彩，角色外形与各阶段的关键帧保持一致，不要改变角色形象，人物表情情绪随场景变化而改变。
0-3s（首帧参考 <2pic>）镜头由全景俯视缓缓推向地上的小女孩，小女孩坐在房间的地毯上玩飞机，小女孩起身左转，右手使劲一挥将手里的飞机放飞。
3-5s（参考 <3pic>）飞机从左至右穿过房间悬挂的星星挂件，小女孩乘坐飞机进入幻想的天空。
5-8s（参考 <4pic>）镜头继续侧跟，以小女孩为中心的环绕。
8-10s（参考 <5pic>）镜头环绕到小女孩驾驶的飞机背面、飞机开始缓缓俯冲海面。
10-19s（参考 <6pic>、参考 <7pic>）小女孩继续向海底游去，一条鳐鱼游过来入画。
19-23s（参考 <8pic>）小女孩从时空裂缝冲出来到幻想宇宙。
23-24s（参考 <9pic>）前景小女孩和星球开始前翻转并，逐渐幻化消失。
24-28s（参考 <9pic>）俯视镜头持续推进，小女孩躺在地的毯上熟睡。
28-30s（参考 <10pic>）镜头继续推进绘本，随后爸爸进入画面。
整体要求：所有画面均参考对应关键帧，白模视频仅作为运镜、镜头运动和角色动画参考，不参考画面内容。最终输出 30 秒 16:9 横构图宽屏视频。
```

### 熊猫幼崽滚下草坡

- 用 KovAPI 生成 · 文生视频 · 8s · 720P · 16:9
- 按现价 $1.264
- 成片: https://img.kovapi.com/i/mp-ed231c10ec7c24e490b6cceb.mp4

纯文生：先用一句话交代风格、地点和事件，再按 0–3 秒、3–8 秒写动作，最后补镜头和环境音。提示词和参考图出自火山方舟《[Doubao Seedance 2.5 提示词指南](https://docs.volcengine.com/docs/ark/seedance-2-5-prompt-guide?lang=zh)》，成片由 KovAPI 按原参数重新生成。

提示词原文:

```text
写实自然纪录片风格，电影级真实光影，温暖的午后, 在森林草坡上, 一只圆滚滚的熊猫幼崽从坡上滚下来.

熊猫黑白毛发蓬松真实，体型小而胖，动作笨拙可爱。场景为绿色森林斜坡，地面覆盖青草、苔藓、三叶草、泥土、小石块、枯枝和少量小黄花，虚化背景中有高大树干与树林。镜头为低机位中远景，轻微手持感，整体基本固定，始终保持熊猫在画面中。

0s-3s：一只熊猫幼崽趴在绿色草坡上，身体圆滚滚, 它刚开始顺着斜坡慢慢侧滚，动作笨拙，草叶被身体轻轻压弯。微风拂过, 阳光从左上方穿过树林，形成斑驳光影。
3s-8s：熊猫滚到画面右下方，动作逐渐停止，从侧躺变成趴卧。它的圆脸朝向镜头，前爪压在草地上，熊猫趴在前景草丛中，身体调整到舒服的姿势，头部小幅抬起又放低, 发出轻微哼唧声。

低机位，轻微手持感，轻微跟随熊猫向右下方移动。景深自然，前景草叶轻微虚化，熊猫主体清晰，背景树林柔和虚化。自然环境音，风声、熊猫滚动时轻微柔软的扑通声, 整体温暖、真实、自然。
```

## Seedance 2.5 提示词：按导演的思路写

以火山方舟《[Doubao Seedance 2.5 提示词指南](https://docs.volcengine.com/docs/ark/seedance-2-5-prompt-guide?lang=zh)》为主：先交代素材分工，再用一句话概括，然后按时间轴写情节，最后补上贯穿全片的镜头、环境与声音。下面的例句摘自本页案例的提示词（原文出自该指南）。

- **按上传顺序点名素材**: 图片、视频、音频分别按上传顺序编号，逐个写清用途：谁是形象、谁是音色、谁是动作、谁是场景。只部分参考时，写明参考哪一部分。 — 守护机器人原文：“image3: 主体 1 (守护机器人) 角色外观参考。”
- **一句话先给出全片**: 开头一句交代主体、地点、事件、题材风格和特殊运镜，模型先拿到整体，再读细节。 — 熊猫原文：“写实自然纪录片风格，电影级真实光影，温暖的午后, 在森林草坡上, 一只圆滚滚的熊猫幼崽从坡上滚下来.”
- **用整数秒时间戳排情节**: Seedance 2.5 能按整数秒的时间戳排情节。时间段要连续，每段写画面、运镜、动作、台词和音效；一段里内容太多会被剪得很碎。 — 熊猫原文：“0s-3s：一只熊猫幼崽趴在绿色草坡上……3s-8s：熊猫滚到画面右下方……”
- **台词写明说话人和情绪**: 按「角色台词（情绪）：内容」写，每句单独一行；台词后面不要再复述同一句话的语气，否则容易冒出字幕。 — 指南示例：“周婆婆台词（声音发颤）：“太像了。””
- **反向要求只写字幕和声音**: 「不要字幕」「不要背景音乐」这类反向要求有效；画面内容尽量用正向描述。禁 BGM 时把音乐类同义词写全，并在开头和结尾各写一次。 — 指南示例：“无 bgm，只生成环境音和动作音”
- **多人按首次出场排序**: 多个角色时，按第一次出场的顺序上传参考图并编号，提示词里的编号与之对应，能减少角色串位。 — 一家人原文：“将图片 1 中的角色定义为秦秀莲；将图片 3 中的角色定义为刘春香……”
- **要准确的文字做成图片**: 画面里必须写对的字，做成图片作为参考，或把英文单词拆成字母依次出现。 — 轮胎原文：“画面左侧弹出黑体大字“强效排水 稳健抓地” 参考图3。”
- **参考图不必大于成片**: 参考图分辨率明显高于成片时，草地、树叶等密集纹理偶尔出现指纹状纹理；把图缩到不超过成片分辨率可以降低概率。 — 本页案例的参考图都缩到长边 1280 像素后再提交（720P 成片）。

| 部分 | 作用 | 示例 |
| --- | --- | --- |
| 素材分工 · 守护机器人 | 四张图各管一件事：分镜结构、环境、两个角色的外观。编号和上传顺序一致。 | 原文：“image1: 九宫格分镜参考，用于整体镜头结构、景别与运镜节奏。” |
| 主体设定 | 每个角色一段：外观、体型、身高关系；后面的镜头只写动作，不再重复外观。 | 原文：“主体 2 (老奶奶): 参考 image4，瘦小年迈女性，银发挽成低髻……身高只及机器人胸口。” |
| 整体风格 | 一次说清片型、质感、摄影方式和画幅，整条片都按这套风格走。 | 原文：“真人实拍彩色电影正片……手持摄影，呼吸感摇晃，浅景深大光圈……16:9 横屏。” |
| 严格排除 | 分镜图是线稿，写明不要画成线稿、动画或故事板，避免把参考图的画法带进成片。 | 原文：“【严格排除】黑白、单色、灰度、去色；手绘、素描、线稿、插画、漫画、动画……” |
| 分镜头与时间轴 | 9 个镜头覆盖 0–30 秒，每个写景别、机位和动作；时间段首尾相接。 | 原文：“镜头 4 (10-14s): 超远景仰摇，火箭升空拖曳浓白烟迹。” |
| 台词 | 台词跟在对应镜头里，写明是谁说的；英文台词原样写英文。 | 原文：“台词 (老奶奶): "Fly safe, my child. Come back to me."” |

```text
【素材】@Image1 是主角的外观参考；@Image2 是场景参考；@Audio1 是主角的音色参考（没有就删掉这一行）。
【概述】生成一段 15 秒、16:9 的（题材）短片：（主体）在（地点）（发生的事），（风格与质感）。
【时间轴】
0-5 秒：（景别、运镜）（主体动作）。主角台词（情绪）：“……”
5-10 秒：（景别、运镜）（情节推进）。
10-15 秒：（景别、运镜）（结尾画面）。
【贯穿全片】镜头：（手持 / 稳定器 / 固定）；光线与色调：（……）；声音：（环境音、动作音效；不需要时写「不要背景音乐」）；不要字幕。
```

## 如何在 KovAPI 上用 Seedance 2.5 生成视频

1. **注册并创建 API Key** 登录 KovAPI，在控制台创建 Key；同一把 Key 可以调用站内所有模型。
2. **在页面上方试提示词** 上传参考图、视频或音频，选好时长、分辨率和比例，提交前就能看到实时报价。
3. **提交异步生成任务** 用 `seedance-2.5` 提交到 `POST /v1/videos/generations`，收到 HTTP 202 后保存任务号；完整请求示例见文档。
4. **查询结果或接收 Webhook** 按任务号轮询，或提交时设置 `callback_url` 接收结果。成功后从 `data[0].url` 下载 MP4；成片保留 7 天，请及时保存。

### 最小请求示例

```bash
curl https://kovapi.com/v1/videos/generations \
  -H "Authorization: Bearer $KOVAPI_KEY" -H "Content-Type: application/json" \
  -d '{"model": "seedance-2.5", "prompt": "...", "duration": 4, "resolution": "720P", "size": "16:9"}'
# -> HTTP 202 {"id": "..."}; poll:
curl https://kovapi.com/v1/videos/jobs/<id> -H "Authorization: Bearer $KOVAPI_KEY"
```

## Seedance 的演进

- 2025-06-11 · Seedance 1.0: **Seedance 1.0 · 多镜头** 字节 Seed 发布 Seedance 1.0，支持 1080P 和多镜头叙事。
- 2025-12-16 · Seedance 1.5 pro: **Seedance 1.5 pro · 音画同出** 首次在生成画面的同时生成声音。
- 2026-02-12 · Seedance 2.0: **Seedance 2.0 · 四种输入** 文字、图片、视频、音频四种输入，单条最长 15 秒，参考上限为 9 张图、3 段视频、3 段音频。
- 2026-07-31 · Seedance 2.5: **Seedance 2.5 · 长叙事与强参考** 单条最长 30 秒；参考图增至 30 张，参考视频、音频各 10 段；原生支持 11 种语言，能按整数秒时间戳安排情节。

## Seedance 2.5 与其他视频模型怎么选

| 型号 | 时长（秒） | 分辨率 | 参考 图 / 视频 / 音频 | 价格 | 适合 |
| --- | --- | --- | --- | --- | --- |
| Seedance 2.5 (`seedance-2.5`) | 4–30 | 480P / 720P / 1080P | 30/10/10 | $0.10/秒 | 一条任务要放进大量参考素材（图片、视频、音频可以一起给），并且要按整数秒时间轴安排情节的成片。 |
| Seedance 2.5 · Special (`seedance-2.5-30s`) | 4–30 | 720P | 30/10/10 | $2.00/条 | 同一模型的按条计费版：720P、16:9 / 9:16，任意时长同一价，短期开放。 |
| Seedance 2.0 (`seedance-2.0`) | 5–15 | 480P / 720P / 1080P / 4K | 9/3/3 | $0.07/秒 | 已有 Seedance 2.0 样片、需要沿用 2.0 画风时；两代的画风差别明显。 |
| Seedance 2.0 Fast (`seedance-2.0-fast`) | 5–15 | 480P / 720P | 9/3/3 | $0.052/秒 | 只要 720P 以内的短片、预算优先时。 |
| Wan 3.0 (`wan3.0-video`) | 4–30 | 480P / 720P / 1080P | 10/5/5 | $0.04/秒 | 需要首帧 / 首尾帧，或用文档、网页生成视频时。 |
| MiniMax H3 (`minimax-h3`) | 4–15 | 480P / 768P / 1080P | 9/3/3 | $0.015/秒 | 批量短片：先用 480P / 768P 打样，再出 1080P；能做首尾帧，参考模式可带参考音频和参考视频。 |
| Veo 3.1 (`veo-3.1`) | 8 | 720P / 1080P | 3/0/0 | $0.20/条 | 固定时长、按条计费的短片。 |

已有其他模型的稳定样片时，用同一组素材和验收标准，对比人物一致性、动作、声音、出片耗时和实际费用，再决定是否切换。

## 组合规则与注意事项

- 参考音频不能单独使用，要和参考图或参考视频一起提交。三类素材可以同时传，分别编号：第二张图是 `@Image2`，第一段音频是 `@Audio1`。
- `prompt` 上限 11,000 个字符，中文和英文都按字符计，标点、空格与换行也计入。
- 每条成片都带音轨。不需要配乐或人声时，在提示词里写「不要背景音乐」「不要台词」；「不要字幕」也有效。
- 可以用真人照片作参考；公众人物、明星的形象和声音会被内容审核拒绝，被拒不计费。请确认你有权使用相关肖像。

## 为什么在 KovAPI 使用 Seedance 2.5

- **比字节官方价低**: 720P 比字节官方定价低 31%，1080P 低 33%；带参考视频的单价也低于官方。在线测试提交前就显示这一单的价格。
- **真人照片直接用**: 真人照片可以直接作参考图，不用打码，真人出镜的带货、短剧和口播都能做。公众人物、明星的形象和声音会被审核拒绝，被拒不计费。
- **失败不扣费，自动重试**: 生成失败，预扣的费用全额退回；上游繁忙或出错时系统自动重试，不用自己写重试逻辑。
- **不限并发**: 每个账号不设并发上限，批量任务直接提交；高峰时自动排队，接口返回 `queue_position` 和 `eta_seconds`，完成后可推送 Webhook。
- **成功率公开**: 页首「真实调用实测」公开近 7 天真实客户请求的成功率和出片时间，不含我们自己的测试，好坏都照实显示。
- **注册和付款都简单**: 邮箱或 Google、GitHub 注册，微信、银行卡、PayPal、USDT 都能充值，按量扣费、没有月费；同一把 Key 还能调用站内的对话和生图模型。

## Seedance 2.5 API 常见问题

### Seedance 2.5 是什么？

字节跳动 2026 年 7 月发布的视频生成模型。在 KovAPI 用 `seedance-2.5` 调用，支持文生视频，以及参考图、参考视频、参考音频，成片自带声音，单条最长 30 秒。

### 能生成多长的视频？

4–30 秒的整数时长，不传 `duration` 时按 4 秒。参考视频不占成片时长，但它的秒数要计费。

### 能指定开场画面吗？

可以在提示词里写「以 @Image1 的画面开场」或「图片 3 为首帧，图片 5 为尾帧」。图片都按参考使用，成片会接近这张图，但不保证逐像素一致。

### 一次最多能放多少参考素材？

图片 30 张、视频 10 段（合计不超过 30 秒）、音频 10 段，三类可以一起用。官方建议主体图 1–8 个主体，主体音视频每段 5–10 秒，效果较稳定。

### 参考音频怎么用？

放进 `audio_reference`，同时附参考图或参考视频；提示词里用 `@Audio1` 写明参考它的音色、台词还是音乐。参考音频不另计费。

### 带参考视频怎么计费？

按（参考视频秒数 + 成片秒数）× 带参考视频的单价计费，例如 720P 是 $0.11/秒。参考图和参考音频不另收费，提交前可以在在线测试看报价。

### 成片有没有声音？

每条成片都带音轨，台词、音效和音乐跟画面一起生成。不需要配乐或人声时，在提示词里写「不要背景音乐」「不要台词」；要完全无声的素材，可以下载后去掉音轨。

### 能用真人照片吗？

可以用真人照片作参考。公众人物、明星的形象或声音会被内容审核拒绝，被拒的任务不计费。请确认你有权使用相关肖像。

### 台词支持哪些语言？

台词可以写中文、英文等多种语言；字节官方介绍 Seedance 2.5 原生支持 11 种语言。按「角色台词（情绪）：内容」逐句写，口型和声音更容易对上。

### 出片要多久？

近 7 天真实调用的中位耗时为 6.6 分钟，90% 在 10.1 分钟内完成。排队时可以读取 `queue_position` 与 `eta_seconds`，以任务的实际状态为准。

### 生成失败会扣钱吗？

生成失败，未计费，可原样重新提交。提交时的预扣会全额退回，同一任务的自动重试只结算一次。

### 成片能保存多久？

成片和上传的参考素材保留 7 天，到期自动删除，请及时下载保存。

### 和 Seedance 2.0 有什么区别？

2.5 的时长和参考上限都更高（见对比表），能按整数秒时间戳安排情节。两代画风差别明显，已有 2.0 样片的项目，建议用同一组素材先对比再切换。

### seedance-2.5、特价版和 Token 版是什么关系？

`seedance-2.5` 按秒计费，就是本页；[特价版](https://kovapi.com/zh/model/seedance-2.5-30s) `seedance-2.5-30s` 按条计费、只有 720P、短期开放；[Token 版](https://kovapi.com/zh/model/seedance-2.5-token) `seedance-2.5-token` 按实际视频 token 计费，支持样片升级。三者价格和页面各自独立。

## 给 AI 的补充说明

- 型号 id 为 `seedance-2.5`，使用 `POST /v1/videos/generations` 提交，返回 HTTP 202 和任务号 `id`；用 `GET /v1/videos/jobs/` 加任务号查询结果。
- `resolution` 的值须带 `P`：480P / 720P / 1080P，默认 720P；`size` 可选 16:9 / 9:16 / 1:1 / 4:3 / 3:4。`seconds` 是 `duration` 的别名，`aspect_ratio` 是 `size` 的别名。
- 图片一律按参考使用，`image_role` 对本型号不起作用；提示词用 `@Image1` 等按上传顺序点名。
- `video_references` 可传链接字符串或 `{"url": ...}`，时长由服务端读取，不必写 `duration`；单段不超过 30 秒，合计不超过 30 秒。
- `audio_reference` 最多 10 段，必须和图片或参考视频一起提交；不接受 data: 内联音频。
- `audio: false` 不起作用，成片总带音轨。
- `prompt` 最多 11,000 个字符。参考图每边 300–6000 像素、宽高比 0.4–2.5，不合格时提交即返回 400 `reference_image_dimensions`，不扣费。
- 带参考视频的任务按（参考视频秒数 + 成片秒数）× 带参考视频单价计费，例如 720P $0.11/秒；不带时按成片秒数 × $0.158/秒（720P）。

## 延伸阅读

- [Seedance 2.5 API 调用文档](https://docs.kovapi.com/zh/seedance-2.5): 请求字段、异步任务、返回结果和完整代码示例。
- [异步任务指南](https://docs.kovapi.com/zh/guide/async-jobs): 任务状态、排队字段与结果查询。
- [Webhook 接入指南](https://docs.kovapi.com/zh/webhooks): 接收任务结果，并按文档验证通知签名。
