Gateway de API de IA
Um token para Claude, GPT, Gemini e Qwen, totalmente compatível com o SDK oficial de cada fornecedor — a migração geralmente exige alterar duas linhas: base_url e api_key.
- Compatibilidade de protocolos: use diretamente os protocolos nativos OpenAI, Anthropic e Gemini, sem reescrita
- Streaming: suporte completo a streaming SSE, com latência do primeiro token equivalente ao acesso direto
- Catálogo de modelos: modelos disponíveis com janelas de contexto e recursos (visão / ferramentas / raciocínio)
- Uso e faturamento: cobrança por token com detalhamento de uso por chave
Gateway unificado com 3 entradas de protocolos oficiais: Anthropic / OpenAI / Gemini. Qualquer um dos três formatos chama todos os modelos do gateway. Cobrado por tokens × preço oficial × multiplicador do grupo de preços usado pela sua chave, sem mensalidade fixa.
Informações básicas
- Authorization: Bearer sk-nc-... (Gemini também suporta x-goog-api-key / ?key=)
- Após entrar, crie em "Serviços de IA → Chaves API"
- Preço oficial USD/milhão de tokens × multiplicador do grupo de preços; se o grupo tiver horário fora de pico, as solicitações feitas nesse horário também são multiplicadas pelo multiplicador fora de pico. Pré-debitado do saldo; streaming é liquidado assincronamente ao terminar
- Chamar GPT com SDK Anthropic ou Claude com SDK OpenAI é suportado — o gateway traduz automaticamente
3 formatos de chamada
Anthropic /v1/messages
Protocolo messages de Claude; SDK amplamente adotado (@anthropic-ai/sdk / anthropic em Python)
OpenAI /v1/chat/completions
OpenAI Chat Completions; suporta tools / streaming / multimodal
Gemini /v1beta/models/...
Protocolo nativo Gemini; o modelo no caminho define o roteamento
Níveis de serviço e de velocidade
O gateway sempre encaminha as solicitações no nível padrão e cobra o preço padrão; não há níveis com desconto nem mais rápidos:
- service_tier (flex / fast / priority etc.) é removido do corpo das solicitações no formato OpenAI
- speed (modo rápido) é removido do corpo das solicitações no formato Anthropic
- O cabeçalho X-Service-Tier não tem efeito; solicitações que o enviam são tratadas no nível padrão
Códigos de erro
- 401 — API Key inválida ou desativada
- 402 insufficient_balance — Saldo insuficiente: o saldo disponível (após cobranças não liquidadas) é ≤ 0 ou não cobre o valor reservado para esta solicitação (estimado pelos limites de contexto e de saída do modelo, mais «buscas máximas × preço unitário» se usar busca na web do lado do servidor); a mensagem de erro informa a reserva necessária e o disponível. Recarregue e tente novamente. Quando o saldo disponível fica abaixo de $5, as respostas trazem X-Tovanix-Balance-Low: 1 e X-Tovanix-Balance-Available (USD) para avisar com antecedência
- 402 quota_exceeded — Limite mensal de gastos da chave atingido; reinicia no próximo mês. Também é possível alterá-lo em “Alterar limite” na página Chaves API do console (exige verificação de identidade)
- 403 group_unavailable — O grupo de preços que esta chave usa para o provedor do modelo foi desativado. Troque o grupo da chave em Chaves API; o gateway nunca muda para outro grupo por conta própria
- 503 no_upstream_available — O modelo não tem rota disponível no grupo de preços usado pela sua chave (rotas desativadas ou em espera temporária). Tente mais tarde ou, se o provedor tiver vários grupos, troque o grupo da chave em Chaves API
- 502 — O serviço do modelo está temporariamente indisponível ou retornou uma resposta que não pôde ser interpretada; tente mais tarde
Mais endpoints
Além de conversa, o gateway oferece:
GET /v1/models
Listar modelos roteáveis (compatível com OpenAI; funciona com SDK models.list())
POST /v1/embeddings
Embeddings de texto (compatível com OpenAI; envie input, receba vetores; cobrança por token)
Exemplos Python / Node.js
Para Playground completo, preços e registros, acesse Central do usuário → Serviços de IA.
Perguntas frequentes
Quanto código muda ao migrar da API de um fornecedor?
Geralmente apenas base_url e api_key. O gateway é diretamente compatível com os SDKs e protocolos oficiais — corpos de solicitação, formatos de resposta e formatos de streaming permanecem iguais.
Há suporte a streaming?
Sim. Há suporte completo a streaming SSE; stream=true funciona diretamente nos SDKs oficiais, e a latência do primeiro token equivale ao acesso direto ao fornecedor.
Páginas relacionadas: Serviços de IA · Documentação da API · Solução de IA global
Carregando…