video-edit

Video Edit — RunComfy の Pro Pack

runcomfy.com · Wan 2.7 Edit-Video · Kling Motion-Control Pro · Lucy Edit Restyle · GitHub

意図に応じて振り分ける動画編集。 このスキルでは、使用するモデルを1つに限定しません。ユーザーが実際に希望している内容（全般的なスタイル変更、参照クリップからのモーション転送、または手軽でアイデンティティを維持した服装／背景の差し替え）に応じて、RunComfy のカタログから最適な動画編集モデルを選びます。

npx skills add agentspace-so/runcomfy-skills --skill video-edit -g

ユーザーの意図に合ったモデルを選ぶ

ユーザーの意図	モデル	理由
顔／ポーズ／口の動きを保ちながら、トーキングヘッド動画のスタイルを変更する	Wan 2.7 Edit-Video	アイデンティティとモーションの保持に優れ、最大 1080p に対応
カメラの動きを維持したまま、商品背景を差し替える	Wan 2.7 Edit-Video	カメラの動きを維持し、一方向の編集に対応
参照画像を使ってパッケージデザインを差し替える	Wan 2.7 Edit-Video + reference_image	参照画像に基づくデザイン転送
映画のようなカラーグレーディング／商用向けの仕上げを適用する	Wan 2.7 Edit-Video	全体のルックを一方向に変更する用途に適している
参照動画からターゲットキャラクターに正確なモーションを転送する	Kling 2.6 Pro Motion Control	アイデンティティを保ったモーションマッピング向けに設計
ソース動画の口の動きに合わせて、ターゲットキャラクターのモーションをリップシンクする	Kling 2.6 Pro Motion Control	高い時間的一貫性を実現
アイデンティティを保った手軽な服装／衣装の差し替え	Lucy Edit Restyle	アイデンティティを維持した部分編集が得意
アイデンティティを保ったスタイル変更（「砂漠の宇宙飛行士」、「暖かみのあるゴールデンアワーの光」）	Lucy Edit Restyle	スタイル変更における時間的一貫性に特化
指定がない場合のデフォルト	Wan 2.7 Edit-Video	最も汎用性が高く、最高解像度に対応

エージェントはこの表を読み、ユーザーの意図を分類して、以下の該当するサブセクションを選びます。

前提条件

1. RunComfy CLI — npm i -g @runcomfy/cli
2. RunComfy アカウント — runcomfy login。
3. CI／コンテナ — RUNCOMFY_TOKEN=<token> を設定します。
4. ソース動画の URL — 形式と制限は選択したルートによって異なります。

---

ルート 1：Wan 2.7 Edit-Video — スタイル変更／背景／パッケージ編集のデフォルト

モデル：wan-ai/wan-2-7/edit-video

スキーマ

フィールド	型	必須	デフォルト	備考
prompt	string	はい	—	保持する内容を先に指定します。1 回の呼び出しにつき、編集の方向性は 1 つにします。
video	string	はい	—	MP4/MOV の URL、2～10 秒、≤100MB。
reference_image	string	いいえ	—	URL — デザイン／外観を直接転送する場合のみ使用します。
resolution	enum	いいえ	(input)	720p または 1080p。
aspect_ratio	enum	いいえ	(input)	W:H。デフォルトは入力動画と同じです。
duration	int	いいえ	0	0 = 入力動画に合わせる、2–10 = 冒頭から指定秒数に切り詰める。
audio_setting	enum	いいえ	auto	auto または origin（ソース音声を保持）。
seed	int	いいえ	—	再現性。

呼び出し

アイデンティティを保ち、音声を維持した背景差し替え：

runcomfy run wan-ai/wan-2-7/edit-video \
  --input '{
    "prompt": "Preserve the speaker'\''s face, pose, and lip movement; change the background to a modern office with neutral lighting.",
    "video": "https://.../speaker.mp4",
    "audio_setting": "origin"
  }' \
  --output-dir <absolute/path>

参照画像を使ったパッケージの差し替え：

runcomfy run wan-ai/wan-2-7/edit-video \
  --input '{
    "prompt": "Maintain the original framing and hand movement; replace the packaging design using the reference image.",
    "video": "https://.../hand-holding-package.mp4",
    "reference_image": "https://.../new-packaging.png",
    "audio_setting": "origin"
  }' \
  --output-dir <absolute/path>

プロンプトのヒント

• まず保持する要素を指定します："Preserve [face / pose / motion / framing / lip movement]; [then state the change]"。
• 1 回の呼び出しにつき、編集の方向性は 1 つにします。 複合的な編集では、動きがずれやすくなります。
• 正当な理由がある場合にのみ reference_image を指定します（パッケージの差し替え、ターゲットのビジュアルを使った衣装の差し替え）。一般的なスタイル変更では参照画像を渡さないでください。
• サウンドトラックを再生成したくないトーキングヘッド動画では、audio_setting: "origin" を指定します。
• ソース動画の制約：2～10 秒、≤100MB。

---

ルート 2：Kling 2.6 Pro Motion Control — 参照クリップの動きを適用する場合

モデル：kling/kling-2-6/motion-control-pro

ユーザーが、参照動画の動きをターゲットのキャラクターに適用したい場合に使用します（画像または別の動画をもとに動かします）。これはスタイル変更ではなく、アイデンティティを保ちながら動きをマッピングするものです。

スキーマ

フィールド	型	必須	備考
prompt	string	はい	ターゲットの動き／スタイルを記述します。
image	string	はい（画像の向き）	キャラクター／背景の一貫性を保つための参照画像です。
video	string	はい	動きの参照動画です。向きに応じて 10～30 秒です。
keep_original_sound	bool	いいえ	参照動画の音声を保持します。
character_orientation	enum	はい	image（出力は最大 10 秒）または video（出力は最大 30 秒）です。

呼び出し

runcomfy run kling/kling-2-6/motion-control-pro \
  --input '{
    "prompt": "A young american woman dancing",
    "image": "https://.../target-character.jpg",
    "video": "https://.../motion-reference-dance.mp4",
    "character_orientation": "image",
    "keep_original_sound": true
  }' \
  --output-dir <absolute/path>

プロンプトのヒント

• アイデンティティを適切に維持するには、画像参照内で被写体がフレームの 5% を超える大きさである必要があります。
• 空間的な制約が役立ちます："character on left side, background motion right"。
• 反復のたびに結果がずれる場合は、シンプルにします。形容詞を削り、動きの説明の要点を残してください。
• character_orientation: "image" では出力が最大 10 秒になります。"video" では 30 秒まで出力できます。

---

ルート 3：Lucy Edit Restyle — 軽量な、アイデンティティを維持するスタイル変更／衣装の差し替え

モデル：decart/lucy-edit/restyle

編集が局所的なスタイル変更（衣装の差し替え、シーンの照明変更、雰囲気のスタイル変更など）で、アイデンティティの保持が重要な場合に使用します。Wan 2.7 Edit より軽量で、解像度の上限は 720p です。

スキーマ

フィールド	型	必須	デフォルト	備考
prompt	string	はい	—	自然言語による編集指示です。
video_url	string	はい	—	MP4/MOV/WEBM/GIF です。
resolution	enum	いいえ	720p	このティアでは 720p のみです。

呼び出し

衣装の差し替え：

runcomfy run decart/lucy-edit/restyle \
  --input '{
    "prompt": "Change outfit to professional business attire; preserve face and motion.",
    "video_url": "https://.../subject-walking.mp4"
  }' \
  --output-dir <absolute/path>

雰囲気のスタイル変更：

runcomfy run decart/lucy-edit/restyle \
  --input '{
    "prompt": "Make lighting warm and golden hour; preserve face, pose, and motion.",
    "video_url": "https://.../subject-portrait.mp4"
  }' \
  --output-dir <absolute/path>

プロンプトのヒント

• 局所的な変更を表す言い回しが効果的です。 「衣装」「照明」「背景」から 1 つ選んでください。
• 保持する要素を指定します — "preserve face and motion" だけで十分です。細かく指定しすぎないでください。
• 全面的な置き換えは避けてください（「宇宙空間の宇宙飛行士」は機能しますが、「被写体を別人に差し替える」は機能しません）。Lucy は局所的なスタイル変更向けであり、キャラクター全体の差し替え向けではありません。
• アスペクト比は指定できません — 出力は入力に合わせられます。事前に一致させていない場合、サーバー側でクロップされます。

---

制限事項

• 各ルートは、使用するモデルの制限を引き継ぎます。 Wan 2.7 Edit：2～10 秒、解像度の上限は 1080p。Kling：10 秒（画像の向き）または 30 秒（動画の向き）。Lucy：解像度の上限は 720p、アスペクト比の指定不可。
• 複数ルートのブレンドには対応していません。 このスキルでは、1 回の呼び出しにつき 1 つのモデルを選択します。
• ブランド固有のオーバーライド — ユーザーが特定のモデルを指定した場合は、より詳しく対応するため、該当ブランドのスキル（wan-2-7）にルーティングします。

終了コード

code	意味
0	成功
64	CLI 引数が不正です
65	入力 JSON が不正です／スキーマが一致しません
69	上流の 5xx エラー
75	再試行可能：タイムアウト／429
77	サインインしていないか、トークンが拒否されました

完全なリファレンス：docs.runcomfy.com/cli/troubleshooting.

仕組み

このスキルは、ユーザーの意図に応じて Wan 2.7 Edit-Video／Kling 2.6 Pro Motion Control／Lucy Edit Restyle のいずれかを選び、対応する JSON ボディとともに runcomfy run <model_id> を実行します。CLI は Model API に POST し、リクエストの状態を確認して結果を取得した後、.runcomfy.net／.runcomfy.com の URL を --output-dir にダウンロードします。Ctrl-C を押すと、終了前にリモートリクエストをキャンセルします。

セキュリティとプライバシー

• トークンの保存：runcomfy login は API トークンをモード 0600（所有者のみ読み書き可能）で ~/.config/runcomfy/token.json に保存します。CI／コンテナーでファイルを完全に介さないようにするには、RUNCOMFY_TOKEN 環境変数を設定してください。
• 入力の境界：ユーザープロンプトは --input を介して JSON 文字列として CLI に渡されます。CLI はプロンプトをシェル展開せず、JSON ボディを HTTPS 経由で Model API に直接送信します。プロンプトの内容によるシェルインジェクションのリスクはありません。
• サードパーティーコンテンツ：渡された画像／マスク／動画の URL は、お使いのマシン上の CLI ではなく、RunComfy モデルサーバーによって取得されます。外部 URL は信頼できないものとして扱ってください。画像ベースのプロンプトインジェクションは、画像編集／動画編集モデル全般における既知のリスクです。
• 送信先エンドポイント：model-api.runcomfy.net（リクエスト送信）と *.runcomfy.net／*.runcomfy.com（生成結果のダウンロード用許可リスト）のみです。テレメトリーやコールバックはありません。
• 生成ファイルのサイズ上限：悪意のある、または制御不能なモデル出力によるディスク容量の枯渇を防ぐため、CLI は 2 GiB を超える単一のダウンロードを中止します。