Introdução ao Gateway de IA do ServBay (AI Gateway)

O Gateway de IA do ServBay (AI Gateway) é um gateway local unificado de provedores de IA integrado ao ServBay. Ele executa um endpoint de proxy na sua máquina e centraliza as requisições destinadas a diversos provedores de LLM (OpenAI, Anthropic, DeepSeek, Qwen e quase 20 outros) em um único ponto de entrada, ajudando você a gerenciar chaves de forma centralizada, acompanhar uso e custos e apontar ferramentas de programação com IA, como Claude Code e Codex, para o gateway local com um clique.

Este documento apresenta o que é o Gateway de IA, quais problemas ele resolve e sua arquitetura geral. Para instruções específicas, consulte:

• Gerenciar canais — Adicione e configure cada provedor
• Chaves virtuais — Crie, limite permissões, faça rotação e revogue chaves
• Assumir ferramentas de programação com IA com um clique — Aponte CLIs como o Claude Code para o gateway
• Estatísticas e monitoramento — Uso, custos e orçamento
• Endpoints e variáveis de ambiente — Chame o gateway no seu próprio código

Visão geral

No desenvolvimento diário com IA, você pode manter chaves de API de vários provedores ao mesmo tempo, espalhadas por diferentes projetos e arquivos de configuração de ferramentas, o que dificulta tanto calcular os gastos quanto alternar entre elas de forma unificada. O Gateway de IA do ServBay reúne esses problemas em um só lugar:

• Uma entrada, vários provedores — Depois de configurar os canais de cada provedor, todas as requisições são encaminhadas pelo endereço local http://127.0.0.1:11580; seu aplicativo lida com apenas um endereço.
• Chaves virtuais no lugar de chaves reais — O gateway emite "chaves virtuais" para aplicativos e ferramentas; as chaves de API reais dos provedores ficam armazenadas apenas no lado do gateway, sem ficarem espalhadas. As chaves virtuais podem ter permissões limitadas, ser rotacionadas e revogadas a qualquer momento.
• Visão unificada de uso e custos — Todas as requisições que passam pelo gateway são registradas. O gateway oferece estatísticas de número de requisições, uso de tokens, custos, latência, uso multimodal e muito mais, além de suporte a gerenciamento de orçamento.
• Assuma o controle das principais ferramentas de programação com IA com um clique — Sem editar arquivos de configuração manualmente, o gateway pode apontar ferramentas como Claude Code, Codex, Qwen Code, Kimi CLI, CodeBuddy, opencode e Crush para o gateway local com um clique.
• Rastreamento de contas de assinatura e cotas — Suporta a vinculação de contas de provedores por assinatura (como autorização OAuth do Claude Pro / Max), exibe de forma visual no gateway as informações do plano, endpoints disponíveis e limites de comprimento de saída, além de rastrear em tempo real cotas em múltiplas janelas (percentual usado / restante, status de esgotamento da cota e horário de redefinição), para você acompanhar o saldo da assinatura a qualquer momento.
• Detecção de capacidades do canal e roteamento inteligente — Ao adicionar um canal, o gateway detecta automaticamente os recursos do provedor (tipo autorização OAuth / tipo plano de codificação / tipo modelo por níveis) e, após confirmação, grava automaticamente o mapeamento de três níveis do gateway conforme o resultado da detecção, sem precisar adivinhar manualmente a compatibilidade dos modelos.

Arquitetura e portas

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

Porta	Finalidade	Descrição
11580	Porta de proxy	Entrada unificada para aplicações. Seu código e as ferramentas de IA gerenciadas pelo gateway enviam requisições para cá; o gateway roteia para o canal do provedor correspondente conforme as permissões da chave virtual.
11581	Porta de gerenciamento	Usada internamente pelo aplicativo ServBay para gerenciar canais, chaves e estatísticas; geralmente não é necessário acessá-la diretamente.

A porta de proxy também oferece endpoints compatíveis com vários formatos (compatível com OpenAI, compatível com Anthropic, compatível com Gemini). Consulte Endpoints e variáveis de ambiente para mais detalhes.

Canais de provedores compatíveis

O Gateway de IA inclui quase 20 predefinições de provedores, agrupadas por categoria, que podem ser selecionadas diretamente ao adicionar um canal:

• Principais (Mainstream): OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• China: DeepSeek, Qwen, Zhipu GLM, Kimi (Moonshot AI), Doubao·Volcano, ERNIE Bot, Hunyuan, MiniMax, 01.AI, StepFun. Entre eles, Qwen, Zhipu GLM, Kimi, Doubao·Volcano, Hunyuan, MiniMax e StepFun oferecem suporte à alternância entre endpoints de região China / global.
• Locais (Local): Ollama (padrão 127.0.0.1:11434), LM Studio (padrão 127.0.0.1:1234).
• Personalizados (Custom): OpenAI Compatible (qualquer serviço compatível com OpenAI), Custom (totalmente personalizado).

Consulte Gerenciar canais para ver o fluxo completo de adição e configuração.

Pré-requisitos

• Ter o ServBay instalado e em execução no macOS ou Windows.
• O Gateway de IA é um recurso de valor agregado do ServBay. É necessário fazer login na conta ServBay antes de adicionar canais / chaves. Se você não estiver conectado, a interface orientará você a concluir o login.

TIP

O Gateway de IA tem funcionalidades idênticas no ServBay for macOS e no ServBay for Windows. A porta de proxy (11580), a porta de gerenciamento (11581) e os caminhos dos arquivos de configuração das ferramentas gerenciadas são os mesmos. Diferenças entre plataformas serão indicadas separadamente na documentação.

Conta e planos

Alguns recursos do Gateway de IA estão vinculados ao plano da conta ServBay:

• Limite de canais / chaves — Os planos gratuitos e pagos diferem na quantidade de canais e chaves virtuais que podem ser criados. Ao atingir o limite, a interface exibirá um aviso para fazer upgrade.
• Gerenciamento de cotas e orçamento — Limites por cota (tokens / número de requisições / valor) e o painel de orçamento são recursos VIP / pagos. Sem assinatura, as áreas correspondentes ficam bloqueadas e exibem um aviso para upgrade.

Para detalhes dos planos, consulte ServBay Pro e ServBay Team.

Contas de assinatura e rastreamento de cotas

O Gateway de IA permite vincular contas de provedores por assinatura (como Claude Pro / Max conectadas via autorização OAuth), para que você visualize e gerencie esses recursos de assinatura diretamente no gateway local, sem precisar acessar o console web de cada provedor.

O que as contas de assinatura permitem fazer

• Informações do plano em um relance — Exibe o nome do plano de assinatura, a estrutura de cobrança e o período de validade.
• Endpoints disponíveis e limites de saída — Veja a lista de endpoints que a conta de assinatura pode chamar e o limite máximo de comprimento de saída de cada modelo.
• Rastreamento de cotas em múltiplas janelas — Mostra visualmente o percentual de cota usado / restante, se a cota atual foi esgotada e o horário de redefinição, ajudando você a distribuir melhor os recursos da assinatura.
• Credenciais inválidas visíveis — Quando as credenciais de autorização da conta de assinatura expiram ou ficam inválidas, a interface as marca claramente, lembrando você de autorizar novamente.

Recurso experimental

A conexão de contas de assinatura via autorização OAuth é atualmente um recurso experimental, e os provedores suportados serão expandidos gradualmente. Durante a autorização, você precisa concluir o fluxo OAuth do provedor no navegador; o token de autorização é armazenado apenas localmente.

Armazenamento de dados

• Configurações de canais, chaves virtuais, estatísticas de uso e outros dados são mantidos localmente pelo serviço de backend do gateway.
• O texto claro da chave virtual é exibido apenas uma vez, no momento da criação (ou rotação). Depois disso, o gateway mantém apenas o prefixo para identificação. Certifique-se de copiar e salvar a chave imediatamente após a criação.
• Ao assumir o controle de cada ferramenta com um clique, o gateway primeiro faz backup do arquivo de configuração original da ferramenta de destino com o sufixo .bak e, em seguida, grava a configuração que aponta para o gateway local, facilitando a restauração a qualquer momento.

Fluxo de uso típico

1. Faça login na conta ServBay e acesse o Gateway de IA.
2. Na página Canais, adicione pelo menos um canal de provedor (como OpenAI ou DeepSeek), insira a chave de API real e teste a conectividade.
3. Na página Chaves virtuais, crie uma chave virtual e limite, conforme necessário, os modelos / canais disponíveis e a taxa de requisições.
4. Na página Endpoints, insira a chave virtual no seu aplicativo ou use o Assumir com um clique na mesma página para configurar suas ferramentas de programação com IA usuais.
5. Na página Estatísticas e monitoramento, acompanhe uso, custos e latência e defina um orçamento se necessário.

Resumo

O Gateway de IA do ServBay transforma o cenário fragmentado do desenvolvimento com IA — "vários provedores, várias chaves, várias ferramentas" — em "uma entrada local, um conjunto de chaves virtuais, uma única visão de uso". Ele permite gerenciar capacidades de IA com segurança e de forma centralizada no ambiente local, ter controle preciso dos custos e conectar diversos tipos de ferramentas de programação com IA a um gateway unificado com o mínimo de esforço, sendo um dos principais recursos do ServBay para o desenvolvimento AI-native.