Guía de inicio rápido de la API de OpenRouter dolphin

URL Base y Autenticación

La URL base para todas las solicitudes es https://api.openrouterdolphin.com/v1. Autentícate pasando tu clave API en el Authorization

Copycurl https://api.openrouterdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 libraries for Python web scraping."}]
  }'

La autenticación es estricta. No admitimos múltiples claves por cuenta. Generar una nueva clave invalida inmediatamente la anterior. Esto garantiza un seguimiento limpio del uso de tus créditos prepagados.

Punto final: POST /v1/chat/completions

Envía datos de texto para generar respuestas utilizando el uncensored modelo. Este endpoint maneja todas las finalizaciones de chat estándar. Defines el modelo, los mensajes y los parámetros en el cuerpo de la solicitud.

Copyfrom openai import OpenAI

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

La API devuelve un objeto JSON estándar que contiene el texto generado. No admite incrustaciones, imágenes ni audio. Concéntrate en flujos de trabajo de generación de texto. El modelo responde a las indicaciones sin filtrar temas adultos legales o controvertidos.

Punto final: GET /v1/models

Recupera los modelos disponibles mediante una sencilla solicitud GET. Este punto de conexión confirma el ID del modelo que debes utilizar.

Copyimport OpenAI from "openai";

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

La respuesta lista el uncensored modelo. Usa este ID exacto en tus solicitudes de finalización. La API sirve solo este modelo único. No hay lógica de enrutamiento ni selección de modelos. Interactúas directamente con nuestra instancia dedicada de LLM sin censura.

Datos de uso de streaming

Habilita la transmisión estableciendo stream: true. La API devuelve fragmentos mediante Server-Sent Events (SSE). Cada fragmento contiene una parte del texto de la respuesta.

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)

El último fragmento incluye las estadísticas completas de uso de tokens. Pagas estrictamente por los tokens de salida generados. Los errores y las denegaciones no generan cargos. Esta estructura permite la renderización en tiempo real de las respuestas en tus aplicaciones.

Parámetros: Temperatura, Top P y Tools

Controla el comportamiento de generación con parámetros estándar. Configura temperature para aleatoriedad y top_p para muestreo por núcleo. Habilita la llamada de funciones proporcionando un tools array.

Usar response_format con {"type": "json_object"} para salida JSON estricta. También puedes establecer seed para reproducibilidad. La API admite presence_penalty y frequency_penalty para ajustar el uso de palabras. Estos parámetros funcionan exactamente como lo hacen en los clientes estándar de OpenAI.

Límites de velocidad y tamaño de solicitud

Cada clave de API permite 300 solicitudes por minuto. Puedes tener hasta 8 solicitudes concurrentes en cualquier momento. El tamaño máximo del cuerpo de la solicitud es de 8 MB. La ventana de contexto admite 100,000 tokens para la entrada y la salida combinadas.

La salida máxima por solicitud es de 16.000 tokens. Si no estableces max_tokens, el valor predeterminado es 2,048 tokens. Exceder estos límites devuelve un error 429. Planifica tu estrategia de agrupación en consecuencia. Los créditos nunca caducan, por lo que puedes acumular uso con el tiempo sin presión.