Inicio rápido: integra en minutos

1. Instala tu SDK

Comienza instalando la biblioteca oficial para tu lenguaje. La mayoría de los desarrolladores prefieren el paquete estándar porque coincide con la interfaz que ya conocen. Ejecuta pip install openai para Python o npm install openai para Node.js. Solo necesita un SDK para manejar todas las solicitudes.

2. Establece tu URL base

Configura tu cliente para apuntar a nuestro endpoint específico. Debes sobrescribir la URL base predeterminada para enrutar el tráfico correctamente. Usa https://api.unsencoredai.com/v1 como tu URL base. Pasa tu clave API en el Authorization header. Esta configuración funciona con cualquier cliente compatible con OpenAI estándar.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Enviar tu primera solicitud

Envía una solicitud estándar de completación de chat para generar texto. El ID del modelo es uncensored. Puedes enviar prompts del sistema para guiar el comportamiento. La API devuelve una respuesta de texto directa. Usa el comando curl a continuación para probar la conectividad inmediatamente. Verifica tu respuesta buscando el choices array.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Maneja las respuestas en streaming

Activa la transmisión para menor latencia y salida en tiempo real. Establece stream: true en tu solicitud. La API envía fragmentos mediante Server-Sent Events. Puedes procesar cada token a medida que llega. Esto es ideal para interfaces de chat o escenarios de roleplay. El último fragmento contiene las estadísticas de uso.

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)

5. Configurar parámetros

Ajustar temperature, top_p, y stop secuencias. Estos controles influyen en la creatividad y la longitud de la salida. También puedes usar response_format para el modo JSON. La ventana de contexto admite 100,000 tokens en total. La salida máxima es de 16,000 tokens por solicitud. Ajuste estos parámetros para su caso de uso específico.

6. Límites, errores y contexto

Gestiona los errores de forma elegante usando códigos de estado HTTP estándar. Un error 401 significa que tu clave API no es válida. Un error 402 indica crédito prepagado insuficiente. Un error 429 indica que has alcanzado el límite de 300 solicitudes por minuto. Tu ventana de contexto es de 100,000 tokens. Las solicitudes superiores a 8 MB pueden fallar. No se emiten reembolsos para el crédito, pero los errores son gratuitos.