Compatibilidad con SDK y configuración de la URL base
Conecta tu código cliente existente apuntándolo a nuestro punto de conexión dedicado. Esto API compatible con OpenAI acepta encabezados estándar y configuraciones de SDK sin cambios en el código. Solo necesitas actualizar la URL base y proporcionar tu clave API desde el panel de control.
https://api.openrouterratelimits.com/v1 es el único punto de entrada para todas las solicitudes. La autenticación utiliza el esquema estándar de token Bearer que se encuentra en la mayoría de las bibliotecas de LLM modernas. Pasa tu clave en el Authorization header para verificar tu identidad. Esta configuración funciona con cualquier cliente que espere una interfaz estilo OpenAI, lo que hace que la migración sea instantánea para equipos cansados del bloqueo de proveedor.
- URL base:
https://api.openrouterratelimits.com/v1 - Cabecera de autenticación:
Authorization: Bearer YOUR_API_KEY - ID del Modelo:
uncensored
Respuestas en streaming con SSE
Habilita la transmisión estableciendo stream: true en tu carga útil de solicitud. La API devuelve Eventos Enviados por el Servidor (SSE) para la entrega de tokens en tiempo real. Cada fragmento contiene el texto generado hasta que el último fragmento incluya las estadísticas de uso. Este enfoque mantiene tu interfaz de usuario receptiva incluso para ventanas de contexto largas.
El streaming es ideal para interfaces de chat o escenarios de roleplay donde importa la latencia. No necesitas esperar a que se complete toda la generación para mostrar el texto. El último fragmento siempre contiene los recuentos de tokens para un facturación precisa. Los errores durante el streaming siguen devolviendo códigos de estado HTTP adecuados para un manejo inmediato.
Llamada a funciones y modo JSON
Utiliza salidas estructuradas para la extracción fiable de datos o la integración de herramientas. Habilita response_format con {"type": "json_object"} para forzar el cumplimiento de JSON. Este modo es esencial para analizar estructuras anidadas complejas sin lógica de limpieza adicional. La llamada de funciones funciona junto con la generación de texto estándar para flujos de trabajo de agentes dinámicos.
Define tus herramientas en la tools array y especifica tool_choice para una aplicación estricta. El modelo devuelve llamadas a funciones en el formato estándar de OpenAI. Esta función admite llamadas a herramientas individuales y múltiples dentro de un solo turno. Úsalo para construir agentes que interactúen con APIs o bases de datos externas de forma fiable.
Gestión de tokens y parámetros
Controla el comportamiento de generación con parámetros estándar como temperature, top_p, y stop. La ventana de contexto soporta hasta 100,000 tokens para prompt y finalización combinados. Esto permite un contexto histórico extenso o el procesamiento de documentos grandes en una sola solicitud.
Establecer max_tokens para limitar la longitud de la salida, con un valor predeterminado de 2,048 si se omite. El modelo maneja presence_penalty y frequency_penalty para el control estilístico. El uso de tokens se cobra según los recuentos reales de entrada y salida. Los errores no consumen tokens, garantizando un cobro justo para las solicitudes fallidas.
Comprender los límites de velocidad por clave
Cada clave de API admite 300 solicitudes por minuto con un límite de concurrencia de 8 solicitudes simultáneas. Este límite se aplica por clave, por lo que crear varias claves escala tu rendimiento de forma lineal. El tamaño máximo del cuerpo de la solicitud es de 8 MB, lo que se ajusta dentro de la ventana de contexto para la mayoría de los casos de uso.
Los límites de velocidad se restablecen continuamente basándose en una ventana deslizante. Si excedes el límite, la API devuelve un error 429. Actualiza tu crédito prepagado para mantener el acceso prioritario. A diferencia de las capas compartidas, nuestros servidores dedicados no sufren interferencias de otros usuarios. Monitorea tu panel de uso para mantenerte dentro de estos límites y garantizar un rendimiento constante.
Resolución de errores comunes
Gestiona los errores comprobando el código de estado HTTP y el cuerpo de la respuesta. Un error 401 indica una clave API inválida o ausente. Regenera tu clave desde el panel si falla la autenticación. Un error 402 significa que tu crédito prepagado se ha agotado; recarga mediante criptomonedas para reanudar el servicio.
Un error 429 señala que has excedido los límites de velocidad. Reduce la frecuencia de tus solicitudes o divide las cargas de trabajo entre varias claves. La API no cobra tokens por estos errores, así que no pierdes crédito por los reintentos. Asegúrate de que tu biblioteca cliente maneje los reintentos con retroceso exponencial para mayor robustez.
cURL
curl https://api.openrouterratelimits.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Process one million logs"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterratelimits.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterratelimits.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);Transmisió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)