Documentación de la API para completados de chat sin censura

Inicio rápido: Conecta en Python o JavaScript

Conéctate a la API actualizando tu URL base y estableciendo tu clave API. El endpoint acepta solicitudes estándar de finalización de chat y devuelve texto. No necesitas instalar bibliotecas personalizadas si usas los SDKs oficiales de OpenAI, ya que la interfaz coincide exactamente con su especificación.

Comienza con una solicitud HTTP simple para verificar la conectividad. Usa el comando curl a continuación para enviar una solicitud básica a la uncensored modelo. Reemplaza YOUR_API_KEY con la clave generada en tu panel de control.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Para desarrolladores de Python, el proceso es casi idéntico. Inicializa el cliente con tu clave y la URL base correcta. Esto asegura que todas las solicitudes se enruten a través de nuestros servidores sin censura mientras mantiene la compatibilidad con las herramientas existentes.

Copyfrom openai import OpenAI

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

Los usuarios de JavaScript pueden lograr el mismo resultado usando el SDK de Node. Establece el baseURL propiedad a nuestro endpoint. Este enfoque te permite integrar la API en servidores web o servicios backend con cambios mínimos de código.

Copyimport OpenAI from "openai";

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

Gestión de autenticación y clave API

La autenticación se basa en una única clave API pasada en el encabezado. Pasa esta clave en el Authorization header para cada solicitud. Si la clave falta o no es válida, la API devuelve un error 401 inmediatamente. Esto asegura un acceso seguro a tu crédito prepagado.

Genera tu clave en el panel de control. La clave se muestra una vez al crearla. Almacénala de forma segura en tus variables de entorno. No la compartas públicamente. Cada cuenta admite una clave activa a la vez. Generar una nueva clave invalida la anterior al instante.

Utiliza la clave en tus solicitudes así: Authorization: Bearer YOUR_API_KEY. Este formato de encabezado estándar funciona con todos los SDKs principales. Mantén tu clave a mano para una iteración rápida durante el desarrollo.

Parámetros del endpoint Chat Completions

Envía solicitudes a /v1/chat/completions endpoint. Incluye tu array de mensajes y establece el modelo en uncensored. Puedes ajustar parámetros como temperature y top_p para controlar la creatividad. Valores más altos producen respuestas más variadas.

Establecer max_tokens para limitar la longitud de la salida. El valor predeterminado es de 2,048 tokens si no se especifica. El modelo admite una ventana de contexto de 100,000 tokens para prompt más completación. Esto permite conversaciones largas sin truncamiento. Ajusta presence_penalty y frequency_penalty para reducir la repetición en escenarios de roleplay.

Utiliza el stop parámetro para detener la generación en frases específicas. Esto ayuda a imponer la estructura del diálogo. El seed parameter asegura salidas reproducibles para pruebas. Estas herramientas te dan un control preciso sobre el comportamiento del modelo.

Respuestas en streaming y datos de uso

Habilita la transmisión estableciendo stream: true en tu solicitud. La API devuelve fragmentos de texto a medida que se generan. Esto reduce la latencia percibida para los usuarios finales. Cada fragmento incluye texto parcial y metadatos.

Los datos de uso aparecen en el último fragmento. Esto incluye los recuentos de tokens de entrada y salida. Consulta la usage field in the last response object. This allows accurate billing verification without separate API calls. Track token consumption in real-time.

Maneja el término del flujo con cuidado. Asegúrate de procesar todos los fragmentos antes de cerrar la conexión. El último fragmento contiene las estadísticas completas de uso. Estos datos son esenciales para monitorear el costo y el rendimiento en aplicaciones de producción.

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)

Gestión de errores y límites de velocidad

La API limita a 300 solicitudes por minuto por clave. Las solicitudes concurrentes están limitadas a ocho por clave. El cuerpo de la solicitud no debe superar los 8 MB. Superar estos límites devuelve un error 429. Implementa una retroalimentación exponencial para manejar picos transitorios.

Los errores comunes incluyen 401 para claves inválidas y 402 por crédito insuficiente. Una respuesta 402 indica que tu saldo prepagado se ha agotado. Recarga tu cuenta para reanudar el servicio. Los errores no consumen tokens, por lo que reintentar después de corregir el problema es gratuito.

Comprueba el cuerpo de la respuesta para ver mensajes de error detallados. La API devuelve un objeto JSON con un tipo de error y un mensaje. Utiliza esta información para depurar problemas rápidamente. Un manejo adecuado de errores garantiza una experiencia fluida para tus usuarios durante períodos de alto tráfico.

guía del modo JSON y llamada de funciones

Usa el modo JSON estableciendo response_format para {"type": "json_object"}. Esto obliga al modelo a generar JSON válido. Ideal para la extracción de datos estructurados o respuestas de API. Asegúrate de que tu prompt describa claramente el esquema deseado.

La invocación de funciones permite al modelo invocar herramientas. Define las herramientas en el cuerpo de la solicitud. El modelo devuelve llamadas a herramientas cuando es apropiado. Maneja estas llamadas en la lógica de tu aplicación. Esto habilita flujos de trabajo complejos de múltiples pasos.

Combina el modo JSON con la llamada de funciones para integraciones robustas. Valida la salida JSON en el lado del cliente. Utiliza el tool_choice parámetro para controlar cuándo se invocan las funciones. Esta flexibilidad admite diversas arquitecturas de aplicaciones. Asegúrate de que tus herramientas estén bien definidas para un rendimiento óptimo.

Detalles del modelo y límites de la ventana de contexto

El uncensored el modelo admite una ventana de contexto de 100.000 tokens. Esto incluye tanto la indicación de entrada como la finalización de salida. La salida máxima es de 16.000 tokens por solicitud. Esto permite escenarios de roleplay extensos sin cortarse a mitad de frase.

El modelo es de pesos abiertos y está ajustado para contenido sin restricciones. No rechaza temas adultos legales. No es GPT, Claude ni ningún otro modelo de proveedor. Las solicitudes se procesan en nuestros servidores dedicados. Esto garantiza un rendimiento constante y una baja latencia.

Monitora el uso del contexto para mantenerse dentro de los límites. La API rastrea el uso de tokens con precisión. Los errores y las denegaciones no consumen tokens. Este modelo de facturación transparente te ayuda a predecir los costes. Planifica tus ventanas de contexto para maximizar el valor.