es ▾
Crea claves

Inicio rápido: Plug-and-Play API Compatible con OpenAI

La compatibilidad con OpenAI Plug-in significa que cambias una URL base y una clave, y luego tu código existente se ejecuta contra nuestro modelo sin censura sin reescribir la lógica. Esta guía rápida te lleva de cero a una respuesta en streaming en minutos.

Cambiar base_url y establecer clave API

El primer paso es apuntar tu SDK a nuestro punto final. Utiliza https://api.whatisopenrouterai.com/v1 como tu URL base y pega tu clave desde el panel. Este único cambio redirige todas las llamadas a nuestro modelo de lenguaje grande sin censura, manteniendo intactos los encabezados estándar compatibles con OpenAI.

  • Genera una clave mediante Google o correo electrónico.
  • Guárdalo en tus variables de entorno.
  • Verifica que la clave funcione con una solicitud sencilla.
curl https://api.whatisopenrouterai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set variable x to five"}]
  }'

Envía solicitudes a /v1/chat/completions

Nuestra API acepta chat completions estándar con entrada de texto y devuelve salida de texto. Envías una solicitud POST a la /v1/chat/completions endpoint con su ID de modelo y el historial de mensajes. El ID del modelo es simplemente uncensored, que ajusta el modelo para responder sin negaciones para contenido adulto lícito.

from openai import OpenAI

client = OpenAI(base_url="https://api.whatisopenrouterai.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)

Transmite tokens con SSE

El streaming proporciona retroalimentación en tiempo real mediante Server-Sent Events. Cada fragmento contiene texto parcial, y el fragmento final incluye las estadísticas de uso de tokens. Este enfoque mantiene tu interfaz de usuario receptiva mientras se completan las respuestas de texto largo.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.whatisopenrouterai.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);

Fuerza json_object con response_format

Utiliza el response_format el parámetro establecido en {"type": "json_object"} para forzar una salida JSON estricta. Esto asegura un análisis predecible para tus aplicaciones sin depender de que el modelo adivine la estructura correcta cada vez.

Utiliza herramientas y tool_choice

La llamada de funciones funciona exactamente como la API estándar de OpenAI. Define tus herramientas en la solicitud, y el modelo devolverá argumentos estructurados cuando sea apropiado. Puedes forzar el uso de herramientas con tool_choice o dejar que el modelo decida según el contexto.

Verificar modelos disponibles

Consulta GET /v1/models para ver el único modelo sin censura disponible. Este extremo devuelve el ID del modelo y los detalles, confirmando que nuestro servicio está activo y listo para recibir solicitudes. No ofrecemos múltiples opciones de modelos, manteniendo la integración simple y enfocada.

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)

Preguntas frecuentes

qué es open router AI

Es una API alojada compatible con OpenAI que ofrece un único modelo de lenguaje grande sin censura. Obtienes un reemplazo directo para el código estándar de OpenAI cambiando la URL base y la clave. El modelo no rechaza contenido adulto lícito, proporcionando una experiencia LLM sin censura real.

¿Cómo manejo límites de tasa y errores?

Recibes un error 401 para una clave inválida, 402 si no tienes crédito y 429 por límites de velocidad. Nuestro límite es de 300 solicitudes por minuto por clave. Los errores y rechazos no consumen tus tokens prepagados.

¿Cuál es el tamaño de la ventana de contexto?

La ventana de contexto es de 100.000 tokens tanto para la entrada como para la salida. La salida máxima por solicitud es de 16.000 tokens, o 2.048 si no especificas max_tokens. Esto permite conversaciones extensas sin truncamiento inmediato.