如何使用 Seedance 2.5：官方 API 上线后的接入指南

Seedance 2.5 官方开发者 API 已上线。下面分别介绍官方应用与 API 工作流。本文是一份独立指南，与字节跳动没有从属关系；执行调用时，本站推荐 EvoLink 作为第三方 API 接入服务商。生产使用前仍需确认账号权限、实时价格与实际输出。

通道一：官方应用（Dreamina、CapCut）

字节跳动在自家的创作类应用中提供 Seedance 2.5。如果你已经在为 Dreamina 或 CapCut 的套餐付费，并且你所在的区域获得了访问权限，这可能是最一体化的体验——生成、编辑和发布都在同一个地方完成。需要注意的是：推广会按区域和套餐分批进行，而重度使用往往很快就会触及套餐上限。

通道二：API 通道（正式上线）

API 接入已经提供 T2V、I2V、R2V 三个 workflow ID。投入前请核对费率卡、服务商文档、控制台权限和真实账单。API 快速上手提供可运行的 2.5 请求；Seedance 2.0 只作为回滚。

不想先写代码？两条路：在演练场里设置镜头，写好提示词、选择时长和画质，再把请求带到实际 API 工作流；或者直接从提示词库的官方案例卡片一键把完整 prompt 和上线档位预填到 EvoLink 的生成器里试跑。你也可以通过智能体来驱动它。

选对 workflow：三个模型 ID 各管什么

两个容易踩的坑：图生视频的 prompt 是必填的，不能只传图；它的帧图上限是 2 张——想用更多素材做一致性控制，应该切换到参考生视频，而不是往图生视频里塞图。

提示词本身的上限是 10,000 token，通道文档建议中文控制在约 500 字以内——超长提示词不会更听话，把预算花在镜头语言的精确度上更划算。

撰写提示词：直接指挥，而非泛泛描述

提升质量最关键的一个杠杆，是像导演一样下达指令，而不是像许愿一样描述。对比一下：

❌ “夕阳下的美丽城市，电影感，高质量”

✅ “黄金时刻无人机从海滨城市上空拉远，变形宽银幕镜头光晕，缓慢移动镜头越过港口拉出，此时街灯逐一亮起”

第二个提示词明确了镜头运动（无人机拉远、缓慢移镜头拉出）、光线（黄金时刻、镜头光晕）以及带有时序的事件（街灯逐一亮起）。Seedance 2.5 预计能很好地理解镜头术语——甩镜、变焦对焦（rack focus）、升降镜头运动、手持晃动，这些都值得明确写出来。

一种通常表现不错的结构：

1. 镜头类型 + 镜头运动——“微距镜头推进”、“手持跟拍”
2. 主体 + 动作——发生了什么，按顺序描述
3. 光线 + 氛围——“逆光蒸汽”、“钠灯路灯”
4. 风格锚点——胶片类型、年代、类型片

从提示词库中借用附带设置的可用示例。

使用参考素材

多模态参考 workflow 已上线，R2V 支持 30 张图、10 个视频和 10 个音频。请先规划角色，再逐层添加素材：

素材传的是 URL 而不是文件本体，所以要保证链接在任务执行期间可访问——带过期时间的签名 URL 是最常见的隐性失败原因之一。

行之有效的工作流：先用纯提示词的镜头来找到画面，然后一层一层地加入参考素材——先角色，再镜头运动，最后音频。一次性全部加上会让失败无从诊断。

时长、画质与音频：默认值和可选范围

不传参数时通道会使用默认值，先了解默认值能避免”为什么出来是 5 秒”这类困惑：

两点提醒：竖屏内容记得显式传 9:16，不要依赖 adaptive 猜测；generate_audio 默认开启，做后期配音的管线要主动关掉它，否则每个镜头都会带一条你用不上的音轨。具体计费仍应按账号和实时文档核对；所有 route capability 都应保持可配置。

在不烧预算的前提下迭代

先按 2.5 文档选择低风险的短时 smoke test 建立成本基线，再用费率卡与真实账单更新预算，然后逐步放量。

常见失败模式

• 镜头中途面部变形——加入角色参考图；不要只依赖提示词。
• 镜头死板——你没有指定运动。静态的提示词只会得到静态的画面。
• 音频与剪辑不同步——明确描述同步方式（“每个重拍上光线发生变化”），并把音轨作为音频参考提供。

在演练场里设置你的第一个镜头，并在进入生产之前核实服务商的支持情况和价格。