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…