Documentación

Haz tu primera llamada a la API en la documentación de NexoRouter.

Haz tu primera llamada a la API

Esta guía envía una solicitud OpenAI-compatible de Chat Completions a NexoRouter usando la base URL de producción y un model ID exacto del catálogo.

Qué necesitas

  • Una cuenta de NexoRouter con saldo prepago.
  • Una API key de Dashboard -> API Keys, guardada como NEXOROUTER_API_KEY.
  • Un model ID actual copiado de Modelos o de GET /v1/models.

Nunca pegues una key real en Git, capturas, tickets o chats.

Endpoint

Base URL: https://api.nexorouter.com/v1
Header: Authorization: Bearer $NEXOROUTER_API_KEY
Method: POST /chat/completions

La mayoría de SDKs quieren la base URL solo hasta /v1. No agregues /chat/completions a menos que la herramienta pida el endpoint completo.

Copia un model ID exacto

Los model IDs son cadenas del catálogo y distinguen mayúsculas. No envíes un nombre de marketing.

Catalog IDNotas
kimi-k2.6Starter de la documentación para la primera prueba de Chat Completions.
gpt-5.5Usa gpt-5.5, no una etiqueta de interfaz.
gpt-5.6-lunaUsa gpt-5.6-luna, no “GPT-5.6 LUNA”.
grok-4.3Available en el catálogo público cuando aparece listado.

Si un ID no está en Models, no lo uses. Confirma la lista actual antes de copiar ejemplos de notas viejas.

curl

export NEXOROUTER_API_KEY="your_nexorouter_key"

curl https://api.nexorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $NEXOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k2.6",
    "messages": [
      { "role": "system", "content": "You are a concise assistant." },
      { "role": "user", "content": "Reply with one sentence: NexoRouter is connected." }
    ],
    "temperature": 0.7,
    "max_tokens": 128
  }'

Una respuesta exitosa contiene el texto en choices[0].message.content.

OpenAI SDK (Python)

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NEXOROUTER_API_KEY"],
    base_url="https://api.nexorouter.com/v1",
)

response = client.chat.completions.create(
    model="kimi-k2.6",
    messages=[
        {"role": "user", "content": "Reply with one sentence: NexoRouter is connected."}
    ],
)

print(response.choices[0].message.content)

Verifica

  1. Confirma que el HTTP status sea 200.
  2. Abre Usage Logs y busca request ID, model ID, tokens, costo y latencia.
  3. Si la llamada devuelve insufficient_quota, agrega saldo prepago y reintenta.
  4. Si devuelve model_not_found, copia de nuevo el ID desde Models y revisa el alcance de la key.

Páginas relacionadas