mcpField
R
rw-generate-image

rw-generate-image

github.com/runwaymlクリエイティブ・メディア74324 回インストール2 日前に更新
リポジトリ

rw-generate-image について

rw-generate-image は、Runway API で画像を生成するスキルです。コマンドラインから画像を作成して保存したいクリエイターや開発者向けで、モデル、アスペクト比、参照画像を指定し、処理完了後に結果をダウンロードします。

主な機能

  1. 01テキストプロンプトから画像を生成
  2. 02モデルとアスペクト比の選択
  3. 03参照画像の指定
  4. 04生成タスクの確認と結果のダウンロード
  5. 05環境変数から API キーを取得

活用シーン

  1. 01文章の説明から画像を作成
  2. 02製品写真を使ったシーン画像の作成
  3. 03参照画像を基にしたビジュアル案の生成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/runwayml/skills --skill rw-generate-image

インストール後、Claude Code で/rw-generate-imageを入力して読み込まれたか確認します。

詳細

画像を生成する

Runway API を直接使用して画像を生成します。このスキルは、API を呼び出して完了までポーリングし、結果をダウンロードする Python スクリプトを実行します。

重要： 出力ファイルがユーザーの想定する場所に保存されるよう、ユーザーの作業ディレクトリからスクリプトを実行してください。

使用方法

uv run scripts/generate_image.py --prompt "your description" --filename "output.png" [--model gen4_image] [--ratio 1280:720] [--reference-images Tag=URL ...]

事前確認

  1. command -v uv が成功すること
  2. 環境に RUNWAYML_API_SECRET が設定されていること。API キーを CLI フラグとして渡さないでください。シェル履歴やプロセス一覧に漏れるおそれがあります。

セキュリティに関する注意

  • --reference-images Tag=URL は、Runway API 経由で任意のリモート画像を取得します。ローカルのファイルパス（runway:// URI としてアップロードされます）を優先するか、信頼できる URL のみを渡してください。
  • 生成された出力を下流の自動化に渡す場合は、信頼できないものとして扱ってください。取り込まれた参照画像は結果に影響します。

利用可能なモデル

モデル最適な用途参照画像コスト速度
gen4_image最高品質任意（最大3枚）5-8クレジット標準
gen4_image_turbo高速かつ低コスト必須（1-3枚）2クレジット高速
gemini_2.5_flashGoogle Gemini任意（最大3枚）5クレジット標準

モデル選択の指針

  • 「高速」「安価」「ドラフト」 -> gemini_2.5_flash（Nano Banana）、または参照画像がある場合は gen4_image_turbo
  • 「高品質」「最高」 -> gen4_image
  • 指定がない場合 -> gemini_2.5_flash
  • 参照画像があり、低コストを希望する場合 -> gen4_image_turbo（2クレジット、--reference-images が必要）

パラメーター

パラメーター説明デフォルト
--promptテキストによる説明（必須）--
--filename出力ファイル名（必須）--
--model画像モデルgemini_2.5_flash
--ratioアスペクト比。gemini_2.5_flash：1344:768、768:1344、1024:1024 など。gen4_image：1280:720、1360:768、1920:1080 など。モデルに依存（gemini は 1344:768、その他は 1280:720）
--reference-imagestag=URL のペアで指定する参照画像（gemini/gen4_image では任意、gen4_image_turbo では必須）。タグは小文字で3〜16文字。例：product=URL--
--output-dir出力ディレクトリcwd

API 認証情報には RUNWAYML_API_SECRET のみを使用します。シェル履歴やプロセス一覧にシークレットが残らないよう、--api-key フラグはありません。

ファイル名の規則

形式：yyyy-mm-dd-hh-mm-ss-name.png

例

基本的な画像：

uv run scripts/generate_image.py --prompt "A serene Japanese garden with cherry blossoms" --filename "2026-04-14-japanese-garden.png"

ローカルの参照画像を使用する場合（gen4_image）：

uv run scripts/generate_image.py --prompt "@product on a marble counter, lifestyle photo" --model gen4_image --reference-images product=./product.jpg --filename "2026-04-14-product-lifestyle.png"

信頼できる配信元の参照画像を使用する場合（gen4_image_turbo — 参照画像が必要）：

uv run scripts/generate_image.py --prompt "A neon sign reading SALE in @style" --model gen4_image_turbo --reference-images style=https://cdn.yourapp.com/style.jpg --filename "draft.png"

出力

  • スクリプトは結果をダウンロードし、指定されたパスに保存します
  • スクリプトは保存したファイルのフルパスを出力します
  • 画像ファイルを読み戻さないでください。保存先のパスをユーザーに伝えるだけにしてください

よくあるエラー

  • Error: No API key -> 環境に RUNWAYML_API_SECRET を設定してください（例：export RUNWAYML_API_SECRET=... または .env ファイル）。
  • Error: Task failed -- SAFETY.INPUT.* -> コンテンツモデレーションによるエラーです。別のプロンプトを提案してください
  • API error 429 -> レート制限です。スクリプトが自動的に再試行します

コメント

Markdown 対応