Endpoints de la puerta de enlace de IA y variables de entorno

Además de tomar el control con un solo clic de las herramientas de IA ya listas para usar, también puedes llamar directamente a la puerta de enlace de IA desde tus propias aplicaciones, scripts o cualquier herramienta de IA. Este artículo describe los formatos de endpoint que expone la puerta de enlace y cómo conectarte a ella mediante claves virtuales.

Endpoints del proxy

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

Formato de protocolo	Ruta del endpoint	Casos de uso
Compatible con OpenAI	http://127.0.0.1:11580/v1	Cualquier SDK o herramienta que use el formato de la API de OpenAI (por ejemplo, /v1/chat/completions)
Compatible con Anthropic	http://127.0.0.1:11580/v1/messages	SDK de Anthropic, Claude Code, etc.
Compatible con Gemini	http://127.0.0.1:11580/v1beta	SDK de Google Gemini, etc.

Solo tienes que elegir el formato correspondiente según el protocolo del SDK que uses y dirigir las solicitudes a la dirección de la puerta de enlace; esta enrutará las solicitudes al canal del proveedor correspondiente según los permisos de la clave virtual.

Autenticación: uso de claves virtuales

Todas las solicitudes a la puerta de enlace se autentican con una clave virtual, y no con la clave real del proveedor. Primero crea una clave virtual en la página de Claves y copia su texto en claro.

En la página Puerta de enlace de IA → Endpoints (Endpoints), puedes seleccionar una clave virtual y la puerta de enlace generará directamente fragmentos de variables de entorno listos para copiar para las herramientas más habituales.

Ejemplos de variables de entorno

Los siguientes ejemplos suponen que ya has obtenido una clave virtual (denotada 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 dirección 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"}]
  }'

El model debe ser uno que ya hayas configurado en los canales y al que la clave virtual tenga permiso para llamar.

Requisitos previos

• El servicio de proxy de la puerta de enlace de IA está en ejecución.
• Se ha configurado al menos un canal en buen estado y se ha creado una clave virtual con los permisos correspondientes de modelos / canales.

Preguntas frecuentes (FAQ)

• P: ¿La solicitud devuelve un fallo de autenticación?
  • R: Confirma que estás usando la clave virtual (y no la clave real del proveedor) y que dicha clave no ha caducado ni ha sido revocada.
• P: ¿Aparece un mensaje de modelo no disponible o sin permisos?
  • R: Confirma que ese model ya está configurado en algún canal y que los «modelos / canales permitidos» de la clave virtual actual lo incluyen.
• P: ¿Qué formato de endpoint debo usar?
  • R: Elige según el protocolo del SDK que uses: para el estilo OpenAI, usa /v1; para el estilo Anthropic, usa /v1/messages (la Base URL sin /v1); para el estilo Gemini, usa /v1beta.
• P: ¿Pueden otros dispositivos de la red local acceder a la puerta de enlace?
  • R: De forma predeterminada, la puerta de enlace solo escucha en 127.0.0.1 (únicamente el equipo local). Esta es la configuración recomendada por motivos de seguridad.

Resumen

La puerta de enlace de IA ofrece endpoints locales unificados en tres formatos compatibles (OpenAI / Anthropic / Gemini) y, gracias a la autenticación mediante claves virtuales, puedes conectar cualquier aplicación o herramienta de IA a la puerta de enlace y disfrutar de una gestión unificada de claves y de estadísticas de uso. Para las herramientas CLI habituales, usar el control con un solo clic resulta aún más cómodo.