URL base y autenticación
Nuestra API es totalmente compatible con OpenAI, lo que significa que puedes usar cualquier SDK estándar con cambios mínimos. La URL base para todas las peticiones es https://api.openrouterapi.top/v1. La autenticación se maneja mediante un token Bearer pasado en el encabezado Authorization. Puedes generar esta clave al instante registrándote con Google o una dirección de correo electrónico en nuestro panel. Mantén tu clave segura, ya que proporciona acceso directo a tu crédito prepago.
Primera petición
Prueba el endpoint con un comando curl sencillo. Reemplaza YOUR_API_KEY con tu clave real. El ID del modelo se establece en uncensored para evitar las negaciones estándar de contenido. Esta petición envía un prompt y espera la respuesta completa.
curl https://api.openrouterapi.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Si la clave no es válida, recibirás un error 401. Si tu saldo prepago se agota, recibirás un error 402. Estos errores no consumen tu saldo de tokens, pero sí cuentan para tu cuota de límite de peticiones.
Integración con SDK de Python
Usar el paquete de Python oficial openai es sencillo. Inicializa el cliente con tu URL base y clave. El SDK maneja la serialización JSON automáticamente. Este ejemplo muestra una petición básica de completado de chat.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterapi.top/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)Asegúrate de tener instalada la última versión del SDK. El objeto cliente gestiona el grupo de conexiones, por lo que puedes reutilizarlo para múltiples peticiones sin reinicializar.
Integración con SDK de Node.js
Para entornos JavaScript, el SDK de Node.js funciona de manera idéntica. Pasa la URL base personalizada durante la inicialización. Este enfoque te permite integrar la generación sin censura en aplicaciones web o servicios backend existentes sin problemas.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterapi.top/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);El SDK de Node.js admite tanto patrones basados en promesas como async/await. El manejo de errores es consistente con otros servicios compatibles con OpenAI.
Respuestas en streaming
Habilita el streaming estableciendo stream: true en tu petición. La API devuelve Server-Sent Events (SSE). Cada fragmento contiene texto parcial. El último fragmento incluye las estadísticas de uso de tokens para la facturación.
stream = 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)El crédito prepago se cobra en función de los tokens reales generados en la salida final. El streaming no cambia el modelo de precios; pagas por los tokens que se entregan con éxito.
Límites de peticiones y ventana de contexto
Cada clave de API está limitada a 300 peticiones por minuto y 8 peticiones simultáneas. El tamaño máximo del cuerpo de la petición es de 8 MB. La ventana de contexto admite hasta 100.000 tokens en total (entrada más salida). La salida máxima por petición es de 32.000 tokens, o 2.048 si max_tokens no está establecido. Errores como 401 o 402 no consumen crédito, pero sí cuentan para tu límite de peticiones. Las negaciones por tipos de contenido específicos también son gratuitas.
