wan-3-0-prime-reference-to-video
Build video clips from reference images, reference videos, and reference audio with Wan-AI Wan 3.0 Prime Reference to Video on RunComfy. Up to 10 reference images, 5 reference videos and 5 reference audio clips are bound to a prompt that names them as "Image 1", "Video 1", "Audio 1", giving character, product and scene consistency across a 2-30 second shot at 480p, 720p or 1080p with a synchronized audio track. Documents the full input schema, the counted-second pricing model (reference videos are billed as duration, images and audio are not), and when to route to Wan 3.0 Prime text-to-video / image-to-video, Wan 2.7 or Seedance 2.0 Pro instead. Calls `runcomfy run wan-ai/wan-3.0-prime/reference-to-video` through the local RunComfy CLI. Triggers on "wan 3 prime reference to video", "wan 3.0 prime", "wan3 prime", "reference to video", "ref2v", "keep the same character across shots", "video from reference images", or any explicit ask to generate video from references with this model.
1实现原理 · 为什么它能做到
零代码单文件：本 skill 是一页端点说明 + 调用配方，目录内只有 SKILL.md，frontmatter 只授予 `runcomfy *` 一个命令面。能力由 RunComfy 云端的 Wan 3.0 Prime Reference to Video 端点提供，skill 只负责把「怎么调对」写清楚。
allowed-tools: Bash(runcomfy *)
此端点存在的理由是「编号参考绑定」：把最多 10 图 / 5 视频 / 5 音频按数组序绑成 Image 1 / Video 1 / Audio 1，再在 prompt 里用编号指代——这是靠参考而非散文描述来维持人物、产品、场景一致性的机制。
The distinct thing here is **numbered reference binding**: you attach up to 10 images, 5 videos and 5 audio clips, then address them in the prompt as `Image 1`, `Video 1`, `Audio 1`.
计费按「计秒 = 输出时长 + 所附参考视频时长」，参考图与参考音频不计时长；三档分辨率单价不同（480p $0.0624 / 720p $0.124 / 1080p $0.249 每计秒），且文档明说提交前显示的预估会在运行后按实测参考时长结算。
Billing is per **counted second** = output duration **plus** the combined duration of every reference video you attach. Reference images and reference audio are **not** billed as duration, and toggling `enable_audio` does not change the rate.
端点硬约束会否掉常见调用：至少一个参考（纯 prompt 调用被拒）、参考视频单条 1-15 秒且合计 15 秒、参考音频合计 15 秒、时长 2-30 秒整秒、宽高比仅六个值。
**At least one of `reference_images`, `reference_videos`, `reference_audios` must be supplied** — this endpoint rejects a prompt-only call.
调用链写出但未给端点 URL 路径：skill 组 JSON body → `runcomfy run wan-ai/wan-3.0-prime/reference-to-video` → CLI 带 bearer token POST、拿 request id、轮询到终态、取回结果并下载到 --output-dir。
The CLI POSTs to the RunComfy Model API with the user's bearer token, receives a request id, polls until the request reaches a terminal state, fetches the result, and downloads any `.runcomfy.net` / `.runcomfy.com` URL into `--output-dir`.
成本纪律被写成操作建议：参考片段只留承载运动的最短长度、先在 480p（约为 1080p 的四分之一单价）草稿、时长是主要成本乘数之一，并给了 5s/15 计秒/30s 三个算例。
Two consequences worth telling the user before a big run: **trim reference videos to the shortest clip that carries the motion**, and **draft at 480p** (about 4× cheaper per second than 1080p) before committing to the final render.
2核心能力
3外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| cli | runcomfy（RunComfy 官方 CLI，唯一被授予的命令面） |
| package | @runcomfy/cli（npm 全局安装，或 npx -y 一次性运行） |
| network | RunComfy Model API（提交 + 轮询 + 取回，携带用户 bearer token；本页未给具体 URL 路径） |
| network | 生成结果下载白名单（CLI 抓回 --output-dir，文档称单文件超 2 GiB 会中止） |
| network | 用户提供的参考图/视频/音频 URL——由 RunComfy 模型服务器抓取（本机不抓，文档要求公开可达 HTTPS） |
| network | RunComfy 模型页/文档站/姊妹技能页链接（带 utm 营销参数） |
4管控建议与判定依据
- 网络端点: 声明外部网络访问: model-api.runcomfy.net — 参考条件视频生成的提交、轮询与结果取回（经 runcomfy CLI，携带用户 bearer tok
- 本地工作目录: 文件读写与工件输出: CLI 将生成视频下载到 `--output-dir` 指定目录（路径由调用者给定；文档声明单文件 2 GiB 上限以防 30s 1080p 失控输出
- SKILL.md: 声明调用宿主 CLI 解释器或外部运行环境
5第二遍独立确认
- [ok] 计费表与算例算术 — 480p $0.0624 / 720p $0.124 / 1080p $0.249 每计秒；算例复核：5×0.124=$0.62（文档写 ≈$0.62）、15×0.124=$1.86、30×0.249=$7.47，全部吻合；「draft at 480p (about 4× cheaper per second than 1080p)」亦成立（0.249/0.0624≈3.99×）。
- [ok] 参考预算与时长上限是否前后一致 — reference_images 上限 10、reference_videos 5（单条 1-15s、合计 15s）、reference_audios 5（合计 15s）、duration 2-30 整秒、resolution 三档、aspect_ratio 六个值——schema 表、Limitations 节与 frontmatter description 三处一致，未发现互相冲突的数字。
- [discrepancy] 「模型官方示例 prompt」与本文教学重点是否自洽 — 文档全篇强调编号参考绑定是本端点存在理由（'This is the whole point of the endpoint'），但 Sample prompts 节三则示例（海岸航拍、雨夜街景、香水瓶转台）都是不含任何 `Image 1` / `Video 1` 引用的纯文本描述。示例里看不到核心语法，读者照抄会遗漏本端点最有价值的部分；属教学一致性缺陷（非事实错误）。
- [discrepancy] schema 表 `reference_images` 行的 Required/Default 表述 — 该行 Required 写 conditional、Default 写 `example image`——Default 既非空值也非文档别处使用的具体值，与正文「At least one of ... must be supplied」需合读才成立；同一张表的其它行 Default 都是具体值（`[]`、`720p`、`16:9`、`5`、`true`、`random`），与 `example image` 的体例不一致。
- [discrepancy] 端点 URL 路径是否可以核对 — 两个同族 Seedance 页都把完整路径写出（`https://model-api.runcomfy.net/v1/models/bytedance/...`），本页只写「The CLI POSTs to the RunComfy Model API」；调用者无法据此核对端点地址，只能靠 model id `wan-ai/wan-3.0-prime/reference-to-video` 与 CLI 文档推断。属家族内文档不对称。
- [discrepancy] Ctrl-C 取消语义 — 本页写「`Ctrl-C` cancels the remote request before exit.」，与 seedance-2-5-reference-to-video 措辞相同，但与 seedance-2-5-image-to-video 的「jobs already in progress cannot be cancelled」以及 runcomfy-cli/SKILL.md 的「`Ctrl-C` sends `DELETE` … so you don't get billed for work you abandoned.」（另有 exit 130 行）三处不一致；仓内无法裁决，实际行为取决于 CLI 版本。
- [unlocatable] 费率与「No telemetry, no callbacks」「2 GiB 上限」可否在仓内证实 — 费率、无遥测、下载体积上限均属仓外服务/二进制事实，本 pin 无证据可核；按「定位不到不硬写」记待补，并已计入橙档理由。
- [ok] allowed-tools 与示例命令、安装步骤的边界 — frontmatter line 3 为 `Bash(runcomfy *)`；三条示例调用均为 `runcomfy run wan-ai/wan-3.0-prime/reference-to-video`，npm 安装与 RUNCOMFY_TOKEN 设置列在 Prerequisites（一次性操作员准备），未发现越界 shell 指令；文档亦声明 skill 不读凭证以外的任何环境变量。
6结论
1fe7f0a2d659dcd0…