モデル ID とバリアント

api14 のモデル ID は、openai/gpt-5-mini のように provider/model の形式です。すべてのリクエストの model フィールドに ID を渡します。

{ "model": "anthropic/claude-sonnet-4.5" }

モデル ID の調べ方

• モデルページで、すべてのモデルの ID、価格、コンテキスト長、機能を確認できます。
• コードから GET /models を呼び出します。?category=image でカテゴリを絞り込めます。モデルを参照してください。

いくつかの例です。

ID は大文字と小文字を区別します。不明または無効化された ID は 404 model_not_found を返します。

バリアント

バリアントは、コロンの後ろに付けるサフィックスで、リクエストの処理方法を変えます。バリアントは同じベースモデルで機能し、ベースモデルの提供状況と許可リストのルールが適用されます。

{ "model": "openai/gpt-5-mini:online" }

:nitro と :floor はプロバイダーの並べ替えのショートカットで、それぞれ provider: { sort: "throughput" } と provider: { sort: "price" } と同じです。プロバイダールーティングとフォールバックを参照してください。

モデルのフォールバック

models 配列を送ると、最初のモデルが失敗または利用不可のときに別のモデルを試します。

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

リスト内のすべてのモデルが利用可能で、キーとプランで許可されている必要があります。そうでない場合、リクエストは送信前に拒否されます。レスポンスの model フィールドでどのモデルが応答したかが分かり、そのモデルの価格が課金されます。

許可リストとプラン

• モデル許可リストを設定したキーは、リストにある ID のみ使用できます。それ以外の ID は 403 model_not_allowed を返します。
• Free を含むすべてのプランが、動画や音楽・音声を含むすべてのモデルカテゴリをカバーします。特定のカテゴリに限定されたプランでは、それ以外のカテゴリで 403 plan_required を返します。料金と請求を参照してください。

モデルの変更

カタログは自動で更新されます。新しいモデルは自動的に追加され、削除されたモデルは 404 model_not_found を返します。本番環境では正確な ID を固定し、耐障害性のために models のフォールバックを使ってください。