mcpField
S
setup-api-key

setup-api-key

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

setup-api-key について

Runway API キーの取得、Node.js または Python SDK の導入、安全な認証情報の設定を案内するスキルです。環境ファイル、キーの保護、設定の検証も扱います。

主な機能

  1. 01API キー作成の案内
  2. 02Node.js または Python SDK の導入
  3. 03環境変数の設定
  4. 04.gitignore によるキー保護
  5. 05SDK 初期化の検証

活用シーン

  1. 01プロジェクトでの Runway API アクセス設定
  2. 02統合前の認証情報管理の確認

インストール

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

$npx skills add https://github.com/runwayml/skills --skill setup-api-key

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

詳細

API キーの設定

Runway API キーの取得、SDK のインストール、API にアクセスするためのプロジェクト設定をユーザーに案内します。

前提条件： プロジェクトがサーバーサイドで実行できることを確認するため、まず +check-compatibility を実行してください。

ステップ 1：Runway 開発者アカウントを作成する

ユーザーに以下の手順を案内してください。

  1. https://dev.runwayml.com/ にアクセスします
  2. 組織を作成します（または既存の組織を使用します）
  3. Organization Settings → API Keys に移動します
  4. Create API Key をクリックします
  5. すぐにキーをコピーします — キーが表示されるのは一度だけで、再取得できません

ユーザーに伝える重要な注意事項：

  • 紛失したキーは取得できません。紛失した場合は、古いキーを無効にして新しいキーを作成してください。
  • API キーはユーザー単位ではなく、組織単位です。
  • API を使用するには、事前にクレジットを購入する必要があります。最低購入額は**$10**（1,000 クレジット、1 クレジットあたり $0.01）です。https://dev.runwayml.com/ の請求ページで購入してください。

ステップ 2：SDK をインストールする

Node.js
npm install @runwayml/sdk

Node.js 18+ が必要です。SDK には TypeScript の型定義が含まれています。

Python
pip install runwayml

Python 3.8+ が必要です。MyPy の型注釈が含まれています。

ステップ 3：環境変数を設定する

SDK は RUNWAYML_API_SECRET 環境変数から API キーを自動的に読み込みます。

オプション A：.env ファイル（開発時に推奨）

プロジェクトに .env ファイルがすでにあるか確認してください。ある場合は追記します。ない場合は作成してください。

RUNWAYML_API_SECRET=your_api_key_here

Node.js プロジェクトの場合： プロジェクトが .env ファイルを読み込むことを確認してください。

  • Next.js、Remix、Vite — .env を標準でサポートしているため、追加の設定は不要です
  • Express/Fastify/プレーンな Node — dotenv をインストールします。 
    npm install dotenv

エントリーポイントに追加します。

import 'dotenv/config';

Python プロジェクトの場合： 組み込みサポートのあるフレームワークを使用していない場合は、python-dotenv がインストールされていることを確認してください。

pip install python-dotenv

エントリーポイントに追加します。

from dotenv import load_dotenv
load_dotenv()
オプション B：システム環境変数
export RUNWAYML_API_SECRET=your_api_key_here
オプション C：クライアントに直接渡す（非推奨）
// Node.js
const client = new RunwayML({ apiKey: 'your_api_key_here' });

# Python
client = RunwayML(api_key='your_api_key_here')

ユーザーに警告してください： キーをソースコードにハードコードしないでください。環境変数またはシークレットマネージャーを使用してください。

ステップ 4：.gitignore を更新する

API キーを誤ってコミットしないよう、.env が .gitignore に含まれていることを確認してください。

.env
.env.local
.env.*.local

既存の .gitignore を確認し、エントリーがない場合は追加してください。

ステップ 5：設定を確認する

簡単な動作確認を実行するよう、ユーザーに提案してください。

Node.js
import RunwayML from '@runwayml/sdk';

const client = new RunwayML();
// If no error is thrown, the API key is configured correctly
console.log('Runway SDK initialized successfully');
Python
from runwayml import RunwayML

client = RunwayML()
# If no error is thrown, the API key is configured correctly
print('Runway SDK initialized successfully')

ステップ 6：クレジット残高を確認する

ユーザーに以下を伝えてください。

  • API を利用するには前払いクレジットが必要です
  • 最低購入額：$10（1,000 クレジット）
  • 購入先：https://dev.runwayml.com/ → Billing
  • API 経由で残高を確認できます。
// Node.js - check organization info
const response = await fetch('https://api.dev.runwayml.com/v1/organization', {
  headers: {
    'Authorization': `Bearer ${process.env.RUNWAYML_API_SECRET}`,
    'X-Runway-Version': '2024-11-06'
  }
});
const org = await response.json();
console.log('Credits:', org.creditBalance);

セキュリティチェックリスト

次に進む前に、以下を確認してください。

  • API キーがハードコードされず、環境変数に保存されている
  • .env ファイルが .gitignore に含まれている
  • API 呼び出しがサーバーサイドでのみ実行される（ブラウザーで実行されるコードではない）
  • ユーザーがクレジットを購入済みである

次のステップ

API キーを設定したら、ユーザーは連携に進めます。

  • +integrate-video — 動画生成（テキストから動画、画像から動画）
  • +integrate-image — 画像生成
  • +integrate-audio — 音声生成（TTS、効果音、音声）
  • +integrate-uploads — 画像／動画入力が必要なモデル向けのファイルアップロード

コメント

Markdown 対応