mcpField
R
rw-recipe-full-setup

rw-recipe-full-setup

github.com/runwayml開発74223 回インストール2 日前に更新
リポジトリ

rw-recipe-full-setup について

Runway APIをプロジェクトに組み込む開発者向けの段階的な手順です。互換性確認、認証情報の設定、機能選択、実装、テストを扱い、用途に応じた専門スキルへつなぎます。

主な機能

  1. 01サーバー機能とランタイム互換性の確認
  2. 02API認証情報とSDKの設定
  3. 03要件に応じた連携スキルの選択
  4. 04サーバールートとファイルアップロードの設計
  5. 05生成テストと一般的な問題の確認

活用シーン

  1. 01プロジェクトへのRunway API初回導入
  2. 02動画・画像・音声機能の連携方法の選択
  3. 03メディアのアップロード処理と生成結果の検証

インストール

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

$npx skills add https://github.com/runwayml/skills --skill rw-recipe-full-setup

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

詳細

Runway API の完全なセットアップ

前提条件： まず +rw-check-compatibility を実行し、プロジェクトにサーバー側の機能があることを確認してください。

このレシピでは、Runway の公開 API をプロジェクトに統合するまでの全手順を説明します。互換性チェック、API キーのセットアップ、API 統合の各スキルを連続して実行します。

ワークフロー

フェーズ 1：互換性チェック

+rw-check-compatibility を使用して、ユーザーのプロジェクトを分析します。

  1. プロジェクトの種類を特定します（Node.js、Python など）
  2. サーバー側の機能を確認します
  3. ランタイムのバージョンとの互換性を確認します
  4. Runway SDK がすでにインストールされているか確認します

プロジェクトに互換性がない場合は、処理を中止して、次の選択肢を説明します。

  • バックエンドを追加する（Express、FastAPI など）
  • フルスタックフレームワークを使用する（Next.js、SvelteKit、Nuxt、Remix）
  • サーバーレス関数を追加する（Vercel Functions、AWS Lambda）
  • 独立したバックエンドサービスを作成する

変更が必要な場合は、先に必要な変更を行えるようユーザーをサポートします。

互換性がある場合は、フェーズ 2 に進みます。

フェーズ 2：API キーのセットアップ

+rw-setup-api-key を使用して、認証情報を設定します。

  1. アカウントと API キーを作成するため、ユーザーに https://dev.runwayml.com/ へアクセスするよう案内します
  2. 適切な SDK をインストールします（Node.js の場合は @runwayml/sdk、Python の場合は runwayml）
  3. RUNWAYML_API_SECRET 環境変数を設定します
  4. .gitignore を更新して .env を除外します
  5. クレジットの購入が必要であることを伝えます（最低 $10）

API キーを取得したことをユーザーが確認するまで待ってから、次に進みます。

フェーズ 3：統合する機能を決める

ユーザーに何を作りたいか尋ねます。回答に基づいて、適切な統合スキルを使用します。

ユーザーの希望...使用するスキル
テキストから動画を生成する+rw-integrate-video（テキストから動画）
画像を動画にアニメーション化する+rw-integrate-video（画像から動画） + ローカルファイルの場合は +rw-integrate-uploads
既存の動画を編集／変換する+rw-integrate-video（動画から動画） + +rw-integrate-uploads
テキストから画像を生成する+rw-integrate-image
参照画像を使って画像を生成する+rw-integrate-image + ローカルの参照画像の場合は +rw-integrate-uploads
テキスト読み上げ+rw-integrate-audio
効果音+rw-integrate-audio
音声の分離／吹き替え+rw-integrate-audio + +rw-integrate-uploads
リアルタイムの会話型アバター+rw-integrate-characters + +rw-integrate-character-embed（React UI）
ドメイン知識を持つアバター+rw-integrate-characters + +rw-integrate-documents + +rw-integrate-character-embed
複数の機能同じクライアントインスタンスを共有しながら、それぞれを統合します
フェーズ 4：統合コードを記述する

ユーザーのフレームワークとニーズに基づいて、次の作業を行います。

  1. API ルート／ハンドラーを作成する — Runway を呼び出すサーバー側エンドポイントです
  2. ユーザーがファイルを受け付ける必要がある場合は、アップロード処理を追加します
  3. エラー処理を追加する — タスクの失敗を捕捉して処理します
  4. 出力の保存を処理する — 出力 URL は 24～48 時間で期限切れになることをユーザーに伝えます
フェーズ 5：テストと確認

次の作業をユーザーに支援します。

  1. テスト生成を実行して、すべて正常に動作することを確認します
  2. よくある問題（環境変数の不足、クレジット不足、モデルの間違い）がないか確認します
  3. 出力にアクセスできることを確認します

アップロード要件の判断ツリー

ユーザーのワークフローで画像や動画を入力として使う場合：

Does the input come from a public HTTPS URL?
├── YES → Pass the URL directly to the API
└── NO → Is it a local file or user-uploaded file?
    ├── YES → Use +rw-integrate-uploads to upload first, then pass runway:// URI
    └── NO → Is it small enough for a data URI? (< 5MB image, < 16MB video)
        ├── YES → Convert to base64 data URI
        └── NO → Use +rw-integrate-uploads

重要な注意事項

  • API キーをクライアント側のコードで決して公開しないでください。 すべての API 呼び出しはサーバー側で行う必要があります。
  • 出力 URL には有効期限があります。 生成されたコンテンツは必ずダウンロードして保存してください。
  • クレジットが必要です。 前払いクレジットがないと API は動作しません。
  • レート制限があります。 レート制限があります。同時に生成を試みる前に、必ずレート制限を確認してください。
  • 入力と出力の両方にコンテンツモデレーションが適用されます。 安全性のフラグが付いた入力は返金されません。
  • コストに配慮してください。 ユーザーが予算に合ったモデルを選べるようサポートしてください。クレジットの料金は https://docs.dev.runwayml.com/guides/pricing/ で確認できます。

コメント

Markdown 対応