Faixas de preço

Alguns modelos são oferecidos em mais de uma faixa. Uma faixa é o mesmo modelo vendido com um preço diferente, por exemplo, uma faixa de custo menor ao lado da faixa Padrão. Uma chave de API alcança todas as faixas; você escolhe uma faixa pelo nome do modelo, não por uma chave separada ou uma configuração.

Faixa Padrão

O nome do modelo simples sempre usa a faixa Padrão. As requisições existentes continuam funcionando sem alterações quando um modelo ganha outra faixa.

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

Escolha uma faixa

Anexe dois-pontos e o ID da faixa ao nome do modelo:

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

Isso funciona para modelos de texto, imagem, vídeo e áudio, em qualquer lugar onde a requisição nomeie um modelo: o campo model de um corpo JSON, o campo de formulário model de um envio de áudio, e o segmento do modelo em um caminho nativo do Gemini. Em um caminho do Gemini, a ação fica por último:

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

Encontre as faixas de um modelo

• Em cada página de modelo, um seletor de faixa aparece acima da tabela de preços e mostra os preços de cada faixa e o ID do modelo a chamar. As páginas com um único preço mostram as faixas na tabela Faixas de preço em vez disso. Ambas aparecem apenas quando o modelo tem mais de uma faixa.
• O guia Markdown /models/<page>/llms.txt de cada modelo lista os preços completos de todas as faixas.
• GET /v1/models lista <model>:<tier> ao lado de <model> para cada modelo que sua chave pode chamar em mais de uma faixa.

No Playground dos modelos de texto, o seletor de faixa alterna entre as mesmas faixas. O Playground dos modelos de imagem, vídeo e áudio usa a faixa Padrão; chame as outras faixas pela API.

Cobrança e comportamento

• Uma requisição de faixa é executada apenas naquela faixa e é cobrada pelo preço dessa faixa.
• Se a faixa não puder servir a requisição, a requisição falha. Ela nunca muda para outra faixa, então nunca é cobrada com um preço diferente.
• Respostas e resultados de tarefas relatam o nome do modelo simples.
• Uma chave que foi criada para uma única faixa pode chamar apenas essa faixa, nenhuma outra.

Erros

Veja Erros para o formato da resposta.