モデルを選ぶ

すべてのリクエストにモデル ID を指定します。表示名を記憶に頼って入力せず、最新の Models ページから正しい ID をコピーしてください。

{
  "model": "MODEL_ID"
}

モデル ID と表示名の違い

モデルカードには、API で使用する識別子とともに、わかりやすい表示名が記載されている場合があります。リクエストやツールの設定には、モデル ID を使用してください。

クライアント側で明示的に正規化されない限り、モデル ID では大文字と小文字が区別されます。記号、プレフィックス、バージョンサフィックスをそのまま入力してください。

モデルとエンドポイントを対応させる

必要な機能に対応したモデルを選んでください。

  • チャットまたはテキスト生成
  • Responses ベースのエージェントワークフロー
  • 埋め込み
  • 画像生成または編集
  • 音声生成または文字起こし
  • 動画生成
  • リランキング
  • Claude 互換 Messages
  • Gemini 互換 generateContent

あるエンドポイントで動作するモデルが、別のエンドポイントでも動作するとは限りません。

API でモデル一覧を取得する

curl https://getrouter.ai/v1/models \
  -H "x-goog-api-key: YOUR_API_KEY"

レスポンスは OpenAI 互換のモデル一覧形式です。Gemini 互換クライアントでは、次のエンドポイントを使用できます。

curl https://getrouter.ai/v1beta/models \
  -H "x-goog-api-key: YOUR_API_KEY"

ツールにモデルのドロップダウンがない場合

多くのツールではモデルを手動入力できます。Models から正しいモデル ID を貼り付けてください。ツールがキャッシュ済みの一覧を使って検証する場合は、Base URL と API キーを変更した後で、プロバイダーの更新、モデル一覧の再読み込み、またはツールの再起動を行ってください。

利用前に料金を確認する

モデルごとに課金単位や料金が異なる場合があります。長いコンテキスト、エージェントループ、大規模なメディア処理、自動化タスクを実行する前に、Pricing を確認してください。

Warning

GetRouter のモデルカタログに同じ ID が掲載されていない限り、他のプロバイダーのドキュメントからモデル ID をコピーしないでください。

次のステップ