mcpField
R
recipe-full-setup

recipe-full-setup

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

recipe-full-setup について

recipe-full-setupは、Runwayの公開APIをアプリケーションに組み込むためのガイド付きワークフローです。サーバー側の互換性確認、認証情報の設定、機能の選択、実装、テストを扱います。

主な機能

  1. 01プロジェクトとランタイムの互換性確認
  2. 02API認証情報とSDKの設定
  3. 03機能に応じた統合スキルの選択
  4. 04サーバー側APIの実装ガイド
  5. 05統合のテストと問題の切り分け

活用シーン

  1. 01Runway API利用に向けたアプリの準備
  2. 02メディア生成機能に必要なスキルの選定
  3. 03サーバー側APIルートの実装と検証

インストール

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

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

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

詳細

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

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

このレシピでは、Runway の公開 API をプロジェクトに統合する一連の手順を説明します。互換性の確認、API キーのセットアップ、API の統合を順に行います。

ワークフロー

フェーズ 1：互換性の確認

+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 キーのセットアップ

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

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

API キーを取得したことをユーザーが確認するまで、先に進まないでください。

フェーズ 3：統合する内容を決める

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

ユーザーの要望...使用するスキル
テキストから動画を生成する+integrate-video（テキストから動画）
画像をアニメーション化して動画にする+integrate-video（画像から動画）＋ローカルファイルの場合は +integrate-uploads
既存の動画を編集・変換する+integrate-video（動画から動画）＋ +integrate-uploads
テキストから画像を生成する+integrate-image
参照画像を使って画像を生成する+integrate-image＋ローカルの参照画像の場合は +integrate-uploads
テキスト読み上げ+integrate-audio
効果音+integrate-audio
音声の分離・吹き替え+integrate-audio＋ +integrate-uploads
リアルタイムの会話型アバター+integrate-characters＋ +integrate-character-embed（React UI）
ドメイン知識を備えたアバター+integrate-characters＋ +integrate-documents＋ +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 +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 +integrate-uploads

重要な注意事項

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

コメント

Markdown 対応