Documentación de la API: Guía de inicio rápido

URL Base y Autenticación

La API de Heretic AI es totalmente compatible con OpenAI. Interactúas con ella apuntando tu cliente a nuestra URL base: https://api.hereticai.cc/v1. La autenticación depende de una única clave API por cuenta, generada instantáneamente al registrarse con Google o correo electrónico. Pasa esta clave en el Authorization cabecera como un token Bearer. El identificador del modelo es simplemente uncensored. Este único modelo maneja todas tus solicitudes sin complejidad de enrutamiento. Errores como 401 indican una clave no válida, mientras que 402 significa que necesitas más crédito cripto prepagado.

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

Endpoint Chat Completions

Envía solicitudes de texto utilizando el POST /v1/chat/completions endpoint. La API espera un array estándar de mensajes que contenga el historial de tu conversación o el prompt. Devuelve texto generado en el choices array. Esta es una API de utilidad pura: texto de entrada, texto de salida. Pagas solo por los tokens consumidos. El crédito prepagado nunca expira, y las negaciones o errores no cuestan tokens. Este enfoque elimina los bloqueos de suscripción y las capas gratuitas impredecibles.

Copyfrom openai import OpenAI

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

Habilita la transmisión de tokens en tiempo real estableciendo stream: true en tu solicitud. La API devuelve Eventos Enviados por Servidor (SSE) para cada token generado. Esto te permite mostrar la salida de forma progresiva, lo cual es crucial para aplicaciones sensibles a la latencia. Las estadísticas de uso de tokens aparecen en el último fragmento del flujo. Esta función funciona sin problemas con los SDK estándar de OpenAI que manejan SSE automáticamente. Proporciona retroalimentación inmediata sin esperar a la finalización completa.

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 Herramientas

La API admite llamadas a funciones con el tools y tool_choice parámetros. Define los esquemas de tus herramientas en la solicitud, y el modelo devolverá llamadas a funciones estructuradas cuando sea apropiado. Esto habilita flujos de trabajo complejos donde el LLM decide qué acción tomar a continuación. Puedes forzar un uso específico de herramientas o dejar que el modelo elija libremente. Esta capacidad es esencial para construir aplicaciones agenticas que interactúen con sistemas externos o bases de datos.

Modo JSON

Asegura salida determinista estableciendo response_format para {"type": "json_object"}. El modelo restringirá su respuesta a JSON válido, lo cual es vital para el análisis programático. Esto reduce la necesidad de correcciones con expresiones regulares post-procesamiento. Garantiza que la salida pueda ser consumida directamente por tu código. Esto es particularmente útil para la extracción de datos estructurados o la generación de configuraciones.

Parámetros y límites

Controla la generación con parámetros estándar como temperature, top_p, y seed. La ventana de contexto es de 100,000 tokens para prompt más finalización. La salida máxima es de 16,000 tokens por solicitud, o 2,048 si max_tokens no está establecido. Los límites de tasa son de 300 solicitudes por minuto y 8 solicitudes concurrentes por clave. El cuerpo de la solicitud debe mantenerse por debajo de 8 MB. Estos límites garantizan un uso estable de alto volumen para desarrolladores.

Node.js

Copyimport OpenAI from "openai";

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