Referencia de API

URL Base y Autenticación

Utiliza la URL base dedicada para todas las solicitudes. Tu clave API autentica mediante la Authorization header.

• URL base: https://api.hereticuncensored.com/v1
• ID del Modelo: uncensored

Recupera tu clave del panel. Es válida inmediatamente después de su creación.

Copycurl https://api.hereticuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five features of the new release."}]
  }'

Primera solicitud

Envía una finalización de chat simple para verificar la conectividad. El modelo responde sin los filtros de contenido estándar para uso adulto lícito.

• Establecer model para uncensored.
• Incluye tu messages array.

Comprueba la respuesta para choices conteniendo tu texto generado.

Copyfrom openai import OpenAI

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

Integración del SDK Node

Inicializa el cliente con la URL base y la clave. Esto garantiza la compatibilidad con las bibliotecas estándar de OpenAI.

• Instala el openai paquete.
• Pasar baseURL y apiKey durante la inicialización.

Llamar chat.completions.create() con tu prompt. La estructura de la respuesta refleja el formato estándar de la API.

Copyimport OpenAI from "openai";

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

Habilitar entrega de tokens en tiempo real estableciendo stream para true. Esto reduce la latencia percibida para salidas largas.

• Escucha delta fragmentos.
• Combina los fragmentos para reconstruir la respuesta completa.

Los metadatos de uso de tokens aparecen en el fragmento final. Esto es ideal para interfaces de chat que requieren retroalimentación instantánea.

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)

Límites de velocidad y contexto

La API admite una ventana de contexto de 100.000 tokens. Puedes enviar hasta 300 solicitudes por minuto por clave.

• Solicitudes concurrentes máximas: 8
• Tokens máximos de salida: 16.000 (predeterminado 2.048)

Superar los límites activa un error 429. Gestiona la concurrencia para mantener un rendimiento constante para cargas de trabajo de alto volumen.

Gestión de errores y códigos

Gestiona los errores de forma elegante para mantener la estabilidad de la aplicación. Los códigos comunes incluyen 401 para claves no válidas y 402 para crédito insuficiente.

• 429 indica agotamiento del límite de velocidad.
• 400 indica cuerpos de solicitud mal formados.

Los reembolsos no se emiten para los tokens consumidos. Revisa tu saldo regularmente para evitar interrupciones en el servicio.