rw-fetch-api-reference について
rw-fetch-api-referenceは、Runway APIの統合方法を案内したりコードを書いたりする前に、最新ドキュメントを取得するスキルです。API情報の変更や手元の資料との食い違いがある場合、取得した資料を優先します。
主な機能
- 01最新のRunway APIリファレンスを取得
- 02統合作業の前にオンライン資料を確認
- 03資料記載のパスとパラメーターを優先
- 04再取得が必要なタイミングを提示
- 05取得資料をローカル資料より優先
活用シーン
- 01新しいRunway API統合の準備
- 02APIエラー後のエンドポイント確認
- 03リクエスト項目とモデルIDの確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/rw-fetch-api-referenceを入力して読み込まれたか確認します。
詳細
最新の API リファレンスを取得する
Runway API の統合を案内または実装する前に、必ず最新の API リファレンスを取得し、信頼できる情報源として使用してください。
重要な理由
Runway API は公式リファレンスです。モデル、エンドポイント、リクエスト／レスポンスの形式、バージョン管理は変更される場合があります。最新のドキュメントを使用することで、統合に関する案内やコードを最新の API に適合させられます。
手順
1. API リファレンスを取得する
次の内容を取得します。
https://docs.dev.runwayml.com/api/
利用可能な取得ツール（例：mcp_web_fetch または同等のもの）を使用して、この URL を読み込みます。このページには、エンドポイント、リクエストボディ、受け付ける値、使用例を含む API リファレンス全体が記載されています。
2. 統合の前に使用する
- 動画、画像、音声、アップロード、キャラクター、ドキュメント、その他の Runway API 機能について、統合コードを記述または提案する前に、取得した内容を信頼できる情報源として使用してください。
- キャッシュされたドキュメントやローカルのドキュメントよりも、取得したリファレンスに記載されている正確なエンドポイントパス、モデル ID、パラメーター名、ヘッダー値を優先してください。
- 取得した内容が他のスキル（例：
+rw-api-referenceや統合スキル）のテキストと異なる場合、そのセッションでは取得したドキュメントを優先してください。
3. 再取得するタイミング
- ユーザーから新しい機能の統合を依頼された場合や、エンドポイントまたはパラメーターが不明な場合は、再取得してください。
- API の変更が原因と考えられるエラー（例：無効なモデル名、変更されたリクエスト形式）がユーザーから報告された場合は、再取得してください。
取得後
取得したリファレンスを実装の指針として、該当する統合スキル（+rw-integrate-video、+rw-integrate-image、+rw-integrate-audio、+rw-integrate-uploads、+rw-integrate-characters、+rw-integrate-documents、+rw-integrate-character-embed）に従ってください。
重要な注意事項
- API のベース URL は
https://api.dev.runwayml.comです。 - すべてのリクエストで
Authorization: Bearer <RUNWAYML_API_SECRET>とX-Runway-Version: 2024-11-06（または取得したドキュメントに記載されているバージョン）が必要です。 - ユーザーが統合を行う際は、同梱またはリポジトリ内の API 概要だけに頼らないでください。最新のドキュメントが信頼できる情報源です。