定價層級

某些模型提供多個層級。層級是以不同價格販售的同一個模型，例如比預設層級更便宜的層級。一把 API 金鑰可以使用所有層級；你透過模型名稱選擇層級，而不是使用單獨的金鑰或設定。

預設層級

純模型名稱一律使用預設層級。當模型增加另一個層級時，既有請求保持不變地繼續運作。

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

選擇層級

在模型名稱後附加冒號與層級 ID：

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

這對文字、影像、視訊與音訊模型都有效，無論請求在哪裡命名模型：JSON 本體的 model 欄位、音訊上傳的 model 表單欄位，以及 Gemini 原生路徑的模型段。在 Gemini 路徑中，動作仍保持在最後：

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

找出模型的層級

• 在每個模型頁面上，層級選擇器位於價格表上方，顯示各層級的價格和要呼叫的模型 ID。只有單一價格的頁面改為在 定價層級 表格中列出層級。兩者只有在模型有多個層級時才會出現。
• 每個模型的 Markdown 指南 /models/<page>/llms.txt 列出了所有層級的完整定價。
• 對於你的金鑰可以用多個層級呼叫的每個模型，GET /v1/models 會在 <model> 旁列出 <model>:<tier>。

在文字模型的 Playground 中，層級選擇器會在相同的層級間切換。圖像、影片和音訊模型的 Playground 使用預設層級；其他層級請透過 API 呼叫。

計費與行為

• 層級請求只在該層級運行，並按該層級的價格計費。
• 如果層級無法提供請求，請求會失敗。它永遠不會切換到另一個層級，因此永遠不會以不同價格計費。
• 回應與任務結果回報純模型名稱。
• 只為一個層級建立的金鑰只能呼叫該層級，不能呼叫其他層級。

錯誤

請參見錯誤了解回應結構。