# Boelabs AI Gateway — Um contrato para todos os provedores de modelos

> Gateway de inteligência artificial open source: uma API compatível com a OpenAI na frente de OpenAI, Anthropic, Google e outros, com roteamento, fallbacks, chaves virtuais, orçamentos, cache e custo por requisição.

URL: https://boelabs.com/pt/ai-gateway
Language: Português (pt-BR) — also in: [Español](https://boelabs.com/ai-gateway.md?lang=es) · [English](https://boelabs.com/ai-gateway.md?lang=en) · [Français](https://boelabs.com/ai-gateway.md?lang=fr)

Uma única API estável e compatível com a OpenAI na frente de todos os provedores que sua equipe usa. Seu app mantém uma integração; o gateway cuida de autenticação, roteamento, limites, orçamentos, cache, custos e observabilidade.

- [Ver no GitHub](https://github.com/boelabs/ai-gateway)

## Trocar de provedor deixa de ser um release

| Sem gateway | Com AI Gateway |
| --- | --- |
| Um SDK e um esquema de autenticação por provedor | Um contrato compatível com a OpenAI para todos |
| Quedas do provedor chegam aos seus usuários | Pools ponderados, cooldowns, novas tentativas e fallbacks |
| Chaves do provedor espalhadas em cada serviço | Chaves virtuais com permissões, limites e orçamentos |
| Gasto e latência só aparecem na fatura | Custo por requisição, logs e OpenTelemetry |
| Migrar de provedor é mudança de código | Migrar de provedor é mudança de configuração |

## Tudo o que fica entre seu app e os modelos

### Contratos públicos

Os formatos exatos da OpenAI para chat, Responses, imagens, embeddings, áudio, vídeo, reranking e modelos, mais um /v1/messages compatível com a Anthropic.

### Provedores

OpenAI, Anthropic, Google AI Studio, Azure, Vercel AI Gateway, OpenRouter, DeepSeek e outros, ou qualquer endpoint compatível com a OpenAI.

### Roteamento

Aliases públicos sobre pools ponderados de implantações, com cooldowns, novas tentativas e cadeias de fallback explícitas.

### Controle de acesso

Uma chave mestra para operar e chaves virtuais por cliente, com modelos permitidos, limites por minuto e orçamentos.

### Operação

Cache opcional, logs duráveis, contabilidade de custo por requisição e métricas e traces com OpenTelemetry.

### Extensões

Hooks de requisição, resposta e streaming carregados em tempo de execução pela Admin API, sem fazer fork do gateway.

## Traduz, roteia e executa

1. **Traduz**: Cada requisição, venha do contrato da OpenAI ou da Anthropic, vira uma única representação canônica.
2. **Roteia**: O roteador escolhe uma implantação do pool do alias conforme a estratégia, os cooldowns e os fallbacks configurados.
3. **Executa**: Um adaptador por provedor fala o protocolo dele; nada específico do provedor vaza para o núcleo nem para a sua resposta.

## Seu para rodar onde quiser

Licença MIT. Imagens publicadas que só precisam de Postgres e Redis, e um painel de operação opcional no próprio domínio para modelos, chaves, logs, uso e um playground.

- Por trás dos nossos próprios produtos, em produção.
- Uma única imagem é promovida entre ambientes: a configuração não fica nela.
- Antes da 1.0 ainda pode haver mudanças incompatíveis.

- `ghcr.io/boelabs/ai-gateway-api`: A API
- `ghcr.io/boelabs/ai-gateway-dashboard`: O painel de operação

[GitHub](https://github.com/boelabs/ai-gateway)