Documentación

Documentación de NexoRouter para configurar la API compatible con OpenAI, el Dashboard, facturación, errores e integraciones.

Documentación de NexoRouter

NexoRouter es un gateway de API compatible con OpenAI para desarrolladores y equipos pequeños. Usa una API key de NexoRouter para llamar modelos disponibles públicamente, administrar saldo prepago, probar prompts en Playground y revisar logs de uso.

Página principal de NexoRouter

Catálogo público de modelos de NexoRouter

Empieza aquí

Inicio rápido de 2 minutos

Crea una API key, usa https://api.nexorouter.com/v1 como base URL, elige un model ID desde Models y envía tu primera solicitud a chat/completions.

Siguiente: Inicio rápido

Tutoriales prácticos

Páginas prácticas para Playground, la primera llamada a la API, Replit + Python, elección de modelo, y moneda y latencia para equipos en Latinoamérica.

Siguiente: Playground · Primera llamada a la API · Replit + Python · Elige modelos · Latencia y moneda en LATAM

Flujos del Dashboard

Aprende cómo funcionan juntos los presupuestos por API key, expiración, alcance de modelos, guardado único del secreto, revocación, Playground, Billing y Usage Logs.

Siguiente: Flujos del Dashboard

Integraciones

Usa NexoRouter en herramientas que aceptan APIs compatibles con OpenAI. Trata las configuraciones candidatas como pruebas hasta que su página indique que están verificadas.

Siguiente: Integraciones

Referencia de API

Consulta endpoints documentados estables, reglas del request body, formato de errores, rate limits y límites de endpoints.

Siguiente: Referencia de API

SDKs de cliente

Configura HTTP directo u OpenAI SDK para Python y Node.js. Revisa qué significa “compatible” y cómo evaluar otros clientes sin asumir soporte de todos sus métodos.

Siguiente: SDKs de cliente compatibles

Integración de agentes

Diseña un loop multi-turn con límites de pasos, presupuesto, herramientas permitidas y aprobación humana. La guía separa la API estable de las capacidades que requieren verificación.

Siguiente: Integración de agentes

Cookbook

Construye un chat multi-turn ejecutable con Node.js, variables de entorno, manejo de errores y validación en Usage Logs.

Siguiente: Crea una app de chat

Capacidades de API

Entiende qué formas de API son estables hoy y cuáles requieren verificación antes de producción.

Siguiente: Capacidades de API

Estado e incidentes

Revisa Status, Usage Logs y request IDs antes de decidir si un fallo es local, de cuenta, gateway o upstream.

Siguiente: Estado e incidentes

Copia esto primero

Base URL: https://api.nexorouter.com/v1
Header: Authorization: Bearer YOUR_NEXOROUTER_API_KEY
Modelo inicial: kimi-k2.6

Superficie pública de API

Solo los endpoints listados en la referencia de API forman parte del compromiso público estable. Otros paths bajo /v1 pueden pasar por el gateway, pero no son garantías documentadas del producto y pueden fallar o cambiar hasta que se verifiquen aquí.

Capacidad	Estado público
`GET /v1/models`	Soportado. Devuelve model IDs disponibles públicamente.
`POST /v1/chat/completions`	Soportado para requests de chat compatibles con OpenAI.
Streaming	Todavía no está documentado como feature pública estable verificada.
Embeddings	Todavía no está documentado como endpoint público estable verificado.
OpenAI Responses API	Todavía no forma parte de la API pública estable documentada.
Anthropic Messages API	Todavía no forma parte de la API pública estable documentada.
Gemini native API	Todavía no forma parte de la API pública estable documentada.

Tareas comunes

Crear una API key.
Crear una key con el presupuesto, expiración o alcance de modelos correcto.
Migrar una app con OpenAI SDK a NexoRouter.
Elegir un model ID desde Models.
Elegir un primer modelo y revisar disponibilidad, versiones, alias y costo por request.
Controlar longitud de salida con max_tokens.
Probar un prompt en Playground.
Revisar tokens, costo, latencia y request IDs en Usage Logs.
Resolver invalid_api_key, model_not_found, insufficient_quota, rate limits, timeouts y problemas de acceso de cuenta.
Elegir entre HTTP directo, OpenAI SDK, integración de agentes o un proyecto Cookbook.

Estado de integraciones

Herramienta	Estado	Motivo
OpenAI SDK	API pública soportada	Chat Completions compatible con OpenAI.
OpenCode	Configuración candidata, aún no verificada por NexoRouter	OpenCode acepta proveedores personalizados compatibles con OpenAI para `/v1/chat/completions`.
Cline	Configuración candidata, aún no verificada por NexoRouter	Cline acepta proveedores compatibles con OpenAI.
Roo Code	Configuración candidata, aún no verificada por NexoRouter	Roo Code acepta proveedores compatibles con OpenAI, pero las tareas agénticas requieren compatibilidad de tool calling.
Aider	Configuración candidata, aún no verificada por NexoRouter	Aider puede usar endpoints compatibles con OpenAI mediante configuración OpenAI-compatible.
Continue	Configuración candidata, aún no verificada por NexoRouter	Continue soporta configuración de modelos chat compatibles con OpenAI.
Cursor	Configuración candidata, aún no verificada por NexoRouter	Cursor solo sirve si sus settings actuales exponen endpoint personalizado compatible con OpenAI.
Open WebUI	Configuración candidata, aún no verificada por NexoRouter	Open WebUI acepta conexiones compatibles con OpenAI y listas de modelos.
LangChain	Configuración candidata, aún no verificada por NexoRouter	`ChatOpenAI` puede usar un `base_url` personalizado.
Vercel AI SDK	Configuración candidata, aún no verificada por NexoRouter	`@ai-sdk/openai-compatible` acepta `baseURL` y `apiKey`.
Dify	Configuración candidata para chat, aún no verificada por NexoRouter	Dify puede usar proveedores compatibles con OpenAI; embeddings y rerank requieren pruebas separadas.
LlamaIndex	Configuración candidata para chat, aún no verificada por NexoRouter	Las llamadas de chat pueden usar una base URL compatible con OpenAI; embeddings van separados.
Herramientas de traducción	Patrón de configuración candidata, aún no verificado para clientes específicos	Solo funciona cuando el cliente expone una base URL personalizada compatible con OpenAI.
Integraciones de comunidad	Todavía no verificadas	Usa el checklist de compatibilidad antes de probar plugins o herramientas de workflow.
Codex CLI	No soportado por la API pública actual	La configuración actual de providers en Codex espera Responses API; la API pública estable de NexoRouter es Chat Completions.
Claude Code	No soportado por la API pública actual	Claude Code usa un gateway compatible con Anthropic, no un endpoint OpenAI-compatible `/chat/completions`.
Gemini CLI	No soportado por la API pública actual	Gemini CLI espera comportamiento nativo de Gemini salvo que una versión actual agregue modo compatible.

Cuando algo falla

Empieza por el código de error y el Dashboard:

invalid_api_key: revisa header, valor de key, expiración y estado enabled.
model_not_found: copia el model ID exacto desde Models y revisa el alcance de modelos de la key.
Costo inesperado de modelo: revisa model ID, prompt tokens, completion tokens, retries y loops agénticos en Usage Logs.
insufficient_quota: revisa Billing y el presupuesto de la key.
rate_limit_exceeded o token_rate_limit_exceeded: espera la ventana de retry o reduce volumen.
request_too_large: reduce el input; reintentar el mismo payload no va a funcionar.
upstream_request_timeout: sube el timeout del cliente o prueba otro modelo.