Inicio rápido e integración de API

URL Base y Autenticación

El Proyecto Heretic proporciona un único punto de conexión alojado para la generación de texto. Usa https://api.hereticproject.com/v1 como tu URL base. La autenticación se basa en un token portador pasado a través del Authorization header. Crea tu clave iniciando sesión con Google o correo electrónico en el panel de control. El sistema emite una clave activa por cuenta; generar una nueva clave invalida la anterior inmediatamente.

Pagas solo por los tokens consumidos. Los errores y las denegaciones no cargan tu crédito prepagado. Una nueva cuenta recibe $0.50 en crédito de prueba válido durante siete días. Recargas usando USDT (TRC20) o USDC (Base) en cantidades entre $20 y $500.

El Endpoint /v1/chat/completions

Envía mensajes al endpoint estándar de finalización de chat. El ID del modelo es uncensored. Acepta una lista de objetos de mensaje con roles como system, user, o assistant. El modelo no rechaza temas adultos lícitos, ficticios o controversiales. Es un modelo de peso abierto ajustado para respuestas directas.

Las solicitudes devuelven un objeto JSON que contiene el texto generado. La ventana de contexto admite 100,000 tokens combinados para prompt y completación. La salida está limitada a 16,000 tokens por solicitud a menos que especifiques un valor inferior max_tokens valor.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Integración del SDK de Python

Utiliza la biblioteca oficial de Python de OpenAI con una URL base personalizada. Establece api_key tu cadena de API. Configura base_url para apuntar al servidor del Proyecto Heretic. Esto te permite usar métodos familiares como chat.completions.create() sin modificar significativamente la estructura de tu código existente.

Instala la biblioteca mediante pip. Pasa tus credenciales directamente a la inicialización del cliente. La biblioteca maneja la serialización automáticamente. Este enfoque funciona tanto para flujos de trabajo sincrónicos como asíncronos. Asegúrate de manejar posibles errores de red de manera elegante.

Copyfrom openai import OpenAI

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

El SDK de Node.js funciona de manera idéntica a la versión de Python. Inicializa el cliente con tu clave API y la URL base correcta. Puedes enviar solicitudes de completado utilizando las mismas firmas de método. Esto garantiza la coherencia en diferentes partes de tu stack.

Maneja las respuestas de forma asíncrona. El SDK transmite datos si usas el método de transmisión. De lo contrario, devuelve la respuesta JSON completa. Esta flexibilidad admite tanto el procesamiento por lotes como las interfaces en tiempo real. Mantén tu clave de API segura en las variables de entorno.

Copyimport OpenAI from "openai";

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

Habilita la transmisión estableciendo stream: true en tu solicitud. El servidor envía Server-Sent Events (SSE). Cada fragmento contiene actualizaciones de texto parcial. Esto reduce la latencia percibida para los usuarios finales. Los datos de uso de tokens aparecen en el último fragmento del flujo.

Procesa cada objeto delta para acumular la respuesta completa. Deja de escuchar cuando el flujo se cierra o se produce un error. Este método es ideal para interfaces de chat. Permite a los usuarios ver cómo se forman los pensamientos en tiempo real. La sobrecarga es mínima en comparación con las respuestas completas.

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, Errores y Contexto

Respeta los límites de velocidad para evitar interrupciones en el servicio. Tienes permitido realizar 300 solicitudes por minuto por clave. La concurrencia se limita a 8 solicitudes simultáneas. El cuerpo de la solicitud no puede exceder los 8 MB. Exceder estos límites devuelve un código de estado 429. Espera brevemente antes de reintentar.

Los fallos de autenticación devuelven un error 401. Esto ocurre si la clave no es válida o está expirada. Un error 402 indica crédito prepagado insuficiente. Los errores de reembolso se manejan a través de la página de Soporte. El crédito nunca expira. El modelo niega contenido que involucra a menores. Se acepta todo el contenido legal restante.