跳到主要内容
AI教程

用 Claude Skill 和 Seedance 2.5 打造 AI 角色换人视频

本教程将介绍 AI 角色换人爆款项目的工作方式，带你安装 ffmpeg、配置 Seedance 2.5 API、添加 Claude Skill，并完成角色档案、视频检查、自动换人、对比视频和发布文案生成。

AI我搜编辑部阅读约 8 分钟
用 Claude Skill 和 Seedance 2.5 打造 AI 角色换人视频

项目简介

“AI 角色换人爆款”是一个面向 Claude 的 Skill，目标是把已经流行的视频中的人物替换成你设计的原创 AI 角色，同时尽量保留原视频的动作和节奏。

项目不仅负责调用 Seedance 2.5 完成视频换人，还覆盖角色设计、设定图提示词、角色档案管理、源视频检查、对比视频制作，以及 TikTok、Instagram 和推特发布文案生成等环节。

示例角色“闻先生”将明朝书生的脑袋与打工人的身体结合起来：巨大发髻横插玉簪，穿大一号西装，搭配白袜和拖鞋。示例中，原视频人物被替换，动作保持不变。

核心功能

  • 设计原创角色：根据“夸张长在人身上，而不是穿在身上”的原则，生成角色方案和设定图提示词。
  • 保存角色档案：将设定图、正脸照和外貌描述保存起来，后续换人时重复使用，减少角色形象漂移。
  • 检查源视频：自动报告视频分辨率和时长，像素不足时自动放大，并生成预览图。
  • 生成换人提示词：支持单人或多人替换，并通过 @图片 编号对齐相关素材。
  • 调用 Seedance 2.5：通过 BytePlus ModelArk 或火山方舟 API 自动提交任务、轮询状态并下载结果。
  • 制作对比视频：将原视频和换人后的视频左右排列，添加标签并避免黑边。
  • 准备发布内容：生成 TikTok、Instagram 字幕建议，以及适合推特教程串推的文案。

项目文件结构

项目的主要文件和目录如下：

  • skills/ai-character-swap/SKILL.md：给 Claude 使用的 Skill 本体。
  • skills/ai-character-swap/scripts/seedance_swap.py：配套 Python 脚本，只依赖 Python 3 和 ffmpeg。
  • 新手说明.md：面向不熟悉命令行用户的说明，包含使用网页版完成流程的方法。
  • examples/：项目示例对比视频目录。

准备工作

安装 ffmpeg

项目脚本需要使用 ffmpeg 处理视频。macOS 用户可以通过 Homebrew 安装：

brew install ffmpeg

Windows 用户可以使用 winget 安装：

winget install ffmpeg

脚本本身只依赖 Python 3 和 ffmpeg。安装完成后，建议确认这两个命令能够在终端中正常运行。

开通 Seedance 2.5 API

如果希望让 Claude 自动提交换人任务并下载视频，需要开通 Seedance 2.5 API，并创建 API Key。项目使用环境变量 ARK_API_KEY 读取密钥：

export ARK_API_KEY="你的_API_Key"

在 Windows 环境中，请按照系统使用的终端设置对应的环境变量。不要把真实 API Key 直接写入公开代码或发布到仓库中。

方式一：交给 Claude 自动运行

  1. 安装 ffmpeg，并准备好 Python 3 环境。
  2. 开通 Seedance 2.5 API，创建 API Key，并设置 ARK_API_KEY。
  3. 将项目中的 skills/ai-character-swap/ 添加为 Claude 的 Skill。
  4. 准备一个原创角色的图片，以及需要替换人物的视频。
  5. 在自己的电脑上把角色图和视频发送给 Claude，并说明要替换的对象。

一个基本的任务描述可以写成：

用“闻先生”换掉视频里的那个人。请先检查视频，使用角色档案中的图片和外貌描述生成换人提示词，完成后制作左右对比视频，并给出发布文案。

Claude 会根据 Skill 中的流程处理角色资料、源视频和 Seedance 任务。若视频中有多个人物，可以明确说明需要替换哪一位，或要求一次替换多个人物。

方式二：不写代码，使用网页版

如果不熟悉命令行或 API，可以阅读项目中的 新手说明，使用其中的“做法一：网页版”。该方法通过 ChatGPT 配合 Seedance 网页版完成角色设计和视频换人，不需要直接运行项目脚本。

网页版方式适合先体验整体流程；需要自动提交、轮询和下载任务时，再使用 Claude Skill 与 Seedance 2.5 API 的组合。

一次完整的制作流程

1. 设计原创角色

先确定角色的核心反差和视觉记忆点。项目强调夸张特征应当成为角色身体和形象的一部分，而不只是简单添加一件服装。完成设计后，生成设定图提示词，并准备角色正脸照。

2. 建立角色档案

将设定图、正脸照和外貌描述整理成角色档案。后续每次换人都引用同一份档案，有助于维持发型、脸部特征、体型和服装等视觉信息的一致性。

3. 检查源视频

把要处理的视频交给 Claude 或配套流程，先获取分辨率和时长信息。如果源视频像素不足，流程会自动放大，并生成预览图，方便确认素材是否适合继续处理。

4. 生成换人提示词

根据角色档案和视频内容生成提示词。素材较多时，使用 @图片 编号让角色图与提示词中的参考图片对应。替换单个人物时要明确目标；替换多人时则需要说明每个角色对应的图片和人物。

5. 调用 Seedance 2.5

API 流程会自动提交任务、轮询生成状态，并在任务完成后下载结果。项目中的 seedance_swap.py 提供了这部分配套能力，具体请求格式依据 BytePlus 官方为 ComfyUI 提供的 Seedance 2.5 接入代码整理。

第一次使用 API 时，建议先使用脚本的 --dry-run 选项检查流程和请求，不要直接从较长视频开始。确认配置无误后，再用一条较短的视频进行实际测试。

6. 制作对比视频

确认换人结果后，生成左右对比视频：左侧保留原视频，右侧放置 AI 换人结果，并添加清晰标签。项目会处理画面布局，目标是让成片不出现黑边，方便直接用于展示效果。

7. 生成发布文案

最后让 Claude 根据成片生成 TikTok 和 Instagram 的字幕建议，或整理成推特教程串推。发布前应检查文案是否准确说明了视频使用了 AI。

进阶使用建议

优先固定角色档案

不要每次换人都重新描述角色。持续使用同一份设定图、正脸照和外貌描述，可以降低不同视频之间的角色不一致问题。

先短视频、后长视频

API 调用部分目前仍建议谨慎试跑。先用 --dry-run 检查请求，再使用短视频验证 API Key、视频参数和下载流程，确认成功后再处理正式素材。

明确人物和图片对应关系

多人视频中，提示词应清楚说明需要替换的人物，并使用 @图片 编号关联正确的角色素材。这样更容易避免角色图与目标人物错配。

注意视频版权与肖像权

项目要求角色必须原创。不要使用明星、网红或身边人的照片制作角色，否则可能触发平台拦截，也可能带来肖像权问题。

发布时开启 AI 标识

在 TikTok 和 Instagram 发布内容时，应按照平台要求标注 AI 生成内容。对比视频和发布文案也应避免让观众误以为素材完全来自真实拍摄。

项目状态与排错方向

视频检查、提示词生成和对比视频制作已经使用示例素材测试通过。API 调用部分的请求格式来自 BytePlus 官方接入代码整理，因此首次使用时应先进行 dry run，再用短视频验证。

如果遇到问题，可以先检查 ffmpeg 是否安装、ARK_API_KEY 是否正确设置、视频是否过长或分辨率是否不足，并查看项目仓库中的说明。确认仍无法解决时，可以向项目提交 Issue。

总结

“AI 角色换人爆款”将角色设计、角色一致性管理、视频检查、Seedance 2.5 API 调用、对比视频制作和发布文案整合到一个 Claude Skill 中。你可以先通过网页版熟悉流程，也可以配置 API 后让 Claude 自动完成从素材检查到成片输出的完整链路。

开始之前，请坚持两个原则：使用原创角色，并在发布时正确标注 AI 内容。这样既能更稳定地复用角色，也能降低版权、肖像权和平台合规风险。