1仕組みと動作原理

ノーコード・単一ファイル構成：本skillは1ページの端点仕様と呼び出しレシピで構成され、ディレクトリ内には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としてマッピングし、プロンプト内で番号指定することで、散文的な記述ではなく参照データによって人物、製品、シーンの一貫性を維持します。

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」のような曖昧な表現よりも推奨されています。

課金は「カウント秒数 = 出力秒数 + 添付参照動画の秒数」に基づいて計算され、参照画像および参照音声は時間課金されません。3段階の解像度ごとに単価が異なり（カウント秒あたり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.」という一文で見積もりと実請求の差額要因が明記されています。

端点のハード制約により一般的な不正呼び出しを事前に除外します。最低1つの参照が必須（テキストのみの呼び出しは拒否）、参照動画は1本あたり1〜15秒かつ合計15秒以内、参照音声は合計15秒以内、出力秒数は2〜30秒の整数値、アスペクト比は指定の6種類のみに限定されます。

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: 参照未指定、2〜30秒の範囲外など）として分類しています。

呼び出しフローは明記されていますが端点URLパスは記載されていません。skillがJSON本文を構築 → `runcomfy run wan-ai/wan-3.0-prime/reference-to-video`を実行 → CLIがBearerトークン付きでPOST送信、リクエスト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ページ2件とは異なり、本ページには「RunComfy Model API」とだけ記載され、`https://model-api.runcomfy.net/v1/models/...`の完全なパスが記載されていないため、ドキュメントから直接端点URLを検証することはできません（verification参照）。

コスト管理が実践的な推奨事項として体系化されています。参照クリップは動きを伝える最短の長さに抑える、1080pの約4分の1の単価である480pで先にドラフトを作成する、秒数が主要なコスト係数であることを明記し、3つの試算例（5秒、15カウント秒、30秒）を提示しています。

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音声をサポートし、配列順に従ってプロンプト内でImage 1/Video 1/Audio 1として指定可能

023段階の解像度と6種類のアスペクト比に対応（参照画角に追従するadaptiveを含む）

032〜30秒の秒数指定（同系統の多くの端点の上限を超過）、1秒刻みで指定可能

04prompt_extend切り替え：デフォルト有効でモデルによるプロンプト拡張・推敲を実施。無効化により文字通りの指示実行と高速な応答が可能

05seedによる再現性：0〜2147483647のseed値を指定し、構図を固定したバリエーション生成が可能（同系統のSeedanceページにはないフィールド）

06同期音響切り替え：enable_audioはデフォルトで有効（同期音声を生成）。無効時は同一料金で無音映像を出力

07課金見積もりとコスト削減策：3段階の単価表＋3つの試算例＋参照素材のトリミングや480pでのドラフト推奨

08プロンプト作成方針：固定属性は参照に任せ変化要素をプロンプトに記述、カメラ構図の指定を前置、主要アクションは1度に1つに限定、段階的に長さを延長

09モデル公式サンプルプロンプト3件（海岸の空撮/雨の夜景/香水ボトルのターンテーブル）を同梱

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 — 参照条件付き動画生成のリクエスト投入、ステータスポーリング、結果取得（ユーザーのBearerトークンを含むruncomfy CLI経由）
本地工作目录: ファイルI/Oおよび成果物出力: CLIが生成された動画を`--output-dir`で指定されたディレクトリにダウンロード（パスは呼び出し側が指定。ドキュメントには30秒1080pの肥大化を防ぐ2 GiBの単一ファイル上限が明記）
SKILL.md: ホストCLIインタープリターまたは外部実行環境の呼び出しを宣言

監査ノート： 統合分類基準に基づく判定：ランタイムがサードパーティ製npmパッケージ/CLI（@runcomfy/cli）を実行し、実行ごとにユーザーのRunComfyクレデンシャル（~/.config/runcomfy/token.jsonまたはRUNCOMFY_TOKEN）を読み込んで有料クォータを消費するため、「サードパーティ製npm/CLIを呼び出し、クォータ/APIキーを読み込む可能性がある → オレンジ」に該当します。実行面はすべてリポジトリ外部（CLIの挙動、Model API、トークンの0600権限、2 GiB上限、テレメトリ非送信はドキュメント上の記述）であるため、「確証が持てない場合は上位ランクを適用」の原則によりオレンジと判定します。外部送信の対象範囲は同系統の3つの中で最も広く、画像・動画・音声の3種類の参照素材とプロンプトがサードパーティのクラウドに送信されます。降格要因（レッドに指定しない理由）：allowed-toolsが`runcomfy *`のみに限定されている点、任意のシェル実行がない点、クレデンシャルのエコーバックがない点、端点ホワイトリストとデータ容量上限が明記されている点、skill本体が完全ノーコードで難読化や隠蔽された端点がない点、および参照メディア経由のインジェクションに対する明確なエージェント行動制約が定義されている点が挙げられます。

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結論

「インデックス番号による参照バインディング」機構を良例・悪例を交えて詳述し、この専用端点を利用する価値が明確に示されている

透明性の高い課金設計：提出前は見積もりであり、実行後の実測動画秒数に基づいて精算される旨を事前明記し、請求差額に関する懸念を解消している

3段階の解像度＋seed＋prompt_extendにより、再現可能な段階的制作フロー（480pドラフト→同一seed比較→1080p本番）を実現

ハード制約を一箇所にまとめ代替ルーティングを案内することで、エージェントによるエラーコード65の頻発を防止

画像・動画を介したインジェクションを既知のリスクと位置づけ、参照URLはユーザー指定のものに限定する明確な防御指針を提示

最適な用途： RunComfyアカウントを所持し、「ショット間での同一人物・製品・シーンの一貫性維持」を目的とする参照条件付き生成ユーザーに最適：ブランドの連続性を持つショートフィルム、製品のマルチアングル映像、2〜30秒の長尺ショット、同一シードによる構図固定バリエーション作成など。また、参照系端点のドキュメント設計（完全なスキーマ＋課金試算＋インジェクション防御）の模範例を求める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: 1fe7f0a2d659dcd0…

Option B · Copy Guide for Agent

install.json

Agent はこの JSON ガイドから自動的にダウンロードして検証します。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit c163a9fd3a.