Instalación y configuración
Empieza instalando el SDK oficial para tu lenguaje. El cliente solo requiere tu clave API y la URL base correcta para enrutar las solicitudes a nuestros servidores. Esta configuración funciona con cualquier cliente estándar compatible con OpenAI.
Configura las variables de entorno o pásalas directamente al constructor del cliente. No necesitas gestionar lógica de enrutamiento compleja ni cambiar entre múltiples modelos. El único modelo uncensored maneja todas las solicitudes.
- Instala el paquete mediante tu gestor de paquetes.
- Establece la clave de la API desde tu panel de control.
- Apunta el cliente al endpoint de la API.
Realizando tu primera solicitud
Envía una solicitud POST al endpoint de chat completions con el ID del modelo establecido en "uncensored". Esto devuelve una respuesta de texto directa del modelo, omitiendo los filtros de contenido estándar. Puedes enviar prompts simples o instrucciones de sistema complejas.
La API acepta parámetros estándar como temperature y top_p. Usa el siguiente comando cURL para verificar la conectividad y la calidad de la respuesta de inmediato.
curl https://api.chatbotunrestricted.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
}'Esta respuesta confirma que el modelo está activo y listo para tráfico de producción.
Gestión de respuestas en streaming
Habilita el streaming estableciendo el parámetro stream en true. La API devuelve un flujo de eventos enviados por el servidor (SSE), entregando tokens a medida que se generan. Esto reduce significativamente la latencia percibida para los usuarios finales.
Analiza los fragmentos SSE para actualizar tu interfaz de usuario en tiempo real. El fragmento final incluye el uso total de tokens para la solicitud. Este enfoque es esencial para interfaces de chat donde los usuarios esperan retroalimentación instantánea.
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)Asegúrate de que tu cliente maneje correctamente el evento de finalización del flujo.
Usando herramientas y llamada de funciones
Define las herramientas en tu solicitud para permitir que el modelo genere llamadas a funciones estructuradas. Pasa las definiciones de las herramientas en el array tools y especifica tool_choice para la selección automática. El modelo devuelve llamadas a funciones en el contenido de la respuesta.
Analiza los argumentos de la función y ejecútalos en tu código. Luego, pasa los resultados de vuelta al modelo en un mensaje posterior. Este ciclo permite flujos de trabajo complejos de múltiples pasos sin lógica de análisis externa.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatbotunrestricted.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);Valida siempre el esquema de salida antes de la ejecución.
Gestión de tokens y límites
La ventana de contexto admite 100,000 tokens combinados para prompt y completion. Cada solicitud puede generar hasta 16,000 tokens, o 2,048 si se omite max_tokens. Monitorea tu uso mediante los recuentos de tokens en la respuesta.
Los límites de velocidad permiten 300 solicitudes por minuto y 8 solicitudes concurrentes por clave. Exceder estos límites activa un error 429. Mantén tu clave única por cuenta para evitar compartir límites.
Errores como 401 indican una clave inválida, mientras que 402 significa que necesitas más crédito. Las denegaciones por violaciones menores de contenido son gratuitas y no consumen tokens.
Gestión de errores y resolución de problemas
Gestiona los errores HTTP de forma elegante en la lógica de tu aplicación. Un estado 401 significa que tu clave API es incorrecta o ha expirado. Comprueba tu panel de control para asegurarte de que la clave esté activa.
Un estado 402 indica crédito prepagado insuficiente. Recarga usando USDT o USDC para reanudar el servicio. El error 429 indica que has alcanzado el límite de velocidad. Espera y reintenta con retroceso exponencial.
Los cuerpos de solicitud inválidos devuelven un error 400. Verifica que tu estructura JSON coincida con la especificación de la API. Estos errores son gratuitos y no descuentan de tu saldo.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.chatbotunrestricted.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)