Documentación de la API
Integra la API de IA de open router en tu stack existente actualizando tu URL base y clave API. Esta compatibilidad plug-and-play te permite generar texto sin restricciones usando protocolos estándar de OpenAI sin reescribir la lógica de tu aplicación.
URL Base y Autenticación
El endpoint de la API reside en https://api.openrouteraiapi.com/v1. Pasa tu clave API en el Authorization header como token bearer. Este header es el único cambio necesario para redirigir el tráfico desde tu proveedor actual a nuestro modelo sin censura.
La autenticación es estricta. Si falta la clave o es inválida, el servidor devuelve un error 401 inmediatamente. Puedes generar una clave al instante mediante Google o correo electrónico en el panel. Mantén la clave segura, ya que otorga acceso a tu crédito prepagado.
Endpoint Chat Completions
Envía solicitudes POST a /v1/chat/completions con un array de mensajes. El identificador del modelo es uncensored. Este único modelo maneja todas tus necesidades de generación de texto sin lógica de enrutamiento compleja.
Aquí tienes una solicitud estándar usando cURL para verificar la conectividad y el formato de respuesta.
curl https://api.openrouteraiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
}'La respuesta incluye el texto generado en el choices[0].message.content campo. Puede analizar esto directamente en el flujo de trabajo de su aplicación.
Integración del SDK de Python
Usa el cliente oficial de Python de OpenAI para conectarte sin esfuerzo. Establece el base_url y api_key variables para apuntar a nuestra infraestructura. Este enfoque minimiza los cambios de código al cambiar de proveedor.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouteraiapi.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)El cliente maneja la serialización y los reintentos automáticamente. Recibes un objeto de finalización que contiene el texto y las estadísticas de uso de tokens. Este método es ideal para servicios backend y scripts.
Uso del SDK de Node.js
Inicializa el cliente de Node.js de OpenAI con tu URL base personalizada. Esto permite que las aplicaciones JavaScript interactúen con el modelo sin censura utilizando métodos familiares. El SDK gestiona las solicitudes HTTP de manera eficiente.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouteraiapi.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);Llamar chat.completions.create() con tus mensajes. El objeto de respuesta proporciona acceso al contenido generado y a los datos de uso. Esta integración funciona bien para servidores web y funciones de borde.
Respuestas en streaming
Habilita la transmisión estableciendo stream: true en tu solicitud. El servidor devuelve Server-Sent Events (SSE) para la entrega de tokens en tiempo real. Esta función reduce la latencia percibida para los usuarios finales.
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)Cada fragmento contiene contenido parcial. El fragmento final incluye las estadísticas completas de uso de tokens. Maneja estos eventos en tu cliente para actualizar la interfaz de usuario de forma incremental.
Límites, Errores y Ventana de Contexto
La ventana de contexto admite 100,000 tokens para la entrada y salida combinadas. Cada solicitud puede generar hasta 16,000 tokens, o 2,048 si max_tokens no está establecido. Los límites de tasa permiten 300 solicitudes por minuto por clave.
Los errores son códigos HTTP estándar. Un 401 indica una clave inválida. Un 402 significa que se ha agotado tu crédito prepagado. Un 429 indica que has excedido el límite de velocidad. Las solicitudes fallidas no consumen crédito. Los errores son gratuitos.
Preguntas y respuestas
¿Cómo maneja la API open router AI las fallas de autenticación?
La API devuelve un código de estado 401 Unauthorized si falta el encabezado o la clave es inválida. Esto ocurre inmediatamente al realizar la solicitud. Verifica tu panel de control para asegurarte de que la clave esté activa y sea correcta.
¿Qué sucede si excedo el límite de velocidad?
Recibes un error 429 Too Many Requests. El límite es de 300 solicitudes por minuto por clave. Puedes monitorizar tu uso a través del panel. Aumenta tu crédito o espera a que se restablezca la ventana.
¿El modelo sin censura está limitado por una ventana de contexto de 100,000 tokens?
Sí, la ventana de contexto total es de 100,000 tokens tanto para la entrada como para la salida. Puedes generar hasta 16,000 tokens por solicitud. Esto permite un procesamiento extenso de documentos sin interrupciones.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.
