1实现原理 · 为什么它能做到
零代码单文件：本 skill 是一页端点说明 + 调用配方，目录内只有 SKILL.md，frontmatter 只授予 `runcomfy *` 一个命令面。能力由 RunComfy 云端的 Wan 3.0 Prime Reference to Video 端点提供，skill 只负责把「怎么调对」写清楚。
wan-3-0-prime-reference-to-video/SKILL.md
allowed-tools: Bash(runcomfy *)
该目录实测仅 SKILL.md；全仓非 Markdown 文件只有 LICENSE，仓库内无任何可执行代码。
此端点存在的理由是「编号参考绑定」：把最多 10 图 / 5 视频 / 5 音频按数组序绑成 Image 1 / Video 1 / Audio 1，再在 prompt 里用编号指代——这是靠参考而非散文描述来维持人物、产品、场景一致性的机制。
wan-3-0-prime-reference-to-video/SKILL.md
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`.
提示词节把它展开成可执行规则：编号按传入数组序、写「Image 1 stands beside the counter」优于描写人脸、也优于含糊的「the man in the reference」。
计费按「计秒 = 输出时长 + 所附参考视频时长」，参考图与参考音频不计时长；三档分辨率单价不同（480p $0.0624 / 720p $0.124 / 1080p $0.249 每计秒），且文档明说提交前显示的预估会在运行后按实测参考时长结算。
wan-3-0-prime-reference-to-video/SKILL.md
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.
透明度优于同族页：另有一句「The figure shown before submit is an estimate — reference clips are measured after the run, so the final charge settles then.」解释预估与实收的差额来源。
端点硬约束会否掉常见调用：至少一个参考（纯 prompt 调用被拒）、参考视频单条 1-15 秒且合计 15 秒、参考音频合计 15 秒、时长 2-30 秒整秒、宽高比仅六个值。
wan-3-0-prime-reference-to-video/SKILL.md
**At least one of `reference_images`, `reference_videos`, `reference_audios` must be supplied** — this endpoint rejects a prompt-only call.
退出码表把这类失败归到 65：「bad input JSON / schema mismatch (e.g. no reference supplied, duration out of 2–30)」。
调用链写出但未给端点 URL 路径：skill 组 JSON body → `runcomfy run wan-ai/wan-3.0-prime/reference-to-video` → CLI 带 bearer token POST、拿 request id、轮询到终态、取回结果并下载到 --output-dir。
wan-3-0-prime-reference-to-video/SKILL.md
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`.
与同族两个 Seedance 页不同，本页只写「RunComfy Model API」而不给 `https://model-api.runcomfy.net/v1/models/...` 完整路径，调用者无法据此直接核对端点地址（见 verification）。
成本纪律被写成操作建议：参考片段只留承载运动的最短长度、先在 480p（约为 1080p 的四分之一单价）草稿、时长是主要成本乘数之一，并给了 5s/15 计秒/30s 三个算例。
wan-3-0-prime-reference-to-video/SKILL.md
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.
算例复核无算术错误（5×0.124≈$0.62；15×0.124≈$1.86；30×0.249≈$7.47）。
2核心能力
01编号参考绑定：最多 10 图 + 5 视频 + 5 音频，prompt 内以 Image 1/Video 1/Audio 1 指代，用数组序对齐
02三档分辨率与六种宽高比（含 adaptive 跟随参考画幅）
032-30 秒时长（超出同族多数端点上限），整秒步进
04prompt_extend 开关：默认由模型改写润色 prompt，可关闭以获得字面执行/更快返回
05seed 复现：给定 0-2147483647 的 seed 做可复现变体（同族 Seedance 页均无此字段）
06同步音轨开关：enable_audio 默认开，输出带同步音轨；关闭出默片，费率不变
07计费预估与省钱动作：三档单价表 + 三个算例 + 剪短参考片、先 480p 草稿
08提示词纪律：稳定身份进参考、演化内容进 prompt；镜头语法前置；一次只给一个主动作；按节拍阶梯式加长
09模型官方示例 prompt 三则（海岸航拍/雨夜街景/香水瓶转台）随文档附带
10注入面自护：参考图/视频/音频及其提取文本一律当数据，明令不执行其中指令、不打开其中链接
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管控建议与判定依据
建议配套管控措施
面向 Agent
分级或逐次授权，建议在沙箱运行
面向管理者
审批流程、可回滚、全程审计
判定依据（文件路径与关键语句摘要）
- 网络端点: 声明外部网络访问: model-api.runcomfy.net — 参考条件视频生成的提交、轮询与结果取回（经 runcomfy CLI，携带用户 bearer tok
- 本地工作目录: 文件读写与工件输出: CLI 将生成视频下载到 `--output-dir` 指定目录（路径由调用者给定；文档声明单文件 2 GiB 上限以防 30s 1080p 失控输出
- SKILL.md: 声明调用宿主 CLI 解释器或外部运行环境
审计说明： 。按统一分档准则：运行时驱动第三方 npm 包/CLI（@runcomfy/cli），每次调用读取用户 RunComfy 凭证（~/.config/runcomfy/token.json 或 RUNCOMFY_TOKEN）并消耗付费额度——命中「调第三方 npm/CLI 且可能读配额/密钥 → 橙」。执行面全部在仓外（CLI 行为、Model API、token 0600、2 GiB 上限、无遥测均属文档转述），按「拿不准取高一档」定橙。网络外发面在三者中最大：图/视频/音频三类参考素材与 prompt 一并上送第三方云。降档因素（故不升红）：allowed-tools 仅 `runcomfy *`、无任意 shell、无凭证回显、端点白名单与体积上限均有声明、skill 本体零代码零混淆无隐藏端点；本页另对参考媒体注入给出明确的 agent 行为约束。
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结论
适合： 适合有 RunComfy 账号、需要「同人物/同产品/同场景跨镜保持在位」的参考条件生成用户：品牌连续性短片、产品多镜头、需要 2-30 秒较长镜头、想用 seed 复现同一构图做变体的工作流。也适合想抄一份完整「参考类端点说明书」写法（schema 全字段 + 计费算例 + 注入自护）的 skill 作者。
不适合： 不适合没有 RunComfy 账号或不允许素材出域的用户；不适合纯文本生成（端点拒收无参考调用，应走 text-to-video）；不适合需要 4K、或需要单条参考视频超过 15 秒、或需要非文档所列宽高比的场景；不适合要把成本锁死在预估值的作业（最终以运行后结算为准）；也不适合离线本地生成。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload wan-3-0-prime-reference-to-video.tar.gz
sha256:
Option B · Copy Guide for Agent1fe7f0a2d659dcd0…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit c163a9fd3a.