Cómo integrar Gate.AI: Guía rápida para desarrolladores

Gate.AI API integración permite a los desarrolladores acceder a múltiples modelos de IA mediante una API compatible con OpenAI, logrando una integración, enrutamiento y prueba unificados, sin necesidad de mantener configuraciones SDK separadas para cada proveedor de modelos. Ya sea para desarrollar chatbots, herramientas internas, agentes inteligentes, automatización de procesos o scripts de evaluación de modelos, se simplifica significativamente el proceso de integración. Esta guía cubrirá la creación de claves API, enrutamiento automático, selección manual de modelos, URL base compatible con OpenAI, pruebas con la primera solicitud y resolución de errores comunes de configuración, excluyendo temas avanzados como gobernanza empresarial, estrategias de facturación o arquitecturas de seguridad personalizadas.

Requisitos previos:

• Tener una cuenta en Gate.AI y acceso a la configuración de la consola.
• Tener un entorno local configurado con Python, Node.js o curl.

¿Qué habilidades obtendrás al completar esta guía?

Al finalizar, podrás crear claves API en Gate.AI, configurar la URL base compatible con OpenAI, enviar la primera solicitud API usando model: "auto" y probar un ID de modelo específico.

¿Qué aplicaciones pueden construirse mediante la integración con la API de Gate.AI?

Los desarrolladores pueden aprovechar la API de Gate.AI para acceder a un sistema de múltiples modelos mediante un formato de solicitud compatible con OpenAI, en escenarios típicos como:

| Tipo de construcción | Función de Gate.AI | Ejemplo de salida | | --------------------- | ---------------------------------------- | ---------------------------------- | | Aplicaciones de chat | Enrutamiento de mensajes de usuarios a modelos de chat compatibles | Asistente de atención al cliente | | Herramientas internas | Configuración unificada de API entre equipos | Asistente de escritura/investigación AI | | Agentes inteligentes y procesos | Conexión de llamadas a modelos y automatización de tareas | Asistente de llamadas a herramientas | | Pruebas de modelos | Comparación entre enrutamiento "auto" y modelos específicos | Scripts de evaluación | | Migración de proyectos | Reemplazo de URL base compatible con OpenAI existente | Prototipos multímetro |

Cuando desees que Gate.AI seleccione automáticamente el modelo, usa model: "auto"; si necesitas comportamiento reproducible para un modelo específico, ingresa su ID.

¿Qué necesitas preparar antes de comenzar?

Solo necesitas cumplir con dos condiciones clave:

| Condición necesaria | Razón importante | | --------------------- | -------------------------------------------------------------- | | Acceso a la cuenta de Gate.AI | Para crear claves API en la consola y verificar la configuración de enrutamiento | | Método de solicitud local | Para enviar solicitudes de prueba usando Python, Node.js o curl |

No es necesario elegir todos los modelos desde el inicio. Primero, verifica que la clave API y la URL base funcionen correctamente, y luego prueba la selección manual de modelos.

Paso 1: Crear una clave API en Gate.AI

Este paso crea las credenciales que usarás para autenticarte en la API.

Pasos:

1. Accede a gate.ai.
2. Inicia sesión y completa la autorización.
3. Abre la consola → Configuración → Claves API.
4. Haz clic en Crear clave.
5. Copia inmediatamente la clave API y guárdala en un lugar seguro.

Verás la nueva clave en la sección de claves API. Si solo se muestra una vez, asegúrate de copiarla antes de cerrar la ventana de creación.

Paso 2: Seleccionar enrutamiento automático o selección manual de modelos

Este paso decide si Gate.AI asignará automáticamente un modelo o si especificarás uno en la solicitud.

Pasos:

1. Abre la consola → Configuración → Enrutamiento.
2. Verifica que la opción Enrutamiento automático esté activada.
3. Para que Gate.AI seleccione automáticamente un modelo en cada solicitud, mantén habilitado el enrutamiento automático.
4. Para especificar manualmente un ID de modelo, desactiva el enrutamiento automático y proporciona el ID en el cuerpo de la solicitud.

| Modo de selección | Valor del parámetro en la solicitud | Escenario de uso | | --------------------- | ---------------------------------------------- | ---------------------------------------------- | | Enrutamiento automático | "model": "auto" | Cuando quieres que Gate.AI seleccione automáticamente | | Selección manual de modelo | "model": "anthropic/claude-sonnet-4.6" | Para pruebas o uso de un modelo específico |

El enrutamiento automático es útil para integración rápida y pruebas generales; la selección manual es preferible cuando se requiere evaluación reproducible de un solo modelo.

Paso 3: Configurar URL base compatible con OpenAI

Este paso ajusta un cliente estilo OpenAI para que apunte a Gate.AI en lugar del endpoint predeterminado de OpenAI.

Usa la siguiente URL base:

text

El formato de autenticación es:

text Authorization: Bearer YOUR_API_KEY

La documentación de Gate.AI especifica que la ruta API debe ser /openai/v1, no solo /v1 (hasta junio de 2026). Asegúrate de completar la URL base exactamente como en el ejemplo.

| Configuración | Valor | | --------------------- | -------------------------------------------- | | URL base | [tu URL base aquí] | | Método de autenticación | Authorization: Bearer YOUR_API_KEY | | Formato | Compatible con OpenAI | | Endpoint de chat | POST /chat/completions | | Endpoint de modelos | GET /models |

La mayoría de errores en integración provienen de una URL base abreviada o de copiar mal la clave API. Verifica estos puntos antes de ajustar la configuración del modelo.

Paso 4: Enviar la primera solicitud API

Este paso prueba si la clave API, la URL base y el formato de chat compatible con OpenAI funcionan correctamente.

Ejemplo en Python:

python from openai import OpenAI

client = OpenAI( api_key="YOUR_API_KEY", base_url="", )

completion = client.chat.completions.create( model="auto", messages=[ {"role": "system", "content": "Eres un asistente conciso."}, {"role": "user", "content": "Saluda desde Gate.AI."} ], )

print(completion.choices[0].message.content)

Ejemplo en Node.js:

javascript import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "", });

const completion = await client.chat.completions.create({ model: "auto", messages: [ { role: "system", content: "Eres un asistente conciso." }, { role: "user", content: "Saluda desde Gate.AI." } ], });

console.log(completion.choices[0].message.content);

Ejemplo con curl:

bash curl /chat/completions
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{ "model": "auto", "messages": [ {"role": "system", "content": "Eres un asistente conciso."}, {"role": "user", "content": "Saluda desde Gate.AI."} ] }'

Deberías recibir una respuesta normal del asistente. Si hay errores de autenticación, revisa primero la clave API, sin necesidad de modificar inmediatamente el código.

Paso 5: Probar con un ID de modelo específico

Este paso verifica si la selección manual de modelos funciona cuando se necesita especificar uno.

Cambia el parámetro model de auto a un ID de modelo soportado, por ejemplo:

python from openai import OpenAI

client = OpenAI( api_key="YOUR_API_KEY", base_url="", )

completion = client.chat.completions.create( model="anthropic/claude-sonnet-4.6", messages=[ {"role": "user", "content": "Explica en un párrafo cómo funciona el enrutamiento de modelos."} ], )

print(completion.choices[0].message.content)

Asegúrate de ingresar el ID del modelo exactamente como aparece en la documentación o en la lista de modelos de Gate.AI. Un error de ortografía hará que la solicitud falle, incluso si la clave API y la URL base son correctas.

¿Cómo funciona el mecanismo de enrutamiento automático en las solicitudes a la API de Gate.AI?

El enrutamiento automático en Gate.AI funciona incluyendo en el cuerpo de la solicitud el campo model: "auto", junto con la configuración de enrutamiento en la consola. Hasta junio de 2026, las opciones de control de enrutamiento están en:

Console → Configuración → Enrutamiento

| Método de enrutamiento | Ubicación de configuración | Parámetro en la solicitud API | | ---------------------- | ---------------------------- | ------------------------------ | | Enrutamiento automático | Console → Configuración → Enrutamiento | "model": "auto" | | Selección manual de modelo | En el cuerpo de la solicitud | Especificar ID del modelo | | Control de estrategia de enrutamiento | Configuración de enrutamiento en consola | Personalización de comportamiento |

El enrutamiento automático no significa omitir el campo del modelo. Es necesario incluir explícitamente model: "auto" en la solicitud para que Gate.AI realice el enrutamiento.

¿Qué modo de integración se recomienda?

Elige según el entorno de tu aplicación:

| Método | Escenario de uso | Cambio principal | | ------------------------------ | ---------------------------------------------- | -------------------------------------- | | SDK en Python | Scripts o servicios Python existentes | Configurar base_url y api_key | | SDK en Node.js | Servicios en JavaScript o TypeScript | Configurar baseURL y apiKey | | curl | Validación rápida manual | Enviar encabezados y carga JSON | | Aplicación compatible con OpenAI | Cuando ya soportas URL base personalizadas | Reemplazar URL base y clave API |

Se recomienda comenzar con curl para pruebas rápidas, luego integrar con Python o Node.js en la aplicación real.

¿Cuáles son las causas comunes de fallos en las solicitudes a la API de Gate.AI?

Para solucionar problemas, revisa cada punto:

| Síntoma | Causa probable | Solución | | ------------------------------------- | ------------------------------------------------------------ | ----------------------------------------------------- | | 401 o clave API inválida | Clave API ausente, caducada, mal copiada o sin Bearer | Recrear o copiar la clave, usar Authorization: Bearer YOUR_API_KEY | | Modelo no encontrado | ID de modelo incorrecto o no disponible en la cuenta | Consultar la documentación de modelos de Gate.AI o probar con model: "auto" | | Código compatible con OpenAI da error | URL base incompleta o solo con /v1 | Usar URL completa y correcta | | Enrutamiento automático no funciona | Enrutamiento desactivado o configuración incorrecta | Verificar en Console → Configuración → Enrutamiento y activar auto | | Respuesta vacía o error | Formato de solicitud incorrecto o modelo no soporta la petición | Probar con la solicitud más simple y agregar parámetros gradualmente |

Revisa primero la autenticación, la URL base y el ID del modelo. La mayoría de los problemas de integración rápida se resuelven con estos pasos.

¿Qué configuraciones adicionales se pueden hacer después?

Una vez que la primera solicitud funcione, puedes ampliar la integración en estas áreas:

• Configurar en la consola de Gate.AI el comportamiento de enrutamiento de modelos.
• Ver la disponibilidad de modelos y seleccionar un ID fijo para pruebas en producción.
• Comparar precios y elegir modelos adecuados para escenarios de alta concurrencia.

Preguntas frecuentes

¿Por qué se recomienda usar primero model: "auto"?

Porque permite verificar en una sola prueba la clave API, URL base, formato de solicitud y configuración de enrutamiento. Una vez confirmado, se puede probar con un ID de modelo específico.

¿Se puede usar el SDK de OpenAI existente para llamar a Gate.AI?

Sí. Gate.AI soporta el formato compatible con OpenAI, solo necesitas configurar la clave API de Gate.AI y reemplazar la URL base.

¿Por qué fallan las solicitudes tras cambiar a un modelo específico?

El ID del modelo puede no existir, estar mal escrito o no ser soportado por la cuenta. Verifica en la documentación de modelos de Gate.AI y prueba con el ID correcto.

¿Es necesario desactivar el enrutamiento automático al usar un modelo específico?

No siempre. Cuando quieres seleccionar manualmente un modelo, puedes incluir el ID en la solicitud. Si no funciona como esperas, revisa la configuración de enrutamiento en la consola.