This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

Produtos

Models

Como chamar modelos pela plataforma: o catálogo, os identificadores usados na API e as regras de liberação por workspace.

O campo model da API recebe o identificador exatamente como na tabela. A lista do seu workspace sai de GET /v1/models.

ProvedorIdentificadores
Anthropicclaude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5
OpenAIgpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.4-mini, gpt-5.4-nano, gpt-5-mini, gpt-4.1, gpt-4.1-mini, gpt-4o-mini
Google Cloudgemini-3.8-flash, gemini-3.5-flash-lite, gemini-3.1-flash-lite
Modelos abertos (via Google Cloud)gpt-oss-120b, deepseek-v4.1-flash, glm-5.2

Nota

O catálogo muda conforme novos modelos entram. Os modelos rodam nos servidores dos provedores; o processamento pode acontecer fora do Brasil.

#Liberação por workspace

Um modelo do catálogo só responde se estiver liberado no workspace da chave. Uma organização nova começa com claude-sonnet-5-5, gpt-4o-mini e um modelo de embeddings; os demais, o dono ou um administrador libera em Configurações → Modelos liberados (veja Orçamento e modelos liberados). Também é possível restringir modelos por papel, área e pessoa.

  • Modelo fora da lista do workspace: 403 model_not_allowed.
  • Modelo restrito para quem chama: 403 model_restricted.

#Rotas

Uma rota é um apelido do workspace que aponta para um ou mais modelos, com reserva: se o primeiro falhar ou estiver sem orçamento, o Gateway tenta o seguinte. No código, você usa o nome da rota no lugar do modelo, e troca o modelo por trás sem mexer na aplicação.

#Conexão da própria empresa

Também é possível usar modelos com a conexão da própria empresa com um provedor. Nesse caso o consumo é pago direto ao provedor, fora da cobrança em reais, e as políticas e a auditoria da plataforma continuam valendo.