Seedance 2.5 官方指南：把字节的视频模型参数手册搬进了 GitHub

一条 404，和一份被"藏起来"的参数手册

如果你做过 AI 视频生成，最痛苦的事情大概不是模型效果不好，而是你不知道该怎么正确地调用它。

2026 年 8 月 7 日，字节跳动的 Seedance 2.5 开放了 API，支持文生视频、图生视频、参考生视频、视频编辑、视频续写五种模式，可生成 4-30 秒、480p/720p/1080p 的带同步音频视频。这是个强得多的模型——但它的参数表极其庞杂：30 张参考图上限、10 段参考视频、10 条参考音频、单请求最多 50 个素材引用、draft 草稿模式、content_filter 与 web_search 互斥、回调 URL 禁私网 IP……这些散落在官网文档的各个 tab 里。

EvoLinkAI 做的，是把这份手册变成一个能 clone 下来、能 grep、能离线读、能当参考手册用的 GitHub 仓库。

仓库 Banner：Seedance 2.5 Official Guide，标注 36 official media assets

它到底是什么：一本"GitHub 化的 API 手册"

这仓库没有一个"项目"意义上的代码，它是内容仓库——但内容组织得像一个软件项目。

核心是 data/seedance-2-5-manifest.json：89KB 的结构化清单，精确记录 36 个官方媒体素材。每个条目包含 index、dir、role、section、title、url、filename、prompt、sourceType、references、thumbnailPath、localMediaPath、mediaUrl 共 12 个字段——连完整的中文提示词都逐字保留。

按 section 统计，这 36 个案例的分布是这样的：

板块	数量
突破叙事边界	16
用户作品	9
深化可控编辑	6
首屏视频	3
拓展多语种呈现	2

"突破叙事边界"占掉近一半，说明 2.5 最大的卖点是长镜头叙事连贯性——一个 30 秒镜头里能完成从蒸汽朋克齿轮到星空矿脉山脊的连续转场。

五个生成模式：路由比参数更重要

EvoLink 的文档里藏着一个很容易踩的坑，值得单独拎出来说：

所有路由共用同一个 endpoint POST /v1/videos/generations，靠 model 字段选择路由，每条路由有各自的参数白名单。

模型 ID	模式	素材要求
seedance-2.5-text-to-video	文生视频	仅 prompt
seedance-2.5-image-to-video	图生视频	1-2 张图（首帧 / 首尾帧）
seedance-2.5-reference-to-video	参考生视频	30 图 / 10 视频 / 10 音频任选
seedance-2.5-video-edit	视频编辑	至少 1 段待编辑视频
seedance-2.5-video-extend	视频续写	至少 1 段待续写视频

真正的陷阱是：如果你的 prompt 里带了"删除""替换""继续"这类编辑意图，系统不会当场报错——它会把你按普通任务受理，然后在跑起来之后失败。 官方文档明确说"once this model's prompt carries an editing or extension intent, the request is validated as an edit / extend task — it is accepted without an error and the task only fails while it runs"。

这就是为什么这个仓库有价值：它把"该选哪个 model ID"的判断依据和踩坑记录放在了一起，而不是让你在两次失败的计费之后自己总结。

36 个官方素材之一：首屏发布影片缩略图

12 语种 + 55 案例索引：本地化做到极致

这个仓库最"重"的部分是它的多语言工程量。

根目录并排放着 12 个语言的 README：English、简体中文、繁體中文、日本語、한국어、Deutsch、Français、Español、Português、Русский、Türkçe，加一个 README.de.md 之外的 README.zh-TW.md（繁中）。

use-cases/ 目录下同样有 12 套语言版的案例集，主题分 10 类：一致性（consistency）、运镜（camera-movement）、创意效果（creative-effects）、故事补全（story-completion）、视频延长（video-extension）、音频人声（audio-voice）、连贯性（continuity）、视频编辑（video-editing）、音乐同步（music-sync）、情绪（emotion）。

再加上 seedance-2-guide/ 里完整保留的 Seedance 2 旧版指南（含 55 个案例索引），这个仓库实际上是一份视频提示词工程的百科全书。

"用户作品"板块收录的官方游戏预告风格案例

立即可跑的 Quick Start

仓库给了一条最短可运行路径：

export EVOLINK_API_KEY="your_key_here"

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header "Authorization: Bearer ${EVOLINK_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.0-text-to-video",
    "prompt": "A cinematic product reveal, slow dolly-in, reflective glass table, premium commercial lighting",
    "duration": 5,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

注意这里的细节：README 里特意用 > 标注提示——当前可运行的示例仍使用稳定的 seedance-2.0-* 模型 ID，不要把已验证的 2.0 ID 换成未经验证的 2.5 ID。2.5 还在 rollout 阶段。这是很负责任的写法，也是这个仓库比官网文档更实用的一点。

上手门槛：零部署，但不是零依赖

这仓库本身是纯静态文档，克隆下来用浏览器打开 README 就行，不需要 Node、不需要 Python、不需要 GPU、没有 Dockerfile 也没有 docker-compose。

但要说清楚：它不是一个能本地跑的 AI 视频模型。要真正生成视频，你必须：

1. 去 EvoLink 控制台申请 API Key
2. 按账号套餐付费（官网标价 480p 带视频输入约 $0.084/秒起）
3. 异步轮询 task_id 或配置 HTTPS 回调

所以对"想把 Seedance 2.5 部署到自己机器上"这个需求，答案是做不到也不需要——它本质是云 API 的配套文档层。

另一个实际约束：init-repo.sh 里还留着旧版的仓库初始化脚本，默认仓库名是 jimeng-seedance-2.0-guide，和当前的 awesome-seedance-2.5-guide 不一致，说明脚本没有随改名同步更新。

争议与局限

第一，它是厂商的营销资产，不是独立评测。 EvoLink 是 Seedance 的 API 聚合服务商，仓库里的 36 个案例全部标注 "official cases"，且明确说明"individual case blocks do not include creator attribution or source lines"——没有创作者署名，没有来源链接。这是厂商素材的合规处理，但对读者来说意味着你无法溯源这些优秀案例到底出自谁手。

第二，"官方指南"的官方性来自厂商而非字节。 仓库归属 EvoLinkAI，内容是"把字节的发布материал整理成 GitHub 形式"，字节官方并未背书。

第三，单一贡献者 + 更新停滞。 413 star、47 fork，但只有 1 个贡献者，最后 push 是 2026-09-05，距今已一个多月。AI 视频模型迭代极快，参数随时可能变——一个停止更新的手册，本身就是风险。

第四，License 字段与实际声明不一致。 GitHub API 返回 NOASSERTION（非标准 SPDX），README badge 写的是 CC BY 4.0，实际 LICENSE 文件是 Apache 2.0（字节原始发布材料许可），仓库自身内容的授权边界并不清晰。要商用前请务必自行确认。

第五，README 正文超过 11 万字符。 2000 多行的单文件 Markdown 虽然完整，但在 GitHub 上实际阅读体验很差——多数人还是会选择官网文档。

行业意义

Seedance 2.5 的 API 开放是一个明确信号：视频生成模型正在从"会出片"进入"可控生产"的阶段。

值得注意的三个结构性变化：

• 时长：从 5-10 秒的片段走向 4-30 秒的镜头级叙事
• 音频：同步生成人声/音效/BGM 成为默认能力（generate_audio 默认 true 且不额外计费）
• 引用规模：单请求最多 50 个素材引用，让"角色/产品/运镜/声音"能被同时锚定

而 EvoLinkAI 这个仓库的意义在于，它代表了API 文档分发方式的一次迁移：从"厂商官网 tab 页面"到"版本化的 Git 仓库"。对于需要长期维护、多语言、需要离线查阅、需要 grep 搜索参数的场景，Git 仓库几乎是必然选择。

413 star 在 AI 视频这个热门赛道里不算多，但考虑到它诞生于 2026 年 2 月、且面向的是相对小众的"多语言完整参数手册"需求，这个数字是合理的。

适合谁

• 适合：正在接入 Seedance 2 / 2.5 API 的开发者；需要写视频提示词的 AI 视频创作者；需要多语言视频提示词参考的团队。
• 不适合：想本地部署视频模型的团队（它是文档不是模型）；追求独立第三方评测的决策者（内容全部来自厂商）；需要持续更新参数的长期依赖方（更新停滞）。