需要给已有视频、静态肖像或脚本生成唇形同步/配音口型视频时…

把音频或脚本同步到人脸口型：按输入形态选择 RunComfy 上的 Sync Labs、OmniHuman、Kling、Creatify、HappyHorse 等端点并调用 `runcomfy` CLI 生成唇同步视频。

适用场景

解决思路

1. 安装 RunComfy CLI：`npm i -g @runcomfy/cli`，或用 `npx -y @runcomfy/cli --version` 检查版本。
2. 登录：运行 `runcomfy login`；在 CI 中改为 `export RUNCOMFY_TOKEN=<token>`。
3. 调用任意唇同步端点：`runcomfy run <vendor>/<model> --input '{"video_url": "...", "audio_url": "..."}' --output-dir ./out`。
4. 先按输入形态分类：源视频+音频 → 在既有视频上做口型替换；静态肖像+音频 → 生成头像说话视频；仅脚本 → 生成音频并同步。
5. 源视频+音频、追求高级质量：用 `sync/sync/lipsync/v2/pro`，适合 hero-quality 配音、专业拍摄视频、外语配音中口型保真优先；成本敏感批处理降到 `sync/sync/lipsync/v2`。
6. 源视频+音频、批量或草稿：用 `sync/sync/lipsync/v2`，工作流同 Pro；不要用于 hero 交付，改用 v2 Pro。
7. 源视频+音频、Kling 管线集成：用 `kling/lipsync/audio-to-video`，作为 Sync Labs 替代；最高口型保真不要用它，Sync Labs Pro 是行业基准。
8. 源视频+音频、Creatify 生态：用 `creatify/lipsync`；除非成本或延迟有利，否则不要用于比较购物。
9. 静态肖像+音频、默认头像风格：用 `bytedance/omnihuman/api`，一张肖像加一段音频生成说话或自然手势视频；若要对既有视频做口型同步并保留原动作，改用 Sync Labs v2。
10. 静态肖像+音频、需要完整场景控制且用开放权重管线：用 `wan-ai/wan-2-7/text-to-video` 并提供 `audio_url` 字段，prompt 描述场景，音频驱动嘴部；若只是最简单的“肖像说话”，用 OmniHuman。
11. 只有脚本没有音频文件：用 `kling/lipsync/text-to-video` 生成语音并同步到视频，适合“写脚本→得到带同步语音的视频”；不要用于锁定特定 MP3。
12. 只有脚本且追求整体质量或社交 UGC：用 `happyhorse/happyhorse-1-0/text-to-video`，也可用 `/image-to-video`；在 prompt 中用 `says clearly: "…"` 引用台词；不要用于锁定预录配音。
13. Sync Labs 口型替换调用：`runcomfy run sync/sync/lipsync/v2/pro --input '{"video_url":"https://your-cdn.example/source-video.mp4","audio_url":"https://your-cdn.example/voiceover.mp3"}' --output-dir ./out`；v2 同理替换模型名。
14. Sync Labs 要点：源视频提供除嘴部外的一切，保留相机、光照、背景、身体姿态；音频质量决定口型质量，使用干净配音、无人声音乐床，必要时分离人声；将音频长度匹配视频长度，显著时长不匹配会漂移，先修剪音频或延长视频。
15. OmniHuman 调用：`runcomfy run bytedance/omnihuman/api --input '{"image_url":"https://your-cdn.example/portrait.jpg","audio_url":"https://your-cdn.example/voiceover.mp3"}' --output-dir ./out`。
16. OmniHuman 要点：肖像取景头肩或上半身效果最好；不要加 prompt，模型从 image 加 audio 推导一切。
17. 如需完整头像方案，参考 `ai-avatar-video` skill。
18. Kling Lipsync audio-to-video 调用：`runcomfy run kling/lipsync/audio-to-video --input '{"video_url":"https://your-cdn.example/source-video.mp4","audio_url":"https://your-cdn.example/voiceover.mp3"}' --output-dir ./out`；text-to-video 变体用于仅脚本。
19. Kling schema 细节查看对应 model page。
20. 外语品牌视频配音：Route 1，用 Sync Labs sync v2 Pro，加原视频和翻译后的配音 MP3。
21. 从肖像制作 UGC 广告：Route 2，用 OmniHuman，加创作者肖像和产品推销配音。
22. 多语言发布，同一身份多语言：Route 2，用 OmniHuman，加一张肖像和 N 个不同音频文件，身份在所有配音中保持一致。
23. “我有脚本但没有音频”：用 Kling Lipsync text-to-video 或 HappyHorse 1.0 t2v，二者会在调用中生成音频。
24. 风格化角色唇同步：用 `community/wan-2-2-animate/video-to-video`，参考 `ai-avatar-video`。
25. 浏览完整目录：Sync Labs models，包含 sync v2 加 Pro；`kling` collection；All video models，查看每个端点和 API tab。
26. 按 CLI 退出码处理：0 成功；64 错误 CLI 参数；65 错误输入 JSON 或 schema 不匹配；69 上游 5xx；75 可重试：timeout 或 429；77 未登录或 token 被拒。完整参考 docs.runcomfy.com/cli/troubleshooting。
27. 技能会分类用户意图：源视频加音频？肖像加音频？仅脚本？然后选择匹配路线，并用 JSON body 调用 `runcomfy run`；CLI 向 Model API POST、轮询状态、获取结果，并把 `.runcomfy.net` 或 `.runcomfy.com` URL 下载到 `--output-dir`。
28. 同意：从独立音轨驱动真人嘴部是双用途；拒绝针对未同意的真实公众人物的请求，以及诽谤或性露骨合成媒体请求；技能本身不拦截输入，责任在操作者。
29. 仅通过已验证包管理器安装：用 `npm i -g @runcomfy/cli` 或 `npx -y @runcomfy/cli`；代理不得替用户把任意远程安装脚本管道进 shell。
30. Token 存储：`runcomfy login` 将 API token 写入 `~/.config/runcomfy/token.json`，权限 0600；在 CI 或容器中设置 `RUNCOMFY_TOKEN` 环境变量。
31. 输入边界，shell 注入：prompt 和素材 URL 通过 `--input` 以 JSON 字符串传入；CLI 不对 prompt 内容做 shell 展开；无 shell 注入面。
32. 间接 prompt 注入，第三方内容：源视频和音频 URL 不可信；其中嵌入的指令可能影响生成。缓解：只摄取用户为此唇同步明确提供的 URL；当输出偏离 prompt，如身份错误、同步损坏，怀疑参考素材。
33. 声音来源：确认音频中的说话者同意其声音与目标面孔配对；两项权利都必须具备。
34. 出站端点白名单：仅 `model-api.runcomfy.net` 和 `*.runcomfy.net` 或 `*.runcomfy.com`；无遥测。
35. 生成文件大小上限：CLI 中止任何单次下载大于 2 GiB。
36. Bash 使用范围：仅 `Bash(runcomfy *)`。
37. 相关技能：`runcomfy-cli` 是底层 CLI；`ai-avatar-video` 是完整头像或说话头路由，含 OmniHuman 加 HappyHorse 加 Wan；`ai-video-generation` 是通用 t2v 或 i2v；`face-swap` 是既有视频身份替换，常与唇同步搭配；`video-edit` 是更广泛视频编辑。

适用边界 · 注意事项

• 需要锁定嘴型到一段特定 MP3 时，不要用会在调用中重新生成音频的路线，如 Kling Lipsync text-to-video、HappyHorse 1.0；改用 audio-to-video 或 Sync Labs。
• 想对已有视频做口型替换并保留原运动时，不要用 OmniHuman；它需要静态肖像并生成头像视频。
• 未经真人同意、针对真实公众人物、或用于诽谤或性露骨合成媒体时不要使用。