Tovanix
Tovanix

Pasarela de API de IA

Un solo token para Claude, GPT, Gemini y Qwen, totalmente compatible con el SDK oficial de cada proveedor; migrar suele implicar cambiar dos líneas: base_url y api_key.

  • Compatibilidad de protocolo: llama directamente a los protocolos nativos de OpenAI, Anthropic y Gemini, sin reescribir nada
  • Streaming: streaming SSE completo con latencia del primer token equivalente a ir directo
  • Catálogo de modelos: modelos disponibles con ventanas de contexto y capacidades (visión / herramientas / razonamiento)
  • Uso y facturación: facturación por token con desglose de uso por clave

Un gateway unificado multiproveedor con 3 protocolos oficiales de entrada: Anthropic / OpenAI / Gemini. Con cualquiera de los tres formatos puedes llamar a todos los modelos del gateway. Se factura por uso de tokens × precio oficial × el multiplicador del grupo de precios que usa tu clave, sin cuota mensual fija.

Información básica

  • Authorization: Bearer sk-nc-... (Gemini también admite x-goog-api-key / ?key=)
  • Tras iniciar sesión, crea una en la página "Servicios de IA → Claves API"
  • Precio oficial en USD/MTok × el multiplicador del grupo de precios; si el grupo tiene horas fuera de pico, las solicitudes hechas en ese horario se multiplican además por el multiplicador fuera de pico. Prededucido del saldo; las llamadas en streaming se liquidan de forma asíncrona al terminar
  • Llamar a GPT con el SDK de Anthropic o llamar a Claude con el SDK de OpenAI: ambos son compatibles, el gateway traduce los protocolos automáticamente

3 formatos de llamada

Anthropic /v1/messages

Usa el protocolo messages de Claude; el SDK más adoptado (@anthropic-ai/sdk / anthropic para Python)

OpenAI /v1/chat/completions

Protocolo Chat Completions de OpenAI; admite tools / streaming / multimodal

Gemini /v1beta/models/...

Protocolo nativo de Google Gemini; el modelo en la ruta determina el enrutamiento

Niveles de servicio y de velocidad

El gateway siempre reenvía las solicitudes en el nivel estándar y factura el precio estándar; no hay niveles con descuento ni más rápidos:

  • Se elimina service_tier (flex / fast / priority, etc.) del cuerpo de las solicitudes en formato OpenAI
  • Se elimina speed (modo rápido) del cuerpo de las solicitudes en formato Anthropic
  • El encabezado X-Service-Tier no tiene efecto; las solicitudes que lo envían se procesan en el nivel estándar

Códigos de error

  • 401 — Clave API inválida o desactivada
  • 402 insufficient_balance — Saldo insuficiente: el saldo disponible (tras cargos sin liquidar) es ≤ 0 o no alcanza para el monto reservado de esta solicitud (estimado con los límites de contexto y salida del modelo, más «búsquedas máximas × precio unitario» si usa búsqueda web del lado del servidor); el mensaje de error indica la reserva necesaria y el saldo disponible. Recarga y vuelve a intentarlo. Cuando el saldo disponible baja de $5, las respuestas incluyen X-Tovanix-Balance-Low: 1 y X-Tovanix-Balance-Available (USD) para avisar con antelación
  • 402 quota_exceeded — Se alcanzó el límite de gasto mensual de la clave; se restablece el mes siguiente. También puedes cambiarlo con «Cambiar límite» en la página «Claves API» de la consola (requiere verificar tu identidad)
  • 403 group_unavailable — El grupo de precios que esta clave usa para el proveedor del modelo está desactivado. Cambia la clave a otro grupo en la página Claves API; el gateway nunca te pasa a otro grupo por su cuenta
  • 503 no_upstream_available — El modelo no tiene ninguna ruta disponible en el grupo de precios que usa tu clave (las rutas están desactivadas o en enfriamiento temporal). Reintenta más tarde o, si ese proveedor tiene varios grupos, cambia la clave a otro grupo en la página Claves API
  • 502 — El servicio del modelo no está disponible temporalmente o devolvió una respuesta que no se pudo interpretar; reintenta más tarde

Más endpoints

Además del chat, el gateway también ofrece:

GET /v1/models

Lista los modelos enrutables actualmente (compatible con OpenAI; funciona con models.list() del SDK)

POST /v1/embeddings

Embeddings de texto (compatible con OpenAI; envía input y recibe vectores; se factura por token)

Ejemplos en Python / Node.js

Para el Playground completo, los precios y los registros de llamadas, ve a Centro de usuario → Servicios de IA.

Preguntas frecuentes

¿Cuánto código cambia al migrar desde la API de un proveedor?

Normalmente solo base_url y api_key. La pasarela es compatible directamente con los SDK y protocolos oficiales: los cuerpos de solicitud, las formas de respuesta y los formatos de streaming se mantienen iguales.

¿Se admite streaming?

Sí. El streaming SSE está totalmente soportado, stream=true funciona directamente desde los SDK oficiales y la latencia del primer token es igual a la de llamar al proveedor directamente.

Páginas relacionadas: Servicios de IA · Documentación de la API · Solución de IA global

Cargando…