Tovanix
Tovanix

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…