Documentación de la API

Autenticación y URL base

La API requiere una única clave API para la autenticación. Recibes esta clave inmediatamente después de registrarte con Google o una dirección de correo electrónico. Pásala en el Authorization cabecera como un token Bearer. La URL base es https://api.topuncensored.com/v1. Esta URL funciona con cualquier SDK o biblioteca cliente compatible con OpenAI.

• Utiliza la cabecera: Authorization: Bearer YOUR_API_KEY
• Configura la URL base de tu cliente al punto final proporcionado.

Esta configuración asegura que puedas cambiar bibliotecas sin modificar tu lógica principal.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Endpoint Chat Completions

Envía prompts de texto al /v1/chat/completions endpoint. El ID del modelo es uncensored. Este endpoint maneja el formato estándar de chat con mensajes. Devuelve respuestas de texto directamente. No hay capas ni envoltorios adicionales. Controlas la ventana de contexto de 100.000 tokens. Las solicitudes de menos de 8 MB funcionan de forma fiable. Úsalo para generación de texto directa.

Estructura tu solicitud con un prompt de system y un mensaje de user. El modelo responde sin filtrar contenido adulto lícito. Los errores como claves faltantes devuelven 401. ¿Te quedaste sin crédito? Recibes un error 402. Estas son señales claras.

Respuestas en streaming

Habilita la transmisión estableciendo stream: true. Recibes fragmentos de texto a medida que se generan. Esto reduce la latencia percibida para salidas largas. El último fragmento incluye datos de uso de tokens. Úsalo para visualizaciones en tiempo real o renderizado progresivo. Es eficiente para aplicaciones de alto volumen.

Analiza cada fragmento para construir tu respuesta final. Este método maneja grandes salidas con gracia. La API soporta Server-Sent Events estándar. Este es el enfoque recomendado para aplicaciones interactivas.

Copyfrom openai import OpenAI

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

Llamada de Herramientas y Modo JSON

Usa la llamada a funciones para interacciones estructuradas. Define las herramientas en tu solicitud. El modelo devuelve argumentos estructurados. Establece response_format para {"type": "json_object"} para salida JSON estricta. Esto asegura formatos de datos predecibles. Combina estas características para integraciones robustas. Obtienes un control preciso sobre la estructura de la salida.

La llamada de herramientas funciona con el esquema estándar de OpenAI. El modo JSON fuerza JSON válido. Utiliza esto para integraciones de API o extracción de datos. Esta flexibilidad admite flujos de trabajo complejos.

Copyimport OpenAI from "openai";

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

Parámetros y límites

Ajustar temperature, top_p, y stop secuencias. Establece max_tokens a 16,000. El predeterminado es 2,048 si se omite. Controla la repetición con presence_penalty y frequency_penalty. Utiliza seed para salidas deterministas. Estos parámetros ajustan la calidad de la generación. Tienes control total sobre el estilo de salida.

Los límites de tasa son de 300 solicitudes por minuto. Las solicitudes concurrentes están limitadas a 8. Estos límites garantizan un rendimiento estable. Monitorea tu uso a través del panel de control. Ajusta los parámetros para optimizar según tu caso de uso específico.

Errores y Ventana de Contexto

Gestiona los errores de forma elegante. 401 significa clave no válida. 402 indica crédito insuficiente. 429 indica límites de velocidad. La ventana de contexto es de 100,000 tokens en total. La salida máxima es de 16,000 tokens. Gestiona tus tokens con prudencia. Los errores no consumen crédito. Esto ahorra dinero durante la depuración. Usa el último fragmento para las estadísticas de uso.

Rastrea tu uso de tokens. Evita superar los límites de velocidad. Reintenta con retroceso exponencial. Esto garantiza un funcionamiento fiable. La API está diseñada para ser robusta. Maneja los errores como parte del flujo normal.

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)