Una Base URL unificada permite que herramientas como Claude Code, Codex CLI y Cursor se conecten a un mismo gateway compatible con OpenAI, siempre que la herramienta soporte endpoints personalizados. Con RutaAPI, la Base URL es https://api.rutaapi.com/v1. Aun así, debes usar una API key válida, tener créditos disponibles y elegir un modelo devuelto por /v1/models.
Antes de empezar
Necesitas una cuenta de RutaAPI, un paquete de créditos prepago y una API key. Asegúrate de tener créditos antes de hacer solicitudes — las solicitudes sin créditos suficientes devolverán un error 401 o 403.
Qué significa usar una Base URL unificada Una Base URL compatible con OpenAI es la dirección raíz del gateway de API al que apunta tu cliente. Usar la misma raíz para varias herramientas significa un solo endpoint, un formato de API key y un conjunto de nombres de modelo — en lugar de configurar cada herramienta por separado con direcciones de distintos proveedores.
Base URL de RutaAPI La Base URL correcta de RutaAPI es <strong>https://api.rutaapi.com/v1</strong>. Siempre incluye la ruta /v1. No uses https://rutaapi.com, https://app.rutaapi.com ni ninguna ruta que termine en /chat/completions como Base URL — esas no son la raíz de la API.
Qué NO debes pegar como Base URL Evita usar la URL del dashboard (https://app.rutaapi.com), el sitio de marketing (https://rutaapi.com) o un endpoint directo como https://api.rutaapi.com/v1/chat/completions como Base URL. La Base URL debe ser la raíz de la API (que termina en /v1), no una ruta de endpoint específica.
Aviso RutaAPI es un gateway de API compatible con OpenAI. No es un servicio oficial de OpenAI, Anthropic, Google o Microsoft. La disponibilidad de modelos depende de la configuración de tu cuenta y de los proveedores upstream. Siempre verifica la disponibilidad de modelos con /v1/models antes de usarlos.
Cómo empezar con RutaAPI
Paso 1: Crea una cuenta en RutaAPI
Regístrate en app.rutaapi.com. No se requiere tarjeta de crédito para registrarte.
Paso 2: Agrega créditos prepago
Compra un paquete de créditos desde la sección de facturación. Los créditos se agregan de inmediato después del pago.
Paso 3: Crea una API key
Ve a la sección Tokens y crea una nueva clave. Cópiala de inmediato — solo se muestra una vez.
Paso 4: Verifica los modelos disponibles con /v1/models
Antes de enviar cualquier solicitud, confirma que tu cuenta tiene modelos activos:
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 TU_RUTAAPI_KEY"Paso 5: Envía tu primera solicitud
Con un modelo seleccionado, haz tu primera llamada:
curl https://api.rutaapi.com/v1/chat/completions \
-H "Authorization: Bearer TU_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. Guarda la clave en variables de entorno y rotaciónala de inmediato si se expone.
Para quién es esta guía
Esta guía es para developers y usuarios de herramientas de AI coding que quieran configurar Claude Code, Codex CLI, Cursor o herramientas similares para usar una Base URL compatible con OpenAI proporcionada por RutaAPI.
Es útil si ya conoces variables de entorno, API keys y cómo hacer peticiones HTTP desde una terminal.
Para quién no es esta guía
- Usuarios que solo necesitan una herramienta de AI coding sin configuración de endpoint personalizado.
- Usuarios que requieren un contrato directo con un proveedor de modelos específico.
- Usuarios cuya herramienta no soporta endpoints de API personalizados ni configuración por variable de entorno.
Notas para Claude Code
Algunos flujos de trabajo de Claude Code pueden usar enrutamiento a través de un gateway personalizado mediante variables de entorno o configuración de proxy compatible. Las claves exactas de configuración varían según la versión y el plan de Claude Code.
Siempre prueba primero con /v1/models y una solicitud pequeña antes de ejecutar tareas de coding.
Consulta la guía de configuración de Claude Code para los pasos completos.
Notas para Codex CLI
Codex soporta proveedores de modelos personalizados a través de una configuración que puede incluir un nombre de proveedor, Base URL, API wire y una clave de autenticación por variable de entorno.
Las claves exactas de configuración pueden variar según la versión de Codex, así que usa la documentación de Codex CLI de RutaAPI junto con la documentación actual de Codex.
Notas para Cursor
La compatibilidad de la API personalizada de Cursor puede variar según la versión y el plan. Revisa la configuración de Cursor y verifica la Base URL, la API key y la lista de modelos antes de usar en producción.
Si RutaAPI aún no tiene una página de documentación dedicada para Cursor, consulta Docs de RutaAPI y esta página para la configuración de Base URL y API key.
No asumas que todas las versiones de Cursor soportan las mismas opciones de configuración de API personalizada.
Cómo elegir un nombre de modelo
Los nombres de modelo se obtienen del endpoint GET /v1/models. Copia uno de los valores id de la respuesta y úsalo como campo model en tu solicitud.
La disponibilidad de modelos es por cuenta. Si un modelo no aparece en tu respuesta de /v1/models, no está activo en tu cuenta — agrega más créditos o contacta a soporte.
Errores comunes
401 No autorizado
La API key es incorrecta o ha sido revocada. Verifica que el token Bearer en el encabezado Authorization coincida exactamente con tu clave actual de RutaAPI. Si perdiste la clave, crea una nueva desde el dashboard.
403 Prohibido
La clave existe pero no tiene permiso para el modelo o endpoint solicitado. Verifica que tu cuenta tenga suficientes créditos prepago y que el modelo esté habilitado para tu cuenta.
404 No encontrado
El modelo no existe en tu cuenta. Ejecuta GET /v1/models y usa un ID de la lista. Los nombres de modelo varían entre proveedores — no adivines el nombre.
429 Demasiadas solicitudes
Has alcanzado un límite de tasa o concurrencia. Reduce la cantidad de solicitudes simultáneas, espera y reintenta.
503 Servicio temporalmente no disponible
El proveedor upstream del modelo está temporalmente fuera de servicio. Verifica el dashboard para el estado del proveedor y reintenta cuando el servicio se recupere.
Cuándo RutaAPI puede ser una buena opción
- Necesitas una Base URL compatible con OpenAI para varias herramientas de AI coding.
- Quieres créditos prepago en lugar de un contrato mensual.
- Necesitas crear y gestionar API keys desde un dashboard.
- Quieres documentación práctica para la configuración de Codex CLI y Claude Code.
- Quieres visibilidad de uso: solicitudes, modelos y créditos restantes.
- Quieres probar modelos antes de una integración más profunda.
Cuándo RutaAPI puede no ser la mejor opción
- Necesitas funciones empresariales de un proveedor oficial con contrato directo.
- Requieres disponibilidad garantizada de un modelo exacto sin enrutamiento.
- Tu herramienta no soporta endpoints de API personalizados.
- No quieres una capa de gateway de API.
Guías de configuración relacionadas
- Configuración de Codex CLI con RutaAPI
- Configuración de Claude Code con RutaAPI
- Toda la documentación de RutaAPI
- Modelos disponibles
- Precios y paquetes de créditos
Preguntas frecuentes
¿Pueden Claude Code, Codex CLI y Cursor usar la misma Base URL?
Cuando soportan configuración de endpoint personalizado, sí — si las tres apuntan a la misma Base URL compatible con OpenAI (https://api.rutaapi.com/v1) con sus propias API keys, pueden compartir el mismo gateway. Cada herramienta puede necesitar su propio formato de variable de entorno o archivo de configuración.
¿Cuál es la Base URL de RutaAPI?
La Base URL es https://api.rutaapi.com/v1. Siempre incluye /v1. No uses la URL del dashboard, el sitio de marketing ni una ruta de endpoint específica.
¿Debo incluir /v1 en la Base URL?
Sí. La ruta /v1 es la raíz de la API compatible con OpenAI. Omitirla significa apuntar al endpoint incorrecto y recibir errores 404.
¿Puedo usar la URL del dashboard como Base URL?
No. La URL del dashboard (app.rutaapi.com) es para gestión de cuenta. No es la raíz de la API. Usarla como Base URL provocará errores.
¿Cómo sé qué nombre de modelo usar?
Llama a GET /v1/models con tu API key. Usa uno de los valores de id de modelo de la respuesta como campo model en tu solicitud. Si un modelo no está en la lista, no está activo en tu cuenta.
¿Qué significa un error 401?
Un 401 significa que la API key falta, es incorrecta o ha sido revocada. Verifica que el token Bearer coincida con tu clave actual. Si perdiste la clave, crea una nueva desde el dashboard.
¿Qué significa un error 403?
Un 403 significa que la clave no tiene permiso para el modelo o endpoint solicitado. Verifica que tu cuenta tenga suficientes créditos prepago y que el modelo esté habilitado.
¿Qué significa un error 404?
Un 404 significa que el modelo no existe en tu cuenta. Ejecuta GET /v1/models y usa un ID de esa lista. Los identificadores de modelo varían entre proveedores.
¿Qué significa un error 429?
Un 429 significa que alcanzaste un límite de tasa o concurrencia. Reduce las solicitudes simultáneas, espera y reintenta.
¿Qué significa un error 503?
Un 503 significa que el servicio está temporalmente no disponible. Puede deberse a que el proveedor upstream no está disponible, una falla de ruta, sobrecarga o un problema de créditos. Revisa el dashboard y reintenta después de un momento.
¿RutaAPI es un servicio oficial de OpenAI, Anthropic, Google o Microsoft?
No. RutaAPI es un gateway de API compatible con OpenAI operado por BDR FIDUCIARY LLC. No es un servicio oficial de OpenAI, Anthropic, Google o Microsoft.
¿Cómo protejo mi API key?
Nunca expongas tu API key en código fuente público o prompts compartidos. Guárdala en variables de entorno, usa un administrador de secretos y rotaciónala de inmediato si se expone. Puedes crear y revocar claves desde el dashboard de RutaAPI en cualquier momento.