Claves de OpenRouter: Guía de inicio rápido

URL Base y Autenticación

Tu clave API autentica cada solicitud a nuestro endpoint. Utiliza la URL base https://api.openrouteraikeys.com/v1 y pasa tu clave en el Authorization header. Esta configuración funciona con cualquier SDK compatible con OpenAI porque reflejamos su patrón de autenticación estándar. No necesitas modificar tu biblioteca cliente, solo la configuración de la URL base.

• Encabezado: Authorization: Bearer YOUR_API_KEY
• URL base: https://api.openrouteraikeys.com/v1

Primera solicitud

Envía una solicitud estándar de completación de chat para probar la conectividad y el formato de respuesta. El ID del modelo es uncensored y acepta matrices de mensajes estándar. Este endpoint devuelve solo texto, así que no esperes datos de imagen o audio en la carga útil de respuesta.

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

Integración del SDK de Python

Inicializa el cliente con tu clave y la URL base personalizada. Esto te permite usar la familiar chat.completions.create método sin envolver lógica adicional. La biblioteca maneja la serialización y la lógica de reintento automáticamente por ti.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouteraikeys.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Integración del SDK Node

Configura el OPENAI_API_KEY y OPENAI_BASE_URL variables de entorno o pásalas directamente al constructor del cliente. Esto asegura que todas las llamadas subsiguientes se enruten a través de nuestro endpoint sin censura. Puedes continuar usando la misma versión del SDK que ya tienes instalada.

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Respuestas en streaming

Habilita la transmisión estableciendo stream: true en tu solicitud. La API devuelve fragmentos de Eventos Enviados por Servidor (SSE) a medida que el modelo genera texto. Las estadísticas de uso de tokens aparecen en el último fragmento del flujo, permitiéndote rastrear los costos en tiempo real sin esperar a la respuesta completa.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Límites, Errores & Contexto

La ventana de contexto admite 100.000 tokens en total para prompt y completion. Tienes un límite de 300 solicitudes por minuto por clave. Un error 401 significa que tu clave API es inválida o falta. Un error 402 indica que hay un saldo prepagado insuficiente. Un error 429 señala que has superado el límite de velocidad. Las denegaciones por política de contenido son gratuitas, pero los errores de cálculo pueden consumir tokens.