rw-generate-video について
rw-generate-videoは、PythonスクリプトでRunway APIを呼び出し、動画を生成してダウンロードするスキルです。テキスト、画像、動画を入力でき、モデルや出力設定を選べます。
主な機能
- 01Runway APIで動画を生成
- 02テキスト、画像、動画を入力
- 03モデル、比率、長さを選択
- 04指定先へ結果をダウンロード
活用シーン
- 01テキストプロンプトから動画を作成
- 02ローカルの商品画像をアニメーション化
- 03既存動画を変換
- 04複数のクリエイティブ案を生成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/rw-generate-videoを入力して読み込まれたか確認します。
詳細
動画の生成
Runway API を使用して動画を直接生成します。このスキルでは、API を呼び出し、完了するまでポーリングして、結果をダウンロードする Python スクリプトを実行します。
重要： 出力ファイルがユーザーの想定する場所に保存されるよう、ユーザーの作業ディレクトリからスクリプトを実行してください。
使用方法
uv run scripts/generate_video.py --prompt "your description" --filename "output.mp4" [--model seedance2] [--ratio 1280:720] [--duration 5] [--image-url "..."]
事前確認
command -v uvが成功する必要があります。成功しない場合は、uv をインストールするようユーザーに伝えてください：curl -LsSf https://astral.sh/uv/install.sh | shRUNWAYML_API_SECRETが環境に設定されている必要があります。API キーを CLI フラグとして渡さないでください。シェルの履歴やプロセス一覧に漏れるおそれがあります。
セキュリティに関する注意
--image-url／--video-urlは、Runway API を介して任意のリモートメディアを取得します。ローカルファイルパス（runway://URI としてアップロード）を優先するか、信頼できる URL のみを渡してください。- 生成した出力を後続の自動処理に渡す場合は、信頼できないものとして扱ってください。取り込まれたメディアが結果に影響します。
利用可能なモデル
| モデル | 最適な用途 | 入力 | コスト |
|---|---|---|---|
seedance2 | 参照画像と動画、長時間（最大15秒） | テキスト、画像、および／または動画 | 36クレジット／秒 |
gen4.5 | 高品質、汎用 | テキストおよび／または画像 | 12クレジット／秒 |
gen4_turbo | 高速、画像ベース | 画像必須 | 5クレジット／秒 |
gen4_aleph | 動画編集／変換 | 動画＋テキスト／画像 | 15クレジット／秒 |
veo3 | プレミアム品質 | テキスト／画像 | 40クレジット／秒 |
veo3.1 | 高品質な Google モデル | テキスト／画像 | 20～40クレジット／秒 |
veo3.1_fast | 高速な Google モデル | テキスト／画像 | 10～15クレジット／秒 |
モデル選択の指針
ユーザーのリクエストに応じて選択します：
- 「商品広告」、「eコマース」、「長尺動画」→
seedance2 - 「高速」、「安価」、「手早く」→
veo3.1_fastまたはgen4_turbo（画像がある場合） - 「高品質」、「最高」、「シネマティック」→
gen4.5またはveo3 - 「動画を編集」、「動画を変換」→
gen4_alephまたはseedance2 - 希望の指定なし →
seedance2
パラメーター
| パラメーター | 説明 | デフォルト |
|---|---|---|
--prompt | テキストによる説明（必須） | -- |
--filename | 出力ファイル名（必須） | -- |
--model | 動画モデル | gen4.5 |
--ratio | アスペクト比（ピクセル単位）。一般的な値：1280:720、720:1280、960:960。seedance2 は 1112:834、834:1112、1470:630 などにも対応しています。 | 1280:720 |
--duration | 秒単位の長さ（モデルにより異なります。seedance2 は最大15秒に対応） | 5 |
--image-url | 画像から動画を生成する場合の画像 URL またはローカルファイル | -- |
--video-url | 動画から動画を生成する場合の動画 URL またはローカルファイル（gen4_aleph、seedance2） | -- |
--output-dir | 出力ディレクトリ | cwd |
API 認証情報には
RUNWAYML_API_SECRETのみを使用します。シェルの履歴やプロセス一覧に秘密情報が残らないよう、--api-keyフラグはありません。
ファイル名の規則
次の形式でファイル名を生成してください：yyyy-mm-dd-hh-mm-ss-name.mp4
例：
- 「サイバーパンクの街」→
2026-04-14-14-23-05-cyberpunk-city.mp4 - 「ビーチの波」→
2026-04-14-15-30-12-beach-waves.mp4
例
テキストから動画を生成（seedance2）：
uv run scripts/generate_video.py --prompt "A serene mountain landscape at sunrise with mist" --filename "2026-04-14-mountain-sunrise.mp4" --model seedance2 --ratio 1280:720
画像から動画を生成（ローカルの商品写真をアニメーション化）：
uv run scripts/generate_video.py --prompt "Camera slowly zooms out, product sparkles" --image-url "./product.jpg" --filename "2026-04-14-product-reveal.mp4" --model seedance2 --ratio 720:1280
ローカルファイルから動画を動画に変換（seedance2）：
uv run scripts/generate_video.py --prompt "Transform into a warm golden sunset scene" --video-url "./input.mp4" --filename "2026-04-14-sunset-transform.mp4" --model seedance2
高速ドラフト：
uv run scripts/generate_video.py --prompt "A cat playing piano" --filename "draft.mp4" --model veo3.1_fast --ratio 1280:720 --duration 4
プレミアム品質：
uv run scripts/generate_video.py --prompt "Cinematic drone shot over Tokyo at night" --filename "tokyo.mp4" --model veo3 --ratio 1280:720 --duration 8
出力
- スクリプトが結果をダウンロードし、指定したパスに保存します
- スクリプトは保存したファイルのフルパスを出力します
- 動画ファイルを読み返さないでください。保存先のパスをユーザーに伝えるだけで十分です
よくあるエラー
Error: No API key→ 環境にRUNWAYML_API_SECRETを設定してください（例：export RUNWAYML_API_SECRET=...または.envファイル）。Error: Task failed -- SAFETY.INPUT.*→ コンテンツモデレーションによるエラーです。別のプロンプトを提案してください。Error: Task failed -- ASSET.INVALID→ 入力ファイルの形式が不正です。画像／動画の形式を確認してください。API error 429→ レート制限です。スクリプトが自動的に再試行します。
バッチ生成の場合
一度に多数の動画を生成するには、このスクリプトをループで実行します。エージェントは、異なるプロンプト、画像、パラメーターを使った複数の呼び出しをオーケストレーションし、キャンペーンやローカライズ版、クリエイティブの反復案を大規模に作成できます。
コメント
Markdown 対応