Guía de integración: API de completaciones de chat

URL Base y Autenticación

La API de abliteración funciona como un reemplazo directo de los endpoints estándar de OpenAI. Enruta tus solicitudes a https://api.aiabliterated.cc/v1 y autentica usando un token Bearer en el Authorization header. Esta configuración funciona con cualquier cliente que soporte el protocolo de OpenAI.

• URL base: https://api.aiabliterated.cc/v1
• Cabecera de autenticación: Authorization: Bearer YOUR_API_KEY
• ID del Modelo: uncensored

La autenticación es estricta. Si envías una clave inválida, el sistema devuelve un error 401 inmediatamente.

El Endpoint /v1/chat/completions

Envía tus datos de prompt al /v1/chat/completions endpoint para recibir respuestas de texto. El sistema espera una carga útil JSON que contenga el identificador del modelo y tu historial de mensajes. Esta es una interfaz solo de texto; no esperes generación de imágenes o audio.

El modelo procesa entradas y salidas dentro de una ventana de contexto de 100,000 tokens. Si no especificas un límite, el sistema genera por defecto 2,048 tokens por solicitud. Puedes ajustarlo hasta un máximo absoluto de 16,000 tokens.

Copyfrom openai import OpenAI

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

Respuestas en streaming y uso de tokens

Habilita la transmisión estableciendo stream: true en tu carga útil de solicitud. La API devuelve un flujo de Eventos Enviados por el Servidor (SSE) de tokens parciales. Esto reduce significativamente la latencia percibida para aplicaciones interactivas.

Los datos de uso de tokens no se envían con cada fragmento. En su lugar, el último fragmento del flujo contiene las estadísticas completas de uso para esa solicitud. Este diseño mantiene el flujo ligero mientras proporciona datos de facturación precisos. Los errores durante el streaming se manejan cerrando la conexión con un objeto JSON de error.

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)

Llamada de Función y Modo JSON

El modelo abliterado admite salidas estructuradas mediante el response_format parámetro. Establece esto a {"type": "json_object"} para forzar un cumplimiento estricto de JSON. Esto es esencial para una integración confiable con sistemas backend.

La llamada a funciones también está disponible. Define herramientas en tu solicitud, y el modelo generará JSON válido que coincida con tu esquema. El sistema no valida tus definiciones de herramientas, así que asegúrate de que tus esquemas sean correctos antes de enviar solicitudes. Esta capacidad permite arquitecturas de agentes complejos sin capas de análisis externas.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.aiabliterated.cc/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: Temperatura, Top-P y Seed

Controla la aleatoriedad de tus salidas mediante parámetros de muestreo estándar. El temperature valor ajusta la creatividad, mientras que top_p limita el muestreo del núcleo. Usa seed para salidas deterministas cuando necesites resultados reproducibles para la depuración.

Otros parámetros disponibles incluyen stop secuencias, presence_penalty, y frequency_penalty. Estos permiten un control afinado sobre la repetición de tokens y la adherencia al tema. El modelo uncensored responde bien a configuraciones de temperatura baja para la generación de código y a temperaturas altas para la escritura creativa.

Límites de velocidad y restricciones

La API impone límites estrictos para garantizar la estabilidad para todos los usuarios. Estás limitado a 300 solicitudes por minuto por clave. Las solicitudes concurrentes están limitadas a 8 simultáneamente. Cada cuerpo de solicitud no debe exceder 8 MB.

Si superas estos límites, el sistema devuelve un error 429 Too Many Requests. La facturación se basa en el uso real de tokens. Los errores y rechazos no consumen tu crédito prepagado. Puedes gestionar tu clave directamente desde el panel si necesitas rotar las credenciales debido a estas restricciones.

cURL

Copycurl https://api.aiabliterated.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 500 word technical document"}]
  }'