seedance-2-5-skill

Seedance 2.5 技能

语言路由

• 对于英文请求，请遵循此文件和 *.md 参考文件。
• 对于中文请求，请先阅读中文工作流， 然后使用对应的 *.zh-CN.md 参考文件。
• 模型 ID、JSON 键、命令、媒体占位符和原生音频符号都必须原样保留为代码。不要翻译它们。

不要强制所有请求都走同一套网格图像流程。先选择视频路线，然后仅启用任务所需的准备模块。

1. 选择创作路线

需求	路线	输入	结果
一个简短、简单的场景	T2V	文本提示词	一个完整独立的镜头
一组带有清晰可读分镜的多镜头序列	R2V 分镜	一张完整的分镜图	一次请求即可将分镜顺序转化为连续视频
由人物、产品、场景或风格素材控制的片段	R2V 素材参考	一组精简、按角色划分的素材	根据这些参考生成一个片段
有精确起始和结束状态的镜头	I2V 镜头对	起始和结束关键帧	一个可独立审核的镜头
时长超过支持范围且动作不中断的内容	延长 / 串接	前一个生成片段的尾帧和下一个提示词	同一镜头的延续
包含多个事件的连续作品	分阶段完整短片	文本和可选参考	一次请求覆盖按顺序排列的多个阶段，每个阶段都落在指定的结束状态
对现有视频进行范围明确的修改	编辑	源视频和目标参考	仅更改源视频中指定的区域或元素
两段已完成片段之间的桥接	无缝转场	两段视频	在两者之间生成桥接内容
从 3D 预览中获取运动、调度和运镜	阻挡参考	粗略或精细的阻挡视频和外观参考	按照阻挡视频的时间安排和场面调度进行最终渲染

默认使用 Seedance 2.0 作为可执行版本。只有在所选提供方支持该模型且明确其实际限制时，才提供 Seedance 2.5 完整短片路线。

最后四种路线所依赖的功能因模型和提供方而异。提供选项前请确认是否可用；2.0/2.5 的对比，以及哪些已发布功能属于平台功能而非 API 参数，请参阅功能。

分镜图还是单独关键帧

• 只要单独的分镜面板仍清晰可读，默认就应在一次 R2V 请求中使用整张分镜图。不要先裁剪。Seedance 可以将有序面板解读为一个连续的多镜头视频。
• 只有当独立重拍或精确的起始/结束状态比一次 R2V 生成的转场质量更重要时，才使用 I2V 镜头对。
• 不要默认将分镜的每个单元格都作为 R2V 素材包上传。只有在每张 R2V 图像都有不同作用时，才使用多张图像，例如人物、产品、环境、风格或动作参考。

2. 仅启用所需的准备工作

主体简述

仅当人物、产品、道具、手、车辆或场景需要重复出现时才使用。记录 3–5 个不变特征：轮廓或比例、标志性材质或服饰、关键颜色，以及任何必须保留的标记。一次性氛围镜头无需使用。

对于重复出现的人物，准备一张清晰的面部特写和一张单独的全身参考图。不要使用正面/侧面/背面合成图作为身份输入；它可能会被解读为多个人。若物体本身需要从多个侧面展示，多角度产品参考仍然有用。

关键帧

为每个 I2V 镜头创建一个起始关键帧。仅当镜头必须以特定动作、构图、产品姿态或手部位置结束时，才添加结束关键帧。每个关键帧只使用一个干净的场景。

故事板

直接使用现有故事板作为 R2V 参考。Seedance 通常能理解分镜顺序，无需提前移除分镜编号、分隔线、箭头或注释。只有在测试生成确实渲染出了不需要的分隔线、编号、字幕或多面板布局后，才制作一份干净的副本。

如果多镜头请求没有故事板，请使用提示词模板中的 Seedream 模板创建一份故事板。 **在宿主 UI 中展示故事板，亲自检查，然后在确认通过后继续使用 Seedance R2V。**展示故事板是进度更新，不是要求用户批准。

对于用户提供的故事板，除非它已在对话中显示，否则都要展示。检查规划顺序、关键情节是否清晰易读、反复出现的主体是否一致，以及解剖结构、产品形态或关键文字等特定内容限制。明显不合格的故事板应在视频生成前修正。只有在无法推断创意选择时才询问用户。

如果流程有意切换为 I2V 镜头对，则只在那时裁剪分镜面板。先检查布局：自动裁剪可以验证位置，但无法验证图像模型是否绘制了预期的分镜布局。

3. 设计连续性与剪辑

首尾帧控制的是一个镜头，并不意味着每个镜头都必须承接上一段片段的结尾。

转场	将上一镜头的结尾用作下一镜头的开头？	设计规则
一个不间断的动作	是	按顺序生成并检查衔接处
硬切到新的角度、地点、产品或时间	否	独立设计每个镜头
匹配剪辑	通常不	匹配运动方向、形状、颜色或构图
遮挡或甩镜转场	否	以遮挡动作结束；下一镜头从遮挡过程中或之后开始
插入镜头或补充镜头	否	用物体、环境或产品细节作为衔接

在故事板和提示词中写明重要的剪辑点、匹配关系和遮挡。不要指望用交叉溶解来修补互不相关的镜头。

4. 编写视频提示词

范围：将每条指令放在适用的位置

编写区块前，先按指令所约束的内容对已知信息进行分类。放错位置的指令最容易导致偏移——写在节拍 1 中的全局规则，到节拍 4 时就不再生效。

范围	约束内容	内容
全局	整个作品	影片类型、场景、风格、一句话梗概、摄影机原则
锁定项	任何不得偏移的内容	身份、参考图的用途、音频来源、连续性、负面约束
时间	一个节拍或阶段	阶段事件及其结束状态

在提示词的实际末尾重申最重要的两到三项锁定内容；越靠后越容易起作用。这是一种位置约定，并非第四种范围——这些内容仍属于锁定项，且应先在锁定项中出现。

这与Universal Video Prompt Skill中的模型无关规范格式一致。一份简报需要在多个模型上运行时使用该技能；Seedance 专属写作则使用本文档。这是完整 Seedance 2.5 Skill 配置所需的配套内容。如果链接无法解析，请先协助用户安装 universal-video-prompt-skill，再继续；不要臆造缺失的共享规范。

区块

只使用会影响镜头的区块：

[subject/reference binding]
+ [one observable action]
+ [space and important object relationships]
+ [one primary camera move, coherent composite move, or a cut]
+ [light/style when it matters]
+ [audio or dialogue when enabled]
+ [end state, for any stage that must land somewhere specific]
+ [must-preserve constraints]

用结束状态承载多事件内容

对于包含多个事件的内容，要说明每个阶段结束时肉眼可见的状态。这是为多阶段提示词增添价值最高的一项内容：它能将“保持一致”转化为模型可以瞄准、你也可以检查的目标。

weak:   the two of them keep working on the bouquet
strong: end state: the florist holds the bouquet in the left hand;
        the scissors are back on the right side of the bench

结束状态必须可见。“她感到如释重负”不算；“她垂下肩膀，眉头舒展开来”才算。完整了解分阶段结构，请阅读长视频。

时间粒度：编写节拍前先确定

粒度是一项前置决策。先按秒级精度编写节拍再降低精度，意味着必须重写。

粒度	适用情况
无——仅事件顺序	一个连续动作、氛围片段、单个镜头。添加时间戳会割裂镜头
阶段 + 结束状态	大多数叙事类工作。默认选项
秒级	仅限外部硬性约束：音乐、唇形同步、参考素材交接，或必须在固定时间出现的节拍

如果输入已明确，就据此判断——提供了音乐或旁白音轨，意味着采用秒级；明确说明是氛围片段，意味着不设时间戳；明确指定固定节拍，意味着采用秒级。对于没有外部约束的多事件叙事，应询问并说明推荐选项及理由，而不是只列出选项让用户选择。

时间戳用于分配时间预算；它们不是帧级精准的剪辑点，动作可能略早于或晚于边界发生。不要要求不可能达到的密度，例如在一秒内安排三个不同动作。

• 明确标注参考素材的用途，例如 Image 1: 人物、Image 2: 产品、Image 3: 厨房场景。
• 对于多镜头 R2V，按事件顺序列出 Shot 1、Shot 2 和 Shot 3。在提供方控件中设置时长，而不是在文本中强行规定精确秒数。
• 每个镜头优先采用一个主要运动。当组合运动的方向、与主体的关系及速度表达一种同步意图时，便可采用组合运动。
• 启用原生音频时，音乐使用 （），音效使用 <>，对白使用 {}，屏幕字幕使用 【】。
• 只说明返工成本高的约束。

根据任务阅读相应参考资料：

文件	阅读用途
提示词模板	针对不同路线的模板
提示词模块	可复用的摄影机、音频和约束模式
长视频	分阶段结构、结束状态、时间戳规则
多参考素材	绑定多个素材，避免混淆
真人	可信的人物主体，以及何时省略相关细节
转场	应生成哪些转场，哪些应通过剪辑处理
剪辑与续写	修改或续写现有视频
能力	2.0 与 2.5 的限制；平台功能与 API 参数的区别
模型特征	各模型经实测的行为与编译说明
电影摄影	详细的视觉决策
故障排查	针对具体故障的修复方法
执行适配器	运行器和适配器配置

5. 生成、审阅并完成

1. 对于生成的分镜板，先只生成静帧，在对话中展示并检查，然后再请求生成视频。
2. 对于用户提供的分镜板，除非它已显示在对话中，否则先展示输入，再确认它符合选定路线。
3. 如果分镜板通过审阅，无需等待批准，直接生成一版有代表性的视频。否则先完善或重新生成分镜板。
4. 按顺序检查身份、锁定项、阶段结束状态、构图、运动、接缝和音频；遇到首个失败项就停止——如果身份不对，之后的检查都是徒劳。只重新生成失败的镜头或片段。
5. 按顺序生成串接片段，因为下一个片段需要使用前一片段的实际尾帧。基于剪切的片段则应独立生成，并通过剪辑完成规划好的转场。

附带脚本用于组装草稿，并非调色或混音系统。

Atlas 执行层

将创意路线选择与任务提交方式分开。默认模型为静态图像使用 Seedream 5.0 Pro，视频使用 Seedance 2.0；用户只有在确认路线支持后，才能覆盖这些默认设置。

在 Agent 对话中，默认使用 Atlas Cloud Skill 作为直接生成路线。它可以发现模型、上传本地媒体、提交图像或视频请求、轮询并获取输出。只有在实际提交了生成任务时，才报告 Execution: atlas-skill。

仅当用户明确选择 MCP，且其生成工具已开放时，才使用 atlas-mcp。仅当用户明确选择终端、脚本、CI 或批量运行时，才使用 atlas-cli。如果缺少 Atlas Cloud Skill，请先帮助安装 AtlasCloudAI/atlas-cloud-skills，再选择备用方案。

在报告缺少 Atlas Cloud API 密钥之前，请检查所选执行进程中的凭据。对于 REST runner，先检查 ATLASCLOUD_API_KEY，再检查兼容别名 ATLAS_CLOUD_API_KEY。不要根据其他提供商、插件或进程推断凭据是否可用；每个执行渠道的凭据范围都可能彼此独立。

如果两个密钥都不存在，请引导用户前往 https://www.atlascloud.ai/console/api-keys?utm_source=github&utm_campaign=awesome-seedance-2.5-prompts-skills。 绝不要让他们在聊天中粘贴密钥。请告知他们在提交任务的进程或主机的安全环境设置中设置 ATLASCLOUD_API_KEY，然后根据需要刷新或重启执行会话。如果密钥存在于父级或主机配置中，但提交任务的进程中缺少该密钥，请报告环境范围不匹配，而不要说用户没有密钥。

计费任务状态机

对每次图像和视频生成都应用以下规则：

1. 提交后，立即记录预测 ID 和逻辑阶段。
2. 将 starting、queued、pending 和 processing 视为进行中状态。每隔 2 秒轮询同一个 ID；不要为该阶段提交另一个任务。
3. 将 completed 和 succeeded 视为成功终态。下载并检查输出，然后再开始依赖此结果的阶段。
4. 将 failed、timeout 和 canceled 视为失败终态。只有明确决定重试后才能创建新任务；先报告旧 ID 和可能产生的额外费用。
5. 处理时间字段为零或缺失、输出延迟、本地轮询超时、轮次停止或临时状态查询错误，都不能证明任务失败。保留 ID 并恢复轮询。
6. 将 continue 解读为“恢复现有任务”，绝不能将其视为允许重试。在所需的分镜仍在进行中时，不要提交视频。

此工作流中所有 Atlas 执行路径的轮询间隔均为 2 秒。对于 atlas-skill，使用相同 ID 重复执行其预测结果步骤。对于 atlas-mcp，每隔 2 秒使用相同 ID 调用 atlas_get_prediction。MCP 服务每次工具调用只执行一次状态查询；循环由 Agent 负责。捆绑的 REST 和 CLI 适配器会在代码中强制执行此间隔。状态查询为只读操作，绝不能用另一次生成调用替代。

需要运行器恢复时，将 execution.resumePredictionIds.<stage> 设为现有 ID。支持的阶段键包括 grid、ref1、ref2、seg1、shot1 和 clip1。不要仅仅因为先前的轮询进程已结束就创建替代任务。

scripts/generate.mjs 无法调用 Agent Skill 或 MCP 服务。它是一个独立的批处理运行器：默认使用 atlas-rest，只有在 execution.adapter 中明确设置后才会使用 atlas-cli。它绝不会自动选择 CLI。请参阅执行适配器。

# Generate a storyboard only. The runner prints [storyboard-preview] with an
# absolute path; display and inspect that image before starting video work.
GRID_ONLY=1 node scripts/generate.mjs scripts/myjob.json

# Run only the first independent clip or segment as a quality gate.
CLIPS_MAX=1 node scripts/generate.mjs scripts/myjob.json
SEGS_MAX=1 node scripts/generate.mjs scripts/myjob.json

{ "execution": { "adapter": "atlas-cli" } }

可用的运行器模式：

• grid：裁剪模型分镜，并为每个面板制作一个独立的 I2V 片段；适用于硬切蒙太奇。
• shot-pairs：根据 segments[] 制作独立的 I2V 镜头，并使用 first 和可选的 last 关键帧索引。
• reference：发送一组较小的、按角色指定的 R2V 参考图。参考图可以根据提示词生成，也可以从本地文件读取。
• chain：将生成的尾帧作为下一段的输入，延续同一个动作。这有助于保持连贯，但不能保证衔接处毫无痕迹。

针对特定故障的解决方法，请阅读故障排查。