モデルティア

一部のモデルは複数のティアで提供されています。ティアは同じモデルを異なる価格で販売したもので、例えば「デフォルト」の隣に低価格のティアがあります。1つのAPIキーですべてのティアに到達できます。ティアはモデル名で選択でき、別のキーや設定では選択しません。

デフォルトティア

プレーン（末尾なし）のモデル名は常にデフォルトティアを使用します。モデルが別のティアを獲得した場合、既存のリクエストは変更されずに動作し続けます。

{ "model": "gpt-image-2" }

ティアを選択する

モデル名にコロンとティア ID を追加します：

{ "model": "gpt-image-2:<tier>" }

これはテキスト、画像、ビデオ、オーディオモデル、リクエストがモデルを指定するあらゆる場所で機能します：JSON本体の model フィールド、オーディオアップロードの model フォームフィールド、Geminiネイティブパスのモデルセグメント。Geminiパスではアクションが最後に来ます：

POST /v1beta/models/<model>:<tier>:generateContent

モデルのティアを見つける

• 各モデルページの価格表の上に、ティア切り替えがあり、各ティアの価格と呼び出すモデル ID が表示されます。価格が 1 つだけのページでは、代わりに 価格ティアテーブルにティアが一覧表示されます。両方とも、モデルが複数のティアを持つ場合にのみ表示されます。
• 各モデルの Markdown ガイド /models/<page>/llms.txt には、すべてのティアの完全な価格が一覧表示されます。
• GET /v1/models では、キーが複数のティアで呼び出すことができるモデルのごとに、<model> の隣に <model>:<tier> が一覧表示されます。

テキストモデルの Playground では、ティアセレクタが同じティア間で切り替わります。画像・動画・音声モデルの Playground はデフォルトティアを使用します。他のティアは API で呼び出してください。

課金と動作

• ティアリクエストはそのティアのみで実行され、そのティアの価格で課金されます。
• ティアがリクエストに対応できない場合、リクエストは失敗します。別のティアに切り替わることはないため、異なる価格で課金されることはありません。
• レスポンスとタスク結果は、プレーン（末尾なし）のモデル名を報告します。
• 1つのティア用にのみ作成されたキーは、そのティアのみを呼び出すことができ、他は呼び出せません。

エラー

レスポンスの形式はエラーを参照してください。