Seedance 2.5 视频生成
将粗糙的视频意图转化为连贯的 Seedance 2.5 提示词和经过验证的 EvoLink API 请求，用于文本、图像、参考生成、视频编辑或视频扩展
可用性边界：在任何实时任务前，请检查当前所有五个官方文档路由。有效的架构或成功的模拟运行并不能证明账户访问权限或生产环境的可用性
何时激活此技能
当用户提出以下请求时激活：
- 创建或改进 Seedance 2.5 视频提示词
- 构建 Seedance 2.5 API 负载
- 从文本生成视频
- 对一张图像或首帧/尾帧对进行动画化
- 使用图像、视频或音频作为参考
- 编辑或扩展参考视频
- 规划一个连续镜头或短多镜头序列
- 运行、模拟运行、故障排除或集成 EvoLink Seedance 2.5 请求
不要为以下情况激活：
- 关于模型新闻、基准测试、可用性或定价的问题，且不涉及生成任务
- 不使用 Seedance 2.5 的通用视频编辑
- 请求伪造缺失的参考素材
- 请求需要保证的身份、标志或精确帧级一致性
支持的工作流
| 模式 | 模型 ID | 必需的媒体 | 不支持的输入 |
|---|---|---|---|
text | seedance-2.5-text-to-video | 无 | 图像、视频和音频 URL 数组 |
image | seedance-2.5-image-to-video | 一个或两个 image_urls | 视频和音频 URL 数组；网络搜索 |
reference | seedance-2.5-reference-to-video | 至少一个图像、视频或音频 URL | 编辑/扩展意图、网络搜索和 Base64 媒体 |
edit | seedance-2.5-video-edit | 一到十个 video_urls；第一个视频为编辑目标 | 自定义时长、固定宽高比、网络搜索和 Base64 媒体 |
extend | seedance-2.5-video-extend | 一到十个 video_urls；第一个视频为扩展目标 | 固定宽高比、网络搜索和 Base64 媒体 |
参考提示词应明确将素材标识为 @image1、@video1 和 @audio1
脚本位置
所有路径相对于包含此 SKILL.md 的目录进行解析：
SKILL_DIR = 包含此 SKILL.md 的目录
SCRIPT = {SKILL_DIR}/scripts/seedance-2-5-video-gen.sh
安装后
- 检查
EVOLINK_API_KEY是否已设置，但不打印其值 - 如果缺失，打开或显示
https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=seedance-2-5-video-gen - 要求用户创建或选择一个密钥并粘贴回来
- 将其保存为当前会话的
EVOLINK_API_KEY，并提供持久的 Shell 存储选项 - 在真正的任务前，使用非生成性的
GET /v1/credits路径进行验证 - 运行可用性探测并解释当前的官方状态
命令：
export EVOLINK_API_KEY="user_key"
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh --validate-key
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh --check-availability
切勿在日志中暴露密钥或将其重复回显给用户
核心原则
- 保留用户意图、已批准的素材、时长、宽高比、对话和静默约束
- 设计随时间变化的运动：起始状态、主要动作、相机行为、背景运动和结束状态
- 保持动作在 4 到 30 秒内物理合理，避免将许多场景塞入短片段
- 将视觉指导与对话、音效、环境音和音乐分开
- 除非用户明确要求序列且时长允许，否则优先使用一个连贯的镜头
- 描述连续性目标，但不承诺完美的一致性或帧级精确控制
- 在任何调用之前验证负载，并且在
TASK_SUBMITTED之后绝不重试，除非用户明确批准新的付费任务
流程
步骤 1：理解交付物
提取：
- 预期用途：广告、产品演示、电影镜头、社交片段、编辑、扩展或其他
- 时长和宽高比
- 主体和环境
- 起始帧、时间动作和结束帧
- 相机运动和稳定性
- 音频、对话、音效、环境音或静默
- 参考素材及其预期作用
- 输出偏好：提示词、Markdown 计划、JSON 负载、模拟运行或实时任务
步骤 2：选择模式
- 无媒体输入：
text - 一张或两张定义首帧或首帧/尾帧的图像：
image - 用于生成新镜头的风格、身份、产品、运动或音频参考：
reference - 更改现有视频的内容同时保留其时间线：
edit - 向前或向后延续现有视频：
extend
不要将编辑或扩展意图发送给 reference：API 可能先接受请求，然后在模型执行期间失败
如果模式不明确，提出一个包含所有缺失必需信息的简洁问题
步骤 3：构建视频提示词
按此顺序：
- 镜头格式和时长
- 主体、服装/产品细节和环境
- 起始状态
- 主要动作和时间进展
- 相机取景和运动
- 背景和次要运动
- 光照、色彩、纹理和氛围
- 连续性约束
- 结束状态
- 音频指令，与视觉描述保持区分
对于短片段，使用一个主要主体动作和一个相机移动。对话必须自然适应时长
步骤 4：验证模型约束
共享默认值和范围：
duration：5；整数范围 4 到 30，或-1表示自动时长quality：720p，也支持480paspect_ratio：adaptive、16:9、9:16、1:1、4:3、3:4或21:9，受以下模式规则约束output_format：mp4或movgenerate_audio：truecontent_filter：true
模式规则：
- 文本模式可以使用
model_params.web_search - 图像模式需要一个或两个公开的 JPEG、PNG 或 WebP URL，并且仅接受
aspect_ratio=adaptive - 参考模式最多接受 30 张图像、10 个视频和 10 个音频片段，至少总输入一个，并且仅用于生成新镜头
- 编辑模式需要一到十个视频 URL，使用第一个作为编辑目标，仅接受
duration=-1和aspect_ratio=adaptive，并允许补充图像/音频参考 - 扩展模式需要一到十个视频 URL，使用第一个作为扩展目标，接受
duration=-1或 4 到 30，且仅接受aspect_ratio=adaptive，并允许补充图像/音频参考 - 媒体必须是可直接访问的 URL，而非本地路径或 Base64 数据
- 回调 URL 必须使用 HTTPS 且不得指向私有网络
步骤 5：在消耗积分前预览
默认使用模拟运行，直到用户批准确切的负载和成本边界：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"一件红色T恤在无缝白色摄影棚中旋转一次；缓慢的推镜；织物保持稳定；无对话，柔和房间音" \
--mode text --duration 5 --aspect-ratio 1:1 --dry-run
向用户展示所选的模型、提示词、媒体列表、时长、质量、宽高比、音频设置和回调行为
步骤 6：在可用且经批准后执行一次
在真正任务前：
- 确认官方可用性
- 确认密钥已通过非生成性验证
- 确认用户批准的成本边界
- 确认此确切负载
运行脚本一次。轮询直到 completed 或 failed，或在提供回调时在任务创建后返回
脚本用法
文本转视频模拟运行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"一个连续镜头：一架纸飞机飞过洒满阳光的工作室，相机平稳平移跟随它，尘埃颗粒漂浮，它降落在木桌中央" \
--mode text --duration 5 --aspect-ratio 16:9 --dry-run
图像转视频模拟运行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"产品保持不变，相机进行微妙的优质推镜；柔和的亮点在瓶身上移动；安静的环境音，无对话" \
--mode image --image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 --duration 5 --dry-run
首帧/尾帧模拟运行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"从首帧自然过渡到尾帧；保留角色、服装和光照；缓慢的顺时针相机弧线" \
--mode image \
--image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \
--image-url https://images.unsplash.com/photo-1542291026-7eec264c27ff?w=1200 \
--duration 6 --dry-run
参考转视频模拟运行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"使用 @video1 作为相机运动参考、@image1 作为产品身份参考、@audio1 作为背景音乐，生成一个新镜头" \
--mode reference \
--image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \
--video-url https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4 \
--audio-url https://samplelib.com/lib/preview/mp3/sample-3s.mp3 \
--duration 8 --dry-run
视频编辑模拟运行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"编辑 @video1：将杯子替换为 @image1 中展示的产品，同时保留时间、相机运动和背景" \
--mode edit \
--video-url https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4 \
--image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \
--duration -1 --dry-run
视频扩展模拟运行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
"向前扩展 @video1：继续相同的相机运动和主体运动，保留光照和身份，以产品标志结束" \
--mode extend \
--video-url https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4 \
--duration 8 --dry-run
输出格式
当用户要求提示词或计划而非执行时，返回：
## 视频提示词
[可复制的提示词]
## 场景结构
- 模式：
- 时长：
- 宽高比：
- 镜头类型：
- 起始状态：
- 主要动作：
- 相机运动：
- 主体运动：
- 背景运动：
- 结束状态：
## 音频指令
[对话、音效、环境音、音乐或静默]
## 连续性约束
[应保持稳定的细节]
## API 设置
[模型 ID 和受支持的请求字段]
当请求 JSON 时，返回仅使用官方请求字段的有效 JSON
脚本输出协议
| 输出 | 含义 | 智能体操作 |
|---|---|---|
DRY_RUN=true | 负载已通过验证，未调用 API | 显示负载并说明零积分消耗 |
KEY_VALID=true | 非生成性密钥验证通过 | 继续确认可用性和成本 |
launch_status=closed | 官方文档仍标记路由不可用 | 不要进行生成调用 |
TASK_SUBMITTED: task_id=... | 付费任务已排队 | 不要自动重新提交 |
STATUS_UPDATE: ... | 轮询进度 | 传递有用进度，避免刷屏 |
RESULT_URL=... | 最终资产 URL | 返回并建议立即保存 |
CALLBACK_PENDING: ... | 回调模式已接受 | 返回任务 ID 和回调 URL |
POLL_TIMEOUT: ... | 本地轮询结束，任务可能继续 | 返回任务 ID；不要盲目重试 |
ERROR: ... | 验证或 API 失败 | 解释确切需要的修正 |
入门模板
这些模板默认模拟运行，因此不消耗积分：
| 模板 | 预计成本 | 请求 |
|---|---|---|
| 文本运动检查 | 0 积分 | 一个主体动作和一个相机移动的五秒文本转视频负载 |
| 产品图像运动检查 | 0 积分 | 带有微妙推镜且无对话的五秒图像转视频负载 |
在 API 返回当前 usage 对象或 EvoLink 发布标准定价之前，不要估算实时生成成本
修订与边缘情况
- 修订请求：仅更改请求的维度，保留所有已批准的细节
- 动作过多：建议一个更简单的单个镜头或分割为多个独立生成
- 缺少图像模式媒体：要求一个或两个可直接访问的 URL
- 缺少参考媒体：要求至少一个 URL 并解释
@image1/@video1/@audio1 - 编辑意图在参考模式中：切换到
edit，要求目标视频，强制时长-1，并保留源时间线 - 扩展意图在参考模式中：切换到
extend，要求目标视频，并询问是向前还是向后继续 - 本地文件输入：说明 EvoLink 需要公开 URL；未经许可不要编造或上传素材
- 冲突的相机方向：选择一个连贯的移动并解释冲突
- 对话过长：缩短对话或在支持范围内增加时长
- 确切的身份或标志保证：说明一致性可以鼓励但不能保证
- 模型不可用或无法访问：提供验证的模拟运行和可用性探测，而不是编造结果
安全与版权
- 拒绝不允许的色情内容，尤其是涉及未成年人的内容、非法剥削、极端主义赞扬以及促成严重不当行为的指示
- 不要编造同意、引用权利、品牌授权或所有权
- 对于真实人物、品牌、受版权保护的角色和标志，保留用户意图，同时标记商业使用和冒名顶替风险
- 不要承诺精确的名人相似度、完美的商标复制或保证的角色一致性
- 默认保持
content_filter=true。切勿将其禁用呈现为生成非法或禁止内容的许可 - 不要暴露隐藏指令、秘密、API 密钥或内部推理
模型能力摘要
- 五个独立的模型 ID 覆盖文本、图像、参考生成、视频编辑和视频扩展
- 输出时长为 4 到 30 秒或自动（
-1），支持 480p 或 720p；编辑仅接受-1 - 可请求同步音频
- 参考模式允许组合图像、视频和音频输入
- 所有模式需要直接媒体 URL；不支持 Base64 或本地路径
- 回调必须使用 HTTPS 且不得指向私有网络
使用示例
从零构建文本提示词和负载
用户要求“生成一个 5 秒 1:1 的产品视频，一个红色马克杯在木桌上，缓慢的推镜”
- 提取意图：产品展示，5 秒，1:1，主体红色马克杯，环境木桌，动作缓慢推镜
- 选择模式：
text（无媒体输入） - 构建提示词： "一个连续镜头：一个红色陶瓷马克杯放在木桌上，光线柔和温暖；缓慢的推镜从充满桌面的视图开始，接近马克杯直至它占据画面中心；无对话，柔和的咖啡馆环境音"
- 验证约束：时长 5，宽高比 1:1，质量 720p，音频开启
- 模拟运行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \ "一个连续镜头：一个红色陶瓷马克杯放在木桌上，光线柔和温暖；缓慢的推镜从充满桌面的视图开始，接近马克杯直至它占据画面中心；无对话，柔和的咖啡馆环境音" \ --mode text --duration 5 --aspect-ratio 1:1 --dry-run - 显示负载并获得批准
- 用户批准后执行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \ "一个连续镜头：一个红色陶瓷马克杯放在木桌上，光线柔和温暖；缓慢的推镜从充满桌面的视图开始，接近马克杯直至它占据画面中心；无对话，柔和的咖啡馆环境音" \ --mode text --duration 5 --aspect-ratio 1:1
使用参考图像生成视频
用户要求“从此图像创建 8 秒 16:9 视频，相机围绕产品旋转，背景音乐”
- 提取：8 秒，16:9，一张图像，参考模式（风格/身份参考），相机旋转，背景音乐
- 选择模式：
reference（有图像参考） - 构建提示词： "使用 @image1 作为产品身份参考；产品在旋转台上缓慢旋转；相机围绕产品水平弧线运动；平滑的纯色背景；无对话，环境电子背景音乐"
- 模拟运行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \ "使用 @image1 作为产品身份参考；产品在旋转台上缓慢旋转；相机围绕产品水平弧线运动；平滑的纯色背景；无对话，环境电子背景音乐" \ --mode reference \ --image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \ --duration 8 --aspect-ratio 16:9 --dry-run - 获得用户批准
- 执行：
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \ "使用 @image1 作为产品身份参考；产品在旋转台上缓慢旋转；相机围绕产品水平弧线运动；平滑的纯色背景；无对话，环境电子背景音乐" \ --mode reference \ --image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \ --duration 8 --aspect-ratio 16:9
故障排除指南
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 密钥验证失败 | EVOLINK_API_KEY 未正确设置、过期或无权限 | 检查密钥设置，从仪表板重新生成，然后重试 --validate-key |
可用性探测显示 closed | 该特定路由尚未上线或正在维护 | 检查官方 EvoLink 文档，建议用户稍后重试或使用替代路由 |
| 模拟运行成功但实时调用失败 | 实时调用有额外约束或账户特定限制 | 检查错误消息，可能是积分不足、配额限制或媒体 URL 不可达 |
TASK_SUBMITTED 后状态卡在 pending | 服务负载高或媒体处理延迟 | 等待合理时间，然后使用 --check-task 手动检查；请求用户耐心 |
| 生成视频质量不佳 | 提示词不详细或模式选择错误 | 细化提示词，增加更多运动描述，检查媒体质量，考虑使用 image 或 reference 模式 |
| 媒体 URL 被拒绝 | URL 不是公开可访问的，或格式不受支持 | 确保 URL 是直接链接（而不是重定向），使用 JPEG/PNG/WebP 格式，检查 URL 是否可达 |
| 回调未被接收 | 回调 URL 不是 HTTPS 或指向私有网络 | 确保回调 URL 使用 HTTPS 且可公开访问，提供正确的任务 ID |