NexoRouter

Documentación

Referencia de API en la documentación de NexoRouter.

Referencia de API

Esta página documenta la superficie pública estable actual de la API compatible con OpenAI.

Solo los endpoints documentados aquí son compromisos de soporte del producto. Otros paths bajo /v1 pueden pasar por el gateway, pero no son promesas de API pública estable hasta que aparezcan en esta referencia.

Base URL

https://api.nexorouter.com/v1

Autenticación

Authorization: Bearer YOUR_NEXOROUTER_API_KEY

GET /models

Devuelve model IDs disponibles públicamente.

Request

curl https://api.nexorouter.com/v1/models \
  -H "Authorization: Bearer $NEXOROUTER_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "deepseek-v4-flash",
      "object": "model"
    }
  ]
}

La respuesta puede incluir campos adicionales compatibles con OpenAI. Usa id como model ID estable para requests.

POST /chat/completions

Crea una respuesta de chat.

Request body

FieldTypeRequiredNotes
modelstringyesCopia desde Models o GET /v1/models.
messagesarrayyesLista de mensajes compatible con OpenAI, no vacía.
temperaturenumberno0 a 2.
top_pnumberno0 a 1.
max_tokensintegernoEntero positivo.

Request

curl https://api.nexorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $NEXOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      { "role": "user", "content": "Write one short launch checklist." }
    ],
    "max_tokens": 256
  }'

Response

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Create an API key, choose a model, test in Playground, and monitor usage logs."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 18,
    "total_tokens": 38
  }
}

CORS

La API pública responde a preflight CORS de navegador y expone:

  • x-request-id
  • x-ratelimit-limit
  • x-ratelimit-remaining
  • retry-after

Streaming

Streaming no aparece como API pública verificada. Usa chat/completions sin streaming salvo que una página de NexoRouter documente explícitamente el comportamiento de streaming para tu cliente y modelo.

Embeddings

Embeddings no aparece como API pública verificada. Usa un proveedor separado de embeddings hasta que NexoRouter documente comportamiento del endpoint, modelos públicos, precios y Usage Logs.

Límites de endpoints

No asumas soporte para una familia de endpoints salvo que una página la documente explícitamente.

Familias que todavía no están documentadas como API pública estable:

  • OpenAI Responses API
  • Anthropic Messages API
  • Gemini native API
  • image generation
  • video generation
  • audio
Referencia de API — NexoRouter