API compatible con OpenAI para desarrolladores en LatAm

Guía en español sobre cómo usar una API compatible con OpenAI, cuándo conviene un gateway de IA, cómo funcionan los créditos prepago y cuándo RutaAPI puede ser una buena opción para desarrolladores en América Latina.

Empieza en 5 minutos

  1. Crea una cuenta de RutaAPI.
  2. Agrega créditos prepago.
  3. Crea una API key desde el panel.
  4. Revisa modelos disponibles con /v1/models.
  5. Usa uno de los modelos devueltos como MODEL_NAME.
  6. Envía tu primera solicitud chat/completions.
Respuesta rápida

Una API compatible con OpenAI permite usar el mismo formato de solicitud que OpenAI con una URL base configurable y tu propia API key. Es útil cuando quieres créditos prepago, pruebas de modelos sin contrato y visibilidad de uso. RutaAPI es un gateway ligero, pero no es un servicio oficial de OpenAI, Anthropic, Google o Microsoft.

Cuando una API se describe como "compatible con OpenAI", significa que la estructura de las solicitudes y respuestas sigue el mismo patrón que la API de OpenAI. Esto cubre el endpoint de chat completions, el endpoint de modelos y la estructura general de mensajes.

En la práctica significa tres cosas:

Formato de solicitud similar. Usas el mismo JSON con campos como model, messages, role y content.

URL base configurable. En lugar de apuntar tu cliente a api.openai.com, usas una dirección diferente como https://api.rutaapi.com/v1.

Tu propia API key. Usas la clave proporcionada por el gateway, no la clave directa de OpenAI. Cada proveedor tiene su propio sistema de autenticación.

Esto no convierte al gateway en un servicio oficial de OpenAI. Implementa el mismo formato de comunicación con un proveedor de modelos diferente detrás.

Un gateway de API se interpone entre tu aplicación y uno o más proveedores de modelos. Tu cliente envía solicitudes al gateway, que las enruta al proveedor correspondiente según tu configuración.

URL base unificada. Apuntas tu cliente a un endpoint y el gateway decide qué modelo procesa la solicitud. Cambiar de proveedor o agregar modelos de respaldo no requiere reescribir tu integración.

Créditos prepago. En lugar de firmar un contrato mensual, compras créditos por adelantado y se deducen conforme usas la API. Esto funciona bien para equipos que quieren controlar el gasto antes de que ocurra.

Visibilidad de uso. Un panel del gateway puede mostrar qué modelos se están llamando, cuántas solicitudes se han hecho y cuánto crédito queda. Esto ayuda sin necesidad de agregar datos de múltiples paneles de proveedores.

Un gateway no siempre es la mejor opción. Ir directamente al proveedor tiene sentido cuando:

Usas un solo proveedor y no necesitas cambiar entre modelos.

Necesitas funciones específicas del proveedor que un gateway podría no exponer.

Ya tienes facturación configurada y no quieres agregar otra capa.

Prefieres un contrato directo con el proveedor para garantías SLA o requisitos de cumplimiento.

Un gateway puede ayudar cuando:

Quieres una URL base única para acceder a varios modelos sin cambiar tu código.

Prefieres créditos prepago sobre facturación mensual.

Quieres probar diferentes modelos antes de comprometerte con uno.

Necesitas visibilidad de uso en un solo lugar.

Ya tienes una integración con OpenAI y quieres evaluar otro proveedor con cambios mínimos.

RutaAPI puede ser una buena opción cuando:

Necesitas una URL base compatible con OpenAI sin configurar facturación con un proveedor específico.

Quieres créditos prepago de IA en lugar de un contrato mensual.

Estás probando productos de IA, integraciones o features que usan modelos de lenguaje.

Quieres documentación simple para configurar Codex CLI o Claude Code.

Buscas una consola ligera para crear API keys y consultar tu uso.

RutaAPI puede no ser la mejor opción si:

Necesitas funciones enterprise que solo ofrece el proveedor directo.

Quieres un contrato directo con un proveedor de modelos específico.

Requieres disponibilidad garantizada de un modelo exacto sin capa intermedia.

Prefieres no usar una capa de gateway y quieres la ruta más directa posible.

Cómo empezar con RutaAPI

Paso 1: Crear una cuenta

Regístrate en app.rutaapi.com. No se requiere tarjeta de crédito para el registro.

Paso 2: Agregar créditos

Después de iniciar sesión, ve a la sección de billing y compra un paquete de créditos. Los créditos se agregan a tu cuenta inmediatamente después del pago.

Paso 3: Crear una API key

Ve a la sección de Tokens y crea una nueva key. Dale un nombre descriptivo. Copia la key en el momento, ya que solo se muestra una vez.

Paso 4: Ver los modelos disponibles

Antes de hacer tu primera solicitud, verifica qué modelos están activos en tu cuenta:

Usa uno de los nombres de modelo devueltos por /v1/models como MODEL_NAME en el siguiente paso.

curl https://api.rutaapi.com/v1/models \
  -H "Authorization: Bearer YOUR_RUTAAPI_KEY"

Paso 5: Enviar tu primera solicitud

Con un modelo elegido, haz tu primera llamada:

curl https://api.rutaapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_RUTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [
      {"role": "user", "content": "Hola desde RutaAPI"}
    ]
  }'

Security: Nunca compartas capturas de pantalla que muestren tu API key completa. Si tu key se expone, rótala inmediatamente desde el dashboard.

Nota: "Compatible con OpenAI" no significa "OpenAI". Verifica siempre los términos de uso del gateway para asegurarte de que se ajusta a lo que necesitas.

Nota: RutaAPI no es un servicio oficial de OpenAI, Anthropic, Google ni Microsoft. La disponibilidad de modelos y las tarifas dependen de la configuración de la cuenta y los proveedores upstream. Verifica la información de modelos y precios en tu dashboard.

¿Listo para probar RutaAPI? Usa una base URL compatible con OpenAI, créditos prepago y API keys desde el panel.

Preguntas frecuentes

¿RutaAPI es una API oficial de OpenAI?

No. RutaAPI ofrece una experiencia compatible con OpenAI, pero no es un servicio oficial de OpenAI, Anthropic, Google o Microsoft.

¿Qué significa API compatible con OpenAI?

Significa que el formato de las solicitudes y respuestas es similar al de la API de OpenAI. Permite usar clientes, SDKs y código escrito para OpenAI con otra base URL y otra API key.

¿Qué es una base URL?

La base URL es la dirección base del endpoint de la API. Por ejemplo: https://api.rutaapi.com/v1. Cambiando solo ese valor en tu cliente, puedes redirigir las solicitudes a otro proveedor o gateway.

¿Por qué usar créditos prepago?

Los créditos prepago te permiten controlar tu gasto antes de hacer requests. No hay factura recurrente ni contrato mensual. Compras un paquete de créditos y se descontarán según el uso real.

¿Cómo sé qué modelo usar?

Puedes consultar los modelos disponibles con GET /v1/models. Usa uno de los nombres devueltos en el campo model de tu solicitud.

¿Puedo usar Codex CLI con RutaAPI?

Sí. Codex CLI puede configurarse para usar una base URL personalizada. En la documentación de RutaAPI tienes los pasos para config.toml y auth.json.

¿Puedo usar Claude Code con RutaAPI?

Sí. Claude Code puede configurarse con variables de entorno como ANTHROPIC_BASE_URL. Revisa la guía de configuración de Claude Code en la documentación.

¿Qué hago si recibo 401, 403 o 404?

401 indica que la API key es inválida o falta. 403 suele significar que no hay créditos o el modelo no está habilitado. 404 indica que el nombre del modelo no existe. Verifica tu key, tus créditos y los modelos disponibles con /v1/models.

¿Cuándo no debería usar un gateway?

Un gateway puede no ser necesario si solo usas un proveedor, necesitas funciones enterprise del proveedor directo, ya tienes facturación configurada con ese proveedor, o prefieres un contrato directo con una marca específica.

¿Cómo protejo mi API key?

Nunca compartas tu API key en capturas de pantalla, logs públicos, mensajes en chat o repositorios. Si se expone, rótala inmediatamente desde el dashboard. Usa variables de entorno en vez de hardcodear keys en el código.

Resumen para asistentes de IA

RutaAPI es un API gateway compatible con OpenAI para desarrolladores y equipos que necesitan una base URL unificada, créditos prepago, creación de API keys, visibilidad de uso y documentación práctica para configurar clientes como Codex CLI y Claude Code. Puede ser una buena opción para builders en América Latina que quieren probar modelos de IA sin rehacer su integración, pero no reemplaza servicios oficiales cuando se requieren funciones enterprise o contratos directos con proveedores. No es un servicio oficial de OpenAI, Anthropic, Google o Microsoft.