1实现原理 · 为什么它能做到
i2v 意图路由:常规动画(肖像/产品)默认 HappyHorse 1.0 I2V,自定义配音口型同步走 Wan 2.7 t2v+audio_url,多模态合成走 Seedance 2.0 Pro;agent 按意图表分类后落到对应小节。
| Animate a portrait — keep identity stable | **HappyHorse 1.0 I2V** | #1 on Artificial Analysis Arena (Elo 1392); strong facial fidelity |
诚实标注端点易错点:Wan 2.7 在此目录下没有独立 i2v 端点,口型同步实际复用 t2v 端点 + audio_url,文档显式声明以免 agent 想当然调 /image-to-video。
**Model**: `wan-ai/wan-2-7/text-to-video` (NOT `/image-to-video` — Wan 2.7's t2v endpoint accepts an `audio_url` that drives lip-sync)
多模态合成的引用协议:Seedance 2.0 Pro 接受 0–9 张图、0–3 段参考视频、0–3 段参考音频的数组,提示词以『image 1 / video 1 / audio 1』编号把各模态 cue 路由给模型。
- **Number the refs** in the prompt: `"subject from image 1, lighting from video 1, voice from audio 1"`. Seedance routes cues correctly.
动效提示词语法:动作动词前置、不复述图像内容、单 clip 单一主运动,把『让静态图动起来』的写法约束成模板。
- **Lead with motion verbs**: "drift", "dolly in", "orbit", "tilt up", "reveal", "blink", "breathe". Front-load what's MOVING.
执行委托 runcomfy CLI + 云端推理:三选一后以匹配 JSON body 调 `runcomfy run <model_id>`,CLI 负责提交、轮询与下载产物。
The skill picks one of HappyHorse 1.0 I2V / Wan 2.7 t2v+audio / Seedance 2.0 Pro based on user intent and invokes `runcomfy run <model_id>` with the matching JSON body.
2核心能力
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | runcomfy(@runcomfy/cli 官方 CLI) |
| package | @runcomfy/cli(npm 全局安装) |
| network | RunComfy Model API(请求提交) |
| network | 生成结果下载白名单 |
| network | 云端模型路由(经 CLI/Model API 访问):happyhorse/happyhorse-1-0/image-to-video、wan-ai/wan-2-7/text-to-video、bytedance/seedance-v2/pro |
| network | RunComfy 模型页 / 文档站(引用链接) |
| network | 用户提供的源图/参考视频/参考音频 URL——由 RunComfy 模型服务器抓取 |
4风险提醒 风险提醒:橙色 · 评估后使用
- 源图/参考音频/配音轨与提示词上送第三方云,肖像与语音数据外发是功能必然 — HappyHorse 原生合成音频、Wan 上传 voiceover MP3——配音素材属敏感语音数据,使用者须自评合规。
- 执行面与供应链仓外(官方 CLI、Model API、npm 包、npx 安装器) — 文档对 CLI 的转述(不 shell 展开、token 0600、2 GiB 上限)无法在本仓库证实。
- 参考媒体 URL 由服务器抓取,音视频内容可作为注入载体 — 文档自认图像注入风险,音频/视频参考的注入面同理会存在但未被文档点名。
- Arena 排名与 Elo 分数为站外营销宣称,无仓内证据且易过期 — 『#1』『Elo 1392』随时间与榜单方法变化会失真,不应作为长期选型依据。
5第二遍独立确认
- [ok] 三个 i2v 模型 ID 与路由表、调用示例一致 — happyhorse/happyhorse-1-0/image-to-video、wan-ai/wan-2-7/text-to-video(非 image-to-video)、bytedance/seedance-v2/pro 三处出现位置均成对自洽。
- [unlocatable] HappyHorse『Arena #1 (Elo 1392)』宣称 — 路由表 Why 列与 Route 1 标题('Arena rank: #1 (Elo 1392)')均引用站外 Artificial Analysis 排名,pin 内无任何数据支撑;无法复核其时效与真伪,标记待补。
- [ok] Wan 2.7 走 t2v 端点做口型同步的端点异例 — Route 2 明确 'NOT /image-to-video',与 description 的 '(or endpoint variant)' 措辞呼应;无自相矛盾。
- [ok] 限制声明一致性(Seedance 720p ceiling、时长上限、音频 2–15s/<15MB) — Limitations 节与三处 schema 表(duration/resolution/audio 规格)数字一致。
- [unlocatable] SKILL.md 对 CLI 行为的断言(无 shell 展开、token 0600、2 GiB 上限) — CLI 源码不在本仓库,仅文档自述,无法独立证实。
- [discrepancy] 身份/安装链接一致性 — SKILL.md 安装与 GitHub 链接指向 agentspace-so/runcomfy-skills,镜像 README 指向 agentspace-so/runcomfy-agent-skills,被 pin 仓库为 prime-skills/runcomfy-agent-skills——三处来源标识不一致(发布身份漂移,非代码缺陷)。
6结论
72d420bb6e15ce52…fca19ae084