URL Base y Autenticación
Conéctate a la API utilizando la URL base proporcionada y tu clave de API. Este endpoint funciona con SDKs estándar de OpenAI simplemente actualizando la configuración. Recibes una clave activa por cuenta, que generas mediante Google o correo electrónico durante el registro. La clave autentica cada solicitud que realizas al servicio.
curl https://api.hubuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Generate a JSON object with user id and role"}]
}'Mantén tu clave segura. Si generas una nueva, la clave anterior se vuelve inválida inmediatamente. Esto asegura que siempre controlas el acceso a tu crédito prepagado sin permisos residuales.
Endpoint Chat Completions
Envía tus datos de prompt al endpoint de finalización de chat para la generación de texto. Esta es la interfaz principal para tus aplicaciones, manejando toda la entrada y salida de texto. Debes especificar el modelo como 'uncensored' para garantizar un comportamiento consistente. La API procesa tu solicitud y devuelve la respuesta de texto generada.
from openai import OpenAI
client = OpenAI(base_url="https://api.hubuncensored.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)Errores como 401 indican una clave inválida, mientras que 402 significa que necesitas más crédito. Las solicitudes se cobran según el uso real de tokens, por lo que los errores no agotan tu saldo.
Respuestas en streaming vía SSE
Recibe tokens en tiempo real utilizando Eventos Enviados por Servidor (SSE). Este método reduce la latencia percibida para salidas largas entregando datos a medida que se generan. Puedes analizar el fragmento final para obtener estadísticas precisas de uso de tokens para facturación. La transmisión es ideal para interfaces orientadas al usuario donde importa la retroalimentación inmediata.
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)La ventana de contexto permite 100,000 tokens en total, incluyendo tanto el prompt como la completación. El streaming no cambia los límites de tokens subyacentes ni la estructura de precios.
Llamada de Función y Modo JSON
Usa la llamada a funciones para integrar salidas estructuradas en tu flujo de trabajo. Especifica herramientas y tool_choice para guiar el formato de respuesta del modelo. También puedes imponer un modo JSON estricto usando el parámetro response_format para un análisis fiable. Esto asegura que tu aplicación reciba datos en la estructura exacta que defines.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.hubuncensored.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);Estas características funcionan dentro del único modelo sin censura. No hay enrutamiento de modelos ni elección entre diferentes proveedores. Dependes de un modelo de peso abierto ajustado para contenido sin restricciones.
Parámetros: Temperatura, Top P y Stop
Controla el comportamiento de generación con parámetros estándar como temperature y top_p. Ajusta estos valores para equilibrar la creatividad y la determinismo en tus resultados. El parámetro stop te permite detener la generación en secuencias específicas. También puedes configurar presence_penalty y frequency_penalty para refinar el estilo de salida.
Establece max_tokens a 16,000 para respuestas largas. Si omites max_tokens, el valor predeterminado es de 2,048 tokens por solicitud. Estas configuraciones te dan un control preciso sobre el proceso de generación.
Límites, Errores y Ventana de Contexto
Monitorea tu uso contra límites estrictos de velocidad para asegurar un funcionamiento fluido. Tienes permitido 300 solicitudes por minuto y 8 solicitudes concurrentes por clave. El tamaño máximo del cuerpo de la solicitud es de 8 MB. Exceder estos límites devuelve un error de límite de velocidad 429. Comprender estas restricciones te ayuda a diseñar una lógica de reintento robusta.
La ventana de contexto admite un total de 100.000 tokens. Esto incluye tanto el prompt de entrada como la completación generada. Planifica el uso de tokens en consecuencia para evitar truncamientos o errores.
