Endpoints de la Puerta de Enlace de IA y Variables de Entorno

Además de la opción de toma de control en un clic para herramientas de IA listas para usar, también puedes conectar tu propia aplicación, script o cualquier herramienta de IA directamente a la puerta de enlace de IA. Este documento explica los formatos de endpoint expuestos por la puerta de enlace y cómo conectarse usando claves virtuales.

Endpoint Proxy

El servicio proxy de la puerta de enlace de IA escucha en http://127.0.0.1:11580. Para ser compatible con los SDKs y herramientas de distintos proveedores, la puerta de enlace ofrece endpoints con distintos protocolos en el mismo puerto:

Formato de Protocolo	Ruta del Endpoint	Escenario de Uso
Compatible con OpenAI	http://127.0.0.1:11580/v1	Para cualquier SDK/herramienta que utilice el formato API de OpenAI (como /v1/chat/completions)
Compatible con Anthropic	http://127.0.0.1:11580/v1/messages	Para el SDK de Anthropic, Claude Code y similares
Compatible con Gemini	http://127.0.0.1:11580/v1beta	Para el SDK de Google Gemini y Gemini CLI

Solo tienes que elegir el formato adecuado según el protocolo que use tu SDK, dirigir las solicitudes a la dirección de la puerta de enlace, y ésta, de acuerdo con los permisos de la clave virtual, las enruta al canal del proveedor correspondiente.

Autenticación: Uso de Claves Virtuales

Todas las solicitudes a la puerta de enlace requieren claves virtuales para autenticarse, no la clave real del proveedor. Primero, crea y copia una clave virtual desde la página Claves.

En la página IA Gateway → Endpoints, puedes seleccionar una clave virtual y la puerta de enlace generará directamente los fragmentos de variables de entorno listos para copiar y pegar en las herramientas más usadas.

Ejemplo de Variables de Entorno

Los siguientes ejemplos asumen que ya tienes una clave virtual (representada como <tu_clave_virtual>).

SDK/Herramientas Compatibles con OpenAI

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<tu_clave_virtual>"

Claude Code / Anthropic

# Nota: El protocolo Anthropic usa la raíz de la puerta de enlace, sin /v1
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<tu_clave_virtual>"

Gemini

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<tu_clave_virtual>"

Ejemplo de Llamada (Compatible con OpenAI)

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <tu_clave_virtual>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hola"}]
  }'

En este caso, el valor de model debe corresponder a un modelo ya configurado en tus canales y autorizado para esa clave virtual.

Requisitos Previos

• El servicio proxy de la puerta de enlace de IA está en ejecución.
• Hay al menos un canal correctamente configurado, y existe una clave virtual con permisos para los modelos/canales necesarios.

Preguntas Frecuentes (FAQ)

• P: ¿La solicitud falla por autenticación?
  • R: Comprueba que estás usando una clave virtual (no la real del proveedor) y que no haya expirado ni sido revocada.
• P: ¿Mensaje indicando modelo no disponible o falta de permiso?
  • R: Asegúrate de que el model esté configurado en algún canal y que la clave virtual tenga permiso para ese modelo/canal.
• P: ¿Qué formato de endpoint debo usar?
  • R: Elige según el protocolo de tu SDK: estilo OpenAI usa /v1, estilo Anthropic usa /v1/messages (la URL base sin /v1), estilo Gemini usa /v1beta.
• P: ¿Puede acceder a la puerta de enlace otro dispositivo en la red local?
  • R: Por defecto, la puerta de enlace solo escucha en 127.0.0.1 (solo local). Esto se recomienda por motivos de seguridad.

Resumen

La puerta de enlace de IA ofrece endpoints locales unificados en formatos compatibles con OpenAI, Anthropic y Gemini. Utilizando autenticación con claves virtuales, puedes conectar cualquier aplicación o herramienta de IA al gateway y beneficiarte de una gestión de claves y estadísticas de uso unificadas. Para herramientas CLI habituales, es más fácil usar la función de toma de control en un clic.