Modelos e grupos

Dois identificadores são importantes em cada solicitação:

1. O ID do modelo no corpo JSON, que deve corresponder exatamente a um ID de catálogo público.
2. O grupo de roteamento vinculado à sua chave de API, que decide quais rotas de serviço podem servir esse modelo.

Sua solicitação

O ID do modelo no corpo JSON deve corresponder exatamente a um ID de catálogo público.

Chave API

Nomeia um grupo primário e, opcionalmente, grupos substitutos em ordem de prioridade.

Grupo de roteamento

Um conjunto de canais de provedores de serviços. Se nenhum deles atender a esse modelo, a solicitação falhará.

Canal do provedor de serviços

O grupo tenta suas próprias prioridades de canal em ordem antes que um grupo substituto seja usado.

Ambos os identificadores devem concordar: um corpo JSON válido ainda falha quando o grupo da chave não possui canal para aquele modelo.

O catálogo ativo é Modelos e preços. Este site de documentação não substitui preços ou disponibilidade.

IDs exatos do modelo

Use o ID mostrado na página de preços ou na página do catálogo de modelos. Não substitua o nome comercial do fornecedor, um sufixo de data ou uma variante próxima.

Os modelos de bate-papo que compartilham o contrato Chat Completions ou Responses compatível com OpenAI são documentados em Qual endpoint chamar e os guias do cliente, não duplicando uma página por modelo. Os modelos de imagem e vídeo que possuem seu próprio envelope de solicitação possuem páginas de modelo e páginas de catálogo.

Grupos

Crie a chave API em um grupo não padrão que liste o modelo. Não há um único grupo obrigatório. Se o grupo da chave não puder atender ao modelo, a solicitação falhará mesmo quando o JSON for válido.

A ordem de fallback é uma propriedade do grupo, não do corpo da solicitação. Consulte Uso e custo para saber como as cobranças são registradas.