Introdução ao ServBay AI Gateway

O ServBay AI Gateway é um gateway local unificado para fornecedores de IA integrado ao ServBay. Ele executa um endpoint proxy na sua máquina, reunindo as solicitações para diversos provedores de grandes modelos de IA (como OpenAI, Anthropic, DeepSeek, entre quase 20 fornecedores) em um único ponto de entrada. Assim, você pode gerenciar todas as suas chaves de API, monitorar uso e custos centralizadamente, além de direcionar ferramentas de programação de IA como Claude Code, Codex, Gemini CLI e outras para o gateway local com um clique.

Este documento apresenta o que é o AI Gateway, os problemas que resolve e sua arquitetura geral. Para operações detalhadas, consulte:

• Gerenciar canais — Como adicionar e configurar fornecedores
• Chaves virtuais — Criar, limitar permissões, rotacionar e revogar chaves
• Assumir ferramentas de programação IA com um clique — Direcionando CLIs como Claude Code para o gateway
• Estatísticas e monitoramento — Uso, custos e orçamento
• Endpoints e variáveis de ambiente — Usando o gateway em seu próprio código

Visão geral

No desenvolvimento de IA do dia a dia, é comum possuir chaves de API de múltiplos fornecedores, espalhadas por arquivos de configuração de diferentes projetos e ferramentas. Essa dispersão dificulta o monitoramento dos gastos e a troca centralizada dos fornecedores. O ServBay AI Gateway resolve esses desafios ao centralizá-los em um só lugar:

• Um endpoint para múltiplos fornecedores — Após configurar seus canais, todas as requisições passam pelo endereço local http://127.0.0.1:11580. Seu aplicativo só precisa se conectar a esse único endereço.
• Chaves virtuais substituem as chaves reais — O gateway emite “chaves virtuais” para seus aplicativos e ferramentas, protegendo as chaves reais dos fornecedores, que ficam armazenadas somente no gateway. As chaves virtuais podem ser restringidas, rotacionadas ou revogadas a qualquer momento.
• Visualização unificada de uso e custos — Todas as requisições passam pelo gateway, permitindo registrar e exibir estatísticas como número de requisições, uso de tokens, custos, latência e uso multimodal, com suporte a gerenciamento de orçamento.
• Assumir ferramentas de programação de IA com um clique — Sem precisar editar arquivos de configuração manualmente, o gateway permite que ferramentas como Claude Code, Codex, Gemini CLI, Qwen Code, Kimi CLI, CodeBuddy, opencode, Crush, entre outras, apontem para o gateway local automaticamente.

Arquitetura e portas

O AI Gateway é composto por dois serviços locais, ambos ouvindo apenas no endereço de loopback (127.0.0.1):

Porta	Uso	Descrição
11580	Porta do Proxy	Endpoint principal para aplicações. Seu código e ferramentas de IA direcionadas enviam requisições para cá; o gateway roteia para o fornecedor apropriado baseado nas permissões da chave virtual.
11581	Porta de Gestão	Usada internamente pelo ServBay para gerenciar canais, chaves e estatísticas. Normalmente não requer acesso direto.

O endpoint proxy fornece múltiplos formatos compatíveis (OpenAI, Anthropic, Gemini e outros). Veja detalhes em Endpoints e variáveis de ambiente.

Fornecedores suportados

O AI Gateway já inclui quase 20 fornecedores pré-configurados, organizados por categoria. Ao adicionar novos canais, basta escolher:

• Principais (Mainstream): OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• China: DeepSeek, Tongyi Qianwen, Zhipu GLM, Kimi (Moonshot), Doubao/Volcano, Wenxin Yiyan, Hunyuan, MiniMax, Zero One, StepStar. Dentre eles, Tongyi Qianwen, Zhipu GLM, Kimi, Doubao/Volcano, Hunyuan, MiniMax e StepStar oferecem suporte para alternância de região China/Global.
• Local: Ollama (padrão 127.0.0.1:11434), LM Studio (padrão 127.0.0.1:1234).
• Customizado: OpenAI Compatible (qualquer serviço compatível), Custom (totalmente personalizado).

Para o processo completo de adição e configuração, consulte Gerenciar canais.

Pré-requisitos

• Ter o ServBay instalado e em execução no macOS ou Windows.
• O AI Gateway é um recurso premium do ServBay, é necessário fazer login com sua conta ServBay antes de adicionar canais/chaves. Caso não esteja logado, o sistema irá guiá-lo para o login.

TIP

O AI Gateway oferece as mesmas funcionalidades no ServBay para macOS e Windows. As portas do proxy (11580), de gestão (11581) e os caminhos dos arquivos de configuração das ferramentas direcionadas são idênticos em ambas as plataformas. Quaisquer diferenças serão informadas separadamente na documentação.

Conta e planos

Algumas funcionalidades do AI Gateway dependem do plano da sua conta ServBay:

• Limite de canais/chaves — O número de canais ou chaves virtuais que podem ser criados varia entre os planos gratuito e pagos. Ao atingir o limite, aparecerá uma mensagem para upgrade.
• Gestão de créditos e orçamento — Limites de uso (tokens/requisições/valor) e o painel de orçamento são recursos VIP/pagos. Se não houver assinatura, as áreas correspondentes ficarão bloqueadas pedindo upgrade.

Para detalhes, consulte ServBay Pro e ServBay Team.

Armazenamento de dados

• As configurações dos canais, chaves virtuais e estatísticas de uso são mantidas localmente pelo backend do gateway.
• A chave virtual em texto claro é exibida apenas uma vez na criação (ou rotação) — após isso, apenas o prefixo é retido pelo gateway para identificação. Portanto, copie e salve a chave imediatamente após criar.
• Ao assumir o controle de ferramentas, o gateway faz backup do arquivo de configuração original com sufixo .bak antes de apontar para o gateway local, facilitando a restauração a qualquer momento.

Fluxo de uso típico

1. Acesse sua conta ServBay e entre no AI Gateway.
2. Na página Canais, adicione pelo menos um fornecedor (como OpenAI ou DeepSeek), insira uma chave de API real e teste a conexão.
3. Em Chaves virtuais, crie uma nova chave e, se necessário, restrinja modelos/canais ou defina limites de taxa.
4. Em Endpoints, insira a chave virtual em seu aplicativo ou utilize Assumir ferramentas de programação de IA com um clique na mesma página para redirecionar ferramentas de programação.
5. Em Estatísticas e monitoramento, acompanhe uso, custos e latência, e configure o orçamento conforme necessário.

Resumo

O ServBay AI Gateway centraliza o cenário fragmentado de desenvolvimento de IA — múltiplos fornecedores, várias chaves e diversas ferramentas — em um único ponto de entrada local, um conjunto de chaves virtuais e uma visualização central de uso. Assim, você consegue gerenciar recursos de IA com segurança local, controlar custos com precisão e integrar diferentes ferramentas de programação de IA ao gateway unificado de forma simples — tornando-se um dos recursos essenciais do ServBay para desenvolvedores AI-native.