Antes de empezar
Para hacer tu primera solicitud necesitas tres cosas:
Requisitos previos
- Cuenta en app.rutaapi.com (registro gratuito)
- Créditos disponibles en tu cuenta
- Una API key generada desde el panel
- Un cliente que soporte el formato de chat completions de OpenAI
Base URL
Usa la siguiente base URL para todas las solicitudes:
Base URL
https://api.rutaapi.com/v1
Esta URL es compatible con el formato de solicitudes de OpenAI. Cambia la base URL en tu cliente y usa tu API key de RutaAPI.
Primera solicitud
Reemplaza YOUR_RUTAAPI_KEY con tu clave real y MODEL_NAME con el modelo que quieras usar (disponible en tu panel):
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"}
]
}'Revisa tu panel para ver los modelos disponibles y sus nombres exactos antes de hacer la solicitud.
Códigos de error comunes
Si tu solicitud falla, estos son los códigos más frecuentes:
401 Unauthorized
La API key es inválida o está mal formateada. Revisa que coincida exactamente con la que generaste.
403 Forbidden
Sin créditos disponibles o sin permiso para el modelo solicitado.
404 Not Found
El modelo indicado no está disponible o el nombre es incorrecto.
429 Too Many Requests
Se superó el límite de requests por minuto. Espera un momento e intenta de nuevo.
500 / 502 / 503
Error del servidor o del proveedor upstream. Intenta de nuevo en unos segundos.
400 Bad Request
El formato del body JSON es incorrecto o faltan campos obligatorios.
Preguntas frecuentes
El registro no requiere tarjeta de crédito. Puedes crear una cuenta, generar una API key y luego agregar créditos cuando lo necesites.
RutaAPI usa un formato compatible con OpenAI para las solicitudes y respuestas. Puedes usar clientes que ya soporten el formato de chat completions de OpenAI.
Necesitas créditos en tu cuenta para hacer solicitudes. Puedes agregar una cantidad pequeña para hacer pruebas.
En teoría sí, siempre que soporte el formato de chat completions de OpenAI. Algunos clientes tienen configuraciones específicas que pueden necesitar ajustes.
La disponibilidad de modelos puede variar según el proveedor, la región y la configuración. Consulta tu panel para ver qué modelos están activos en tu cuenta.