1实现原理 · 为什么它能做到
实现方式是「零代码 + 外部 CLI 委托」:seedance-v2/ 只有一份 SKILL.md,无脚本;运行时由宿主 agent 用 Bash 执行 `runcomfy run bytedance/seedance-v2/pro --input '<JSON>' --output-dir <path>`。视频生成与音频合成全部在 RunComfy 云上,skill 只负责把意图翻译成正确的 JSON 与提示词。
The skill invokes `runcomfy run bytedance/seedance-v2/pro` with a JSON body matching the schema.
核心差异化是多模态参考条件:图像 0–9 张、视频 0–3 段、音频 0–3 段可同时喂入,配合 generate_audio 在同一次生成里产出同步语音/音效/配乐——这是家族里唯一『多类型参考 + in-pass 语音』的模型。
| `video_url` | array | no | `[]` | 0–3 clips (MP4/MOV), 2–15s each. |
schema 共 10 个字段,含画幅 7 值(默认 adaptive)、时长 4–15 秒(默认 5)、分辨率 480p/720p(默认 720p)、generate_audio 默认开启、seed。画幅枚举(含 21:9 与 adaptive)与时长下限 4s 都不同于兄弟模型,属模型自身规格。
| `aspect_ratio` | enum | no | `adaptive` | `adaptive`, `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`. |
最重要的操作纪律是「图与文分工」:稳定身份(脸、服装、品牌标、logo)放 image_url,演进叙事(动作、氛围、光、机位)放 prompt;用文字详述脸会浪费 token 并产生漂移。
**Image vs text division.** This is the single most important rule. Stable identity (face, costume, brand mark, logo) → put in `image_url`. Evolving narrative (action, mood, lighting, camera) → put in `prompt`. Trying to verbally describe a face in detail wastes tokens and produces drift.
音频方向与口型由 generate_audio 与提示词共同控制:默认在同趟生成同步语音/音效/配乐,文档要求显式写语气与氛围(warm friendly conversational / gentle cafe chatter, no foreground music),并承认口型质量取决于提示清晰度。
| `generate_audio` | bool | no | true | In-pass synchronized speech / SFX / music. |
路由表把家族其它视频模型分工写清:要音轨驱动口型走 Wan 2.7(audio_url)、要榜单最佳画质走 HappyHorse 1.0、要既有素材运动编辑走 Kling、要极快迭代走 LTX 2;用户显式说 Seedance 则无条件路由回来。
| Audio-driven lip-sync from your own track | Wan 2.7 (`audio_url`) |
执行链与限制面:CLI 提交到 Model API 的 /v1/models/bytedance/seedance-v2/pro,轮询取结果,下载白名单产物;文档自陈分辨率上限 720p、无 `@` 角色绑定语法、>15s 会 422 需分段。
The CLI submits, polls, fetches the result, downloads `*.runcomfy.net`/`*.runcomfy.com` URLs into `--output-dir`.
2核心能力
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | runcomfy(RunComfy 官方 CLI) |
| package | @runcomfy/cli(npm 全局包) |
| package | npx skills(skills.sh 安装器) |
| api | RunComfy Model API(ByteDance Seedance 2.0 Pro) |
| network | RunComfy 产物下载白名单 |
| network | 用户传入的参考图/视频/音频 URL(最多 9+3+3,由 RunComfy 服务器抓取,非本机) |
| network | RunComfy 站点/模型页/文档(文档引用,非运行时调用) |
| network | GitHub(技能源码链接) |
4风险提醒 风险提醒:橙色 · 评估后使用
- 素材出网面与语音合成风险 — 最多 15 个外部素材 URL(图/视频/音频)由 RunComfy 服务器抓取并进入第三方模型;同趟合成的语音可用于生成逼真口播,参考音频还能引导音色——未发布素材与人声样本的保密性、声音权/肖像权问题文档未提示(Security 段只笼统讲图像注入)。
- 执行面在仓外且无版本 pin — 真实动作由 npm 全局安装的 @runcomfy/cli 完成(安装行不含版本);CLI 内部实现与安全断言无法在本 pin 证实,供应链风险落在 npm 与 RunComfy 两方。
- 凭证与高单价计费 — CLI 以用户 RunComfy token 提交;多模态视频生成为高单价推理,按次计费,配合 75 重试码可能被自动重试放大消耗。
- 路由表含悬空引用 — 建议换用『Kling Video O1』『LTX 2』,但这两个名称在仓库内没有对应技能(仓内的 Kling 技能自称 Kling 3.0 / V3.0)——agent 照表跳转会找不到落点。
- 分辨率与画质定位落差 — 文档以 'cinematic' 定位,但输出上限 720p(playground variant);用于大屏/影院级交付需先确认能否接受该上限(Limitations 有披露,非隐瞒,但营销措辞容易让人误判)。
5第二遍独立确认
- [ok] skill 目录内容 = 仅 SKILL.md — git ls-tree HEAD 与 ls -a 双向核实;仓库根仅 LICENSE + README.md + 31 个技能目录。
- [ok] 全部外部依赖条目回查调用点真实存在 — runcomfy CLI 调用点 3 处(默认/带角色参考/多模态示例)、npm 安装 1 处、npx skills 1 处、model-api 端点 1 处、白名单与外部素材抓取各 1 处、文档/模型页/GitHub 链接多处,均实读命中。
- [discrepancy] 路由建议的目标模型在本仓有对应技能 — 'Motion editing on existing footage | Kling Video O1' 与 'Ultra-fast iteration | LTX 2' 在仓库内没有同名技能目录(全仓无 ltx-* 目录;kling-3-0/SKILL.md 自称 'Kling 3.0 (also called Kling V3.0)',未使用 'Kling Video O1' 这一名称)。Wan 2.7 与 HappyHorse 1.0 两条路由目标在仓内有同名目录,属有效引用;Kling/LTX 两条为悬空引用。
- [ok] 『cinematic 视频』定位与 720p 分辨率上限的一致性 — description 称 cinematic short-form,schema 与 Limitations 均明示 resolution 仅 480p/720p('Resolution ceiling 720p on the playground variant')。定位与规格存在张力,但文档主动披露上限,未夸大为 1080p/4K,判为一致。
- [unlocatable] Security & Privacy 的技术断言可在本仓证实 — 0600 token 权限、2 GiB 下载上限、无 shell 展开、下载白名单、退出码语义均为仓外 @runcomfy/cli 行为;仓内无 CLI 源码或版本 pin,只能作为文档自述引用(同仓 runcomfy-cli/SKILL.md 为同源转述,非独立证据)。
- [discrepancy] 安装一行与 GitHub 链接指向旧仓 agentspace-so/runcomfy-skills — 安装行 `npx skills add agentspace-so/runcomfy-skills --skill seedance-v2 -g` 与 GitHub 链接 github.com/agentspace-so/runcomfy-skills 指向旧仓;本仓 pin 在 prime-skills/runcomfy-agent-skills(README 用 runcomfy-agent-skills)。gh api:旧仓仍存在(5★、pushed 2026-04-29、含 seedance-v2 目录);prime-skills/runcomfy-agent-skills 与 agentspace-so/runcomfy-agent-skills 为同一仓(相同 stats,full_name=prime-skills/runcomfy-agent-skills)。按文档安装可能装到旧版。
- [discrepancy] 音/视频合成与声音权的风险披露 — 本技能会在同趟合成语音(generate_audio 默认 true),且接受 0–3 段参考音频引导音色;Security & Privacy 段仅泛泛提示 'image-based prompt injection',未就『合成语音可用于伪造口播』或『参考音频可近似真人声音(声音权)』给出任何提示(对比:happyhorse 明写音频为 in-pass only、不接受外部音轨)。属安全提示覆盖不全。
- [ok] prompt 长度规格是否自洽 — schema 写 'CN ≤ 500 chars OR EN ≤ 1000 words',正文未另立口径(本族其它技能给的是字符/token 上限),无冲突。
6结论
0cbe7963b5552282…fca19ae084