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、パラメーター名、ヘッダー値を優先してください。
• 取得した内容とほかのスキル（例：+api-reference や統合スキル）の記載が矛盾する場合は、そのセッションでは取得したドキュメントを優先してください。

3. 再取得するタイミング

• ユーザーが新しい機能の統合を依頼した場合や、エンドポイントまたはパラメーターが不明な場合は、再取得してください。
• 無効なモデル名やリクエスト形式の変更など、API の変更が原因と思われるエラーをユーザーが報告した場合は、再取得してください。

取得後

取得したリファレンスを実装の指針として、該当する統合スキル（+integrate-video、+integrate-image、+integrate-audio、+integrate-uploads、+integrate-characters、+integrate-documents、+integrate-character-embed）を使用します。

重要な注意事項

• API のベース URL は https://api.dev.runwayml.com です。
• すべてのリクエストで Authorization: Bearer <RUNWAYML_API_SECRET> と X-Runway-Version: 2024-11-06（または取得したドキュメントに記載されたバージョン）が必要です。
• ユーザーが統合を行う際は、同梱またはリポジトリ内の API 概要だけに依存しないでください。最新のドキュメントが信頼できる情報源です。