模型级别

某些模型以多个级别提供。级别是以不同价格出售的相同模型，例如低成本级别和默认级别。一个 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 调用。

计费和行为

• 级别请求仅在该级别中运行，并按该级别的价格计费。
• 如果级别无法处理请求，请求将失败。它永远不会切换到另一个级别，因此永远不会按不同的价格计费。
• 响应和任务结果中的模型名称不带后缀。
• 仅为一个级别创建的密钥只能调用该级别，不能调用其他级别。

错误

有关响应形状，请参见错误。