runway-dev-model-routers

Runway Dev モデルルーター

モデルルーターを使うと、アプリケーションで特定のモデルを直接指定する代わりに、保存済みのルーティング設定を参照できます。runway-dev スキルがインストールされている場合は、アカウントの設定、認証情報の取り扱い、SDK のタスクに関するガイダンスを参照してください。

既存の統合

1. アプリケーションで既に使用されている configId と、サーバー側のリクエスト経路を確認します。
2. 現在の設定やアクセス権を確認する必要がある場合は、Dev MCP を使って configId からルーターを検索し、ツールから返された識別子を使って詳細を取得します。ルーターのレコード UUID と configId は別の値です。SDK リクエストには、設定済みの configId を渡してください。
3. 最新の概要と生成ガイドを https://docs.dev.runwayml.com/model-routers/ および https://docs.dev.runwayml.com/model-routers/generating/ で確認します。ルーターのリクエストフィールドと型は、直接モデルを指定するエンドポイントとは異なります。呼び出すモダリティに対応するスキーマを使用してください。
4. ドキュメントに記載された SDK メソッド（generate.video、generate.image、または generate.audio）を、アプリケーションのサーバー境界の内側に組み込みます。create() の直後に SDK のタスク待機ヘルパーをチェーンします。
5. 課金の発生しないルーティング確認には、現在の API で HTTP の dryRun: true がサポートされています。SDK のドライラン対応はドキュメントに記載されていません。ドライラン時と実際の入力内容を一致させ、レスポンスフィールドについては最新のドキュメントを参照してください。ユーザーから課金が発生する確認を依頼または承認されていない限り、実際の呼び出しは行わないでください。

ルーターの作成または変更

ライブ MCP ツールを使って、ルーターの状態を確認または管理します。対象やルーティング設定が不明な場合は、確認してください。ユーザーが指定済みの場合は、追加の確認や JSON プレビューを求めず、依頼された作成または更新を実行します。ユーザーから生の設定を求められない限り、結果を平易な日本語で要約してください。

settings を更新すると、設定オブジェクト全体が置き換えられ、省略された任意フィールドはクリアされます。更新前に現在の設定を読み取り、ユーザーが変更を求めていない設定は維持してください。name または description だけを更新する場合、設定は変更されません。ユーザーがそのルーターの削除を既に明示的に依頼している場合を除き、削除の前に確認してください。

設定に影響する場合は、Dev MCP を使って現在利用可能なモデルと制約を確認してください。このスキル内にモデルカタログ、料金、モデルの利用可否をハードコードしないでください。課金が発生するテストを承認された場合は、テストの直前にプロジェクトのクレジット残高を確認してください。

依頼された操作には、利用可能な MCP ツールを使用します。確認には list_model_routers と get_model_router、変更には create_model_router、update_model_router、または delete_model_router、現在利用可能なモデルの確認には list_models、承認された課金テストの前には get_credit_balance、既存タスクのルーティング確認には get_task_routing を使用してください。

ルーティング結果の説明

レスポンスとタスクの詳細には、選択されたモデルや推定コストまたは実際のコストなど、ルーティング情報が含まれる場合があります。実際に何が起きたかを説明するには、ライブレスポンスまたはドキュメントに記載されたタスク確認ツールを使用してください。設定された優先条件だけを根拠に、ルーターが選択したモデルを推測しないでください。既存のタスクがなぜ特定の方法でルーティングされたのかをユーザーから尋ねられた場合は、利用可能な MCP ツールでそのルーティングの詳細を確認してください。

最新のドキュメント

• モデルルーターの概要
• ルーターを使った生成
• ルーターの設定
• Runway Dev エージェントのコンテキスト