Inicio rápido

Esta guía deja funcionando una primera solicitud OpenAI-compatible con NexoRouter en pocos minutos.

Ruta

Qué necesitas

• Una cuenta de NexoRouter.
• Saldo prepago en Billing.
• Una API key activa desde Dashboard -> API Keys.
• Un model ID público vendible desde Models.

1. Crea una API key

Abre Dashboard -> API Keys y crea una key.

Valores recomendados para una primera prueba:

Copia la key completa cuando aparezca. Guárdala en una variable de entorno y no la pegues en Git, capturas, tickets o chats públicos.

export NEXOROUTER_API_KEY="your_nexorouter_key"

2. Configura la base URL

Usa la base URL de producción:

https://api.nexorouter.com/v1

La mayoría de SDKs y herramientas quieren la base URL solo hasta /v1. No agregues /chat/completions salvo que la herramienta pida explícitamente un endpoint completo.

3. Elige un modelo

Abre Models y copia el model ID exacto. Los model IDs distinguen mayúsculas y minúsculas.

Buenas opciones iniciales:

4. Envía una solicitud

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": "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.

5. Usa un OpenAI SDK

Usa el SDK de OpenAI solo con la base URL explícita de NexoRouter. Mantener la base URL oficial de OpenAI con una key de NexoRouter fallará.

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="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "Reply with one sentence: NexoRouter is connected."}
    ],
)

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

JavaScript:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.NEXOROUTER_API_KEY,
  baseURL: "https://api.nexorouter.com/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [
    { role: "user", content: "Reply with one sentence: NexoRouter is connected." },
  ],
});

console.log(response.choices[0].message.content);

Estilo con variables de entorno:

export OPENAI_API_KEY="$NEXOROUTER_API_KEY"
export OPENAI_BASE_URL="https://api.nexorouter.com/v1"

Usa esto solo para herramientas locales o apps que ya leen OPENAI_API_KEY y OPENAI_BASE_URL. No sobrescribas credenciales reales de OpenAI en un entorno compartido.

Confirma en el Dashboard

Después del request, abre Usage Logs y revisa:

• nombre de API key;
• model ID;
• prompt tokens y completion tokens;
• costo en USD y quota;
• latencia;
• request ID;
• estado success o error.

Si la primera solicitud falla

No envíes tu API key completa a soporte. Envía el nombre de la key, últimos cuatro caracteres, request ID, model ID y hora aproximada.

Siguiente

• API compatible con OpenAI
• Referencia de API
• Integraciones