Produtos
Models
Como chamar modelos pela plataforma: o catálogo, os identificadores usados na API e as regras de liberação por workspace.
#Catálogo
O campo model da API recebe o identificador exatamente como na tabela. A lista do seu workspace sai de GET /v1/models.
| Provedor | Identificadores |
|---|---|
| Anthropic | claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5 |
| OpenAI | gpt-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 Cloud | gemini-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.