1仕組みと動作原理
実装方式は「ノーコード + 外部 CLI 委任」です。`seedance-v2/` 配下には `SKILL.md` が 1 ファイルあるのみでスクリプトは存在せず、実行時にホストエージェントが Bash 経由で `runcomfy run bytedance/seedance-v2/pro --input '<JSON>' --output-dir <path>` を実行します。動画生成と音声合成はすべて RunComfy クラウド上で行われ、スキルは意図を正確な JSON とプロンプトへ変換する役割のみを担います。
seedance-v2/SKILL.md
The skill invokes `runcomfy run bytedance/seedance-v2/pro` with a JSON body matching the schema.
`git ls-tree HEAD` により `seedance-v2/` 配下のエントリが `SKILL.md` のみであることを確認済みです。同一リポジトリ内の 31 個のスキルも同一の形態です。
中核となる差別化要素はマルチモーダル参照条件です。画像 0〜9 枚、動画 0〜3 本、音声 0〜3 本を同時に投入可能で、`generate_audio` と連携して同一次の生成内で同期した音声/効果音/BGM を出力します。これはファミリー内で唯一「複数タイプの参照 + インパス音声」を備えたモデルです。
seedance-v2/SKILL.md
| `video_url` | array | no | `[]` | 0–3 clips (MP4/MOV), 2–15s each. |
3 つの参照タイプにはそれぞれ独立した形式/時間制約があります（動画・音声ともに 2〜15 秒、音声 < 15MB、画像は JPEG/PNG/WebP/BMP/TIFF/GIF をサポート）。ドキュメントの schema、Prompting、Limitations の 3 箇所でこの仕様が明記されており、範囲外の入力は即座に拒否されます。
スキーマは全 10 フィールドで構成され、7 種類のアスペクト比（デフォルトは `adaptive`）、4〜15 秒の継続時間（デフォルトは 5）、480p/720p の解像度（デフォルトは 720p）、デフォルトで有効な `generate_audio`、`seed` が含まれます。アスペクト比の列挙値（21:9 や `adaptive` を含む）や 4 秒の下限値は兄弟モデルと異なり、モデル独自の仕様です。
seedance-v2/SKILL.md
| `aspect_ratio` | enum | no | `adaptive` | `adaptive`, `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9`. |
`adaptive` がデフォルトである点はファミリー内でも独自です（`wan-2-7` や `happyhorse` は 16:9 がデフォルト）。Limitations には「Resolution ceiling 720p on the playground variant」と明記されており、「映画的質感」の位置付けと引き換えにした解像度の妥協点であることが隠さず記載されています。
最も重要な運用規律は「画像とテキストの役割分担」です。安定したアイデンティティ（顔、服装、ブランドロゴなど）は `image_url` に配置し、展開するナラティブ（動作、雰囲気、照明、カメラアングル）は `prompt` に配置します。顔の特徴を言葉で細かく説明しようとすると、トークンを浪費しドリフト（ブレ）の原因となります。
seedance-v2/SKILL.md
**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.
この規定は「マルチ参照」をパラメータの問題から方法論の問題へと引き上げています。ドキュメントにはアンチパターンとして「Trying to describe stable identity verbally → use `image_url` instead.」と直接誤った使い方が示されています。
音声の方向性とリップシンクは `generate_audio` とプロンプトによって連動制御されます。デフォルトで同生成パス内に同期音声/効果音/BGM を生成し、ドキュメントではトーンや雰囲気を明示的に記述すること（warm friendly conversational / gentle cafe chatter, no foreground music など）を求めており、リップシンクの品質はプロンプトの明確さに依存することを明言しています。
seedance-v2/SKILL.md
| `generate_audio` | bool | no | true | In-pass synchronized speech / SFX / music. |
Limitations には「Lip-sync quality — depends on prompt clarity; not guaranteed perfect under all conditions.」と明記されており、不確実性を事後免責ではなく事前の利用前提として定義しています。
ルーティングテーブルによってファミリー内の他の動画モデルとの役割分担が明確化されています。音軌駆動のリップシンクは Wan 2.7（`audio_url`）、ベンチマーク最高画質は HappyHorse 1.0、既存素材のモーション編集は Kling、極めて高速なイテレーションは LTX 2 へルーティングします。ユーザーが明示的に Seedance を指定した場合は無条件で本モデルへルーティングされます。
seedance-v2/SKILL.md
| Audio-driven lip-sync from your own track | Wan 2.7 (`audio_url`) |
同一ページに「If the user said \"Seedance\" / \"Seedance 2\" / \"ByteDance video\" explicitly, route here regardless.」と記載されています。推奨先のうち Wan 2.7 と HappyHorse 1.0 はリポジトリ内に同名スキルディレクトリが存在しますが、「Kling Video O1」と「LTX 2」は存在しません（second_pass 参照）。
実行チェーンと制限事項：CLI が Model API の `/v1/models/bytedance/seedance-v2/pro` にリクエストを送信し、ポーリングで結果を取得してホワイトリスト化された生成物をダウンロードします。解像度の上限が 720p であること、`@` キャラクターバインド構文が存在しないこと、15 秒を超えると 422 エラーになるため分割が必要であることがドキュメントに明記されています。
seedance-v2/SKILL.md
The CLI submits, polls, fetches the result, downloads `*.runcomfy.net`/`*.runcomfy.com` URLs into `--output-dir`.
「`@` 構文非対応」という記述は、一部の競合（`@` でキャラクターをバインドする方式）との能力差を明確にしており、利用者にとって有益な除外要件となっています。
2コア機能
01マルチモーダル参照条件：画像 0〜9 枚、動画 0〜3 本、音声 0〜3 本を同時に投入可能
02同一パス内での同期音声/効果音/BGM 生成（`generate_audio` はデフォルト有効）と自然なリップシンク
03画像とテキストの役割分担規律（アイデンティティは参照画像、ナラティブはプロンプト）による、顔の言語記述に起因するドリフト防止
04アスペクト比・継続時間・解像度制御（21:9 およびデフォルト `adaptive` を含む 7 種のアスペクト比、4〜15 秒、480p/720p）
05参照素材の厳密な仕様管理（動画/音声は 2〜15 秒、音声は 15MB 未満、規格外は即座に拒否）
06音声方向性のプロンプト指示法（トーンや雰囲気を明示的に指定、例: warm friendly conversational / no foreground music）
07`seed` 値による再現性確保と固定スキーマでのバリエーション検証
08兄弟モデルへのルーティング判定（音軌リップシンク → Wan 2.7、最高画質 → HappyHorse 1.0、モーション編集 → Kling、高速反復 → LTX 2）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| 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推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: （スキル本体にスクリプトなし）ホストエージェントが Bash 経由でリポジトリ外の CLI を実行: `runcomfy run <vendor>/<model>/<endp
- 网络端点: 外部ネットワークアクセスの宣言: POST https://model-api.runcomfy.net/v1/models/bytedance/seedance-v2/pro（r 経由
- 本地工作目录: ファイルの読み書きと成果物の出力: 生成物は外部 CLI によってダウンロードされ `--output-dir` に書き込まれる（ディスク容量枯渇防止のため単一ファイル > 2 GiB で中止とドキュメントに記載）
監査ノート： 今回の統一格付け基準（同一リポジトリの `image-edit` はオレンジ判定済み）に基づきます。実行時にサードパーティ製 npm パッケージ/CLI である `@runcomfy/cli` を呼び出し、この CLI が実行ごとにユーザーの RunComfy 認証情報（`~/.config/runcomfy/token.json` または `RUNCOMFY_TOKEN`）を読み取るため、「サードパーティ CLI/リモートパッケージを呼び出し、認証情報/クォータに接触する」基準に該当します。CLI の内部実装、Model API の挙動、0600 トークン権限、2 GiB のダウンロード上限、終了コードの定義などの主張はすべてリポジトリ外部に依存しており、本コミット内には検証可能なソースコードが存在しないため、「判断に迷う場合は高位に倒す」原則に従いオレンジと判定しました。また、本スキルは素材の外部送信面が最も広く（最大画像 9 枚 + 動画 3 本 + 音声 3 本）、同一パス内で音声合成を行うため、未公開素材や生の声サンプルの機密性および音声権利リスクをローカルで制御できません。さらに動画生成は高単価な従量課金推論です。なお、スキル本体は純粋な Markdown であり、スクリプト、難読化、隠蔽されたエンドポイントは含まれないため、レッド基準には抵触しません。
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結論
最適な用途： 適した用途：キャラクターやシーンの参照素材（複数枚のキャラクター画像、固定アングル動画、参照声質）を持つブランドナラティブ短尺動画。独立した TTS やリップシンク工程を省き、1 回の生成でナレーションと効果音を揃えたい対話型広告。固定 `seed` を用いた再現可能なバリエーション検証を行うエンジニアリングパイプライン。多言語ナラティブ（画像とテキストの分離により翻訳時はテキストのみ変更）。前提条件：`runcomfy` CLI がインストール・ログイン済みであり、720p の上限を許容できること。
不向きな用途： 適さない用途：1080p/4K での納品が必要な場合（`happyhorse-1-0` の 720P/1080P 等に変更を推奨）、自身の音声トラックで厳密にリップシンクを駆動したい場合（`wan-2-7` の `audio_url` を推奨）、15 秒超の単一ショットが必要な場合（分割が必須）、`@` 構文によるキャラクターバインドが必要な場合（本モデルは非対応）。また、素材の外部送信が禁止されている環境や、監査可能な実行コードが求められるコンプライアンス環境。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload seedance-v2.tar.gz
sha256:
Option B · Copy Guide for Agent0cbe7963b5552282…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit fca19ae084.