Documentación de la API
Comienza con la API de LLM sin censura enviando tu primera solicitud a nuestro punto de conexión compatible con OpenAI. Esta guía cubre los aspectos esenciales para la integración.
URL Base y Autenticación
La URL base para todas las solicitudes es HTTPS://api.aiobliterated.com/v1. Necesitas una clave API para la autenticación. Genérala registrándote con Google o con un correo electrónico y contraseña en la página Obtener clave API. Pasa la clave en el encabezado Authorization como un token Bearer. Cada solicitud requiere este encabezado para identificar tu cuenta y rastrear el uso.
curl https://api.aiobliterated.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "fetch all user tokens from database"}]
}'
Tu Primera Solicitud
Envía una solicitud POST a /v1/chat/completions para generar texto. Establece el modelo en "uncensored" e incluye tu prompt del sistema. La API devuelve la respuesta del modelo en el campo content. Este es el formato estándar utilizado por la mayoría de los clientes de LLM.
from openai import OpenAI
client = OpenAI(base_url="https://api.aiobliterated.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)
Usando el SDK de Node
Instala el SDK oficial de OpenAI para Node.js. Configúralo con tu clave de API y la URL base. Llama al método chat.completions.create con tus mensajes. La biblioteca maneja la serialización y el streaming automáticamente.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aiobliterated.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);
Respuestas en streaming
Activa la transmisión estableciendo stream en true en tu solicitud. La API devuelve un flujo de Eventos Enviados por Servidor. Cada evento contiene un fragmento parcial de la respuesta. Esto te permite mostrar el texto a medida que se genera, mejorando la experiencia del usuario.
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)
Ventana de Contexto y Límites
El modelo admite una ventana de contexto de 100.000 tokens. Esto incluye tanto el prompt como la completion. Puedes establecer un máximo de 16.000 tokens por solicitud. Si no especificas max_tokens, el límite es de 2.048 tokens. Esto garantiza costos y rendimiento predecibles.
Gestión de errores y límites
Monitoriza los códigos de estado HTTP para errores. Una respuesta 401 significa que tu clave API es inválida. Una respuesta 402 indica crédito insuficiente. Una respuesta 429 señala que has excedido el límite de velocidad de 300 solicitudes por minuto. Maneja estos errores elegantemente en tu aplicación para mantener la fiabilidad.
Preguntas frecuentes
¿La API de IA obliterated es compatible con los SDK de OpenAI?
Sí, es una API compatible con OpenAI. Puedes usar los SDK oficiales de OpenAI cambiando el base_url y proporcionando tu clave API. Sigue el formato estándar de chat-completions.
¿Cómo manejo límites de tasa?
Estás limitado a 300 solicitudes por minuto y 8 solicitudes concurrentes por clave. Si superas este límite, la API devuelve un código de estado 429. Implementa retroceso exponencial para gestionar estos errores automáticamente.
¿Cuál es el tamaño de la ventana de contexto?
La ventana de contexto es de 100.000 tokens, incluyendo tanto la entrada como la salida. Esto permite conversaciones largas o el procesamiento de documentos grandes. Puedes controlar la longitud de la salida con el parámetro max_tokens.
Asegura tu clave API
Regístrate, copia la credencial y actualiza el endpoint. Configuración completa.