Быстрый старт API и интеграция

Базовый URL и аутентификация

Проект Heretic предоставляет единую хостинговую конечную точку для генерации текста. Используйте https://api.hereticproject.com/v1 в качестве базового URL. Аутентификация основана на токене доступа (bearer token), передаваемом через Authorization Заголовок. Создайте ключ, войдя в систему через Google или email в панели управления. Система выдает один активный ключ на аккаунт; генерация нового ключа немедленно делает предыдущий недействительным.

Вы платите только за потребленные токены. Ошибки и отказы не списывают средства с вашего предоплаченного баланса. На новый аккаунт начисляется пробный кредит в размере $0.50, действительный в течение семи дней. Пополнение осуществляется с помощью USDT (TRC20) или USDC (Base) в суммах от $20 до $500.

Эндпоинт /v1/chat/completions

Отправляйте сообщения в стандартный эндпоинт завершения чата. model ID — uncensored. Он принимает список объектов сообщений с ролями, такими как system, user, или assistant. Модель не отказывает в законном взрослом, художественном или спорном контенте. Это модель с открытым весом, настроенная на прямые ответы.

Запросы возвращают объект JSON, содержащий сгенерированный текст. Окно контекста поддерживает 100,000 токенов в сумме для промпта и дополнения. Вывод ограничен 16,000 токенов на запрос, если вы не укажете меньшее max_tokens значение.

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"}]
  }'

Интеграция Python SDK

Используйте официальную библиотеку OpenAI для Python с пользовательским базовым URL. Установите api_key вашей строки API. Настройте base_url чтобы указать на сервер проекта Heretic. Это позволяет вам использовать знакомые методы, такие как chat.completions.create() без существенного изменения структуры вашего существующего кода.

Установите библиотеку через pip. Передайте учетные данные напрямую при инициализации клиента. Библиотека автоматически выполняет сериализацию. Этот подход работает как для синхронных, так и для асинхронных рабочих процессов. Убедитесь, что вы корректно обрабатываете возможные сетевые ошибки.

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)

Интеграция Node SDK

SDK для Node.js работает идентично версии для Python. Инициализируйте клиент, указав API-ключ и правильный базовый URL. Вы можете отправлять запросы completion, используя те же сигнатуры методов. Это обеспечивает согласованность в разных частях вашего стека.

Обрабатывайте ответы асинхронно. SDK потоково передает данные, если вы используете метод потоковой передачи. В противном случае он возвращает полный JSON-ответ. Эта гибкость поддерживает как пакетную обработку, так и интерфейсы реального времени. Храните свой API-ключ в безопасности в переменных окружения.

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);

Потоковые ответы (SSE)

Включите потоковую передачу, установив stream: true в вашем запросе. Сервер отправляет Server-Sent Events (SSE). Каждый чанк содержит частичные обновления текста. Это снижает воспринимаемую задержку для конечных пользователей. Данные об использовании токенов появляются в последнем чанке потока.

Обрабатывайте каждый объект delta для накопления полного ответа. Прекратите прослушивание, когда поток завершится или возникнет ошибка. Этот метод идеален для интерфейсов чата. Он позволяет пользователям видеть ход мыслей в реальном времени. Дополнительные накладные расходы минимальны по сравнению с полными ответами.

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)

Лимиты, Ошибки и Контекст

Соблюдайте лимиты частоты запросов, чтобы избежать сбоев в работе сервиса. Вам разрешено 300 запросов в минуту на ключ. Одновременных запросов не более 8. Размер тела запроса не может превышать 8 МБ. Превышение этих лимитов возвращает код статуса 429. Подождите немного перед повторной попыткой.

Сбои аутентификации возвращают ошибку 401. Это происходит, если ключ недействителен или истек. Ошибка 402 указывает на недостаточный предоплаченный кредит. Ошибки возврата средств обрабатываются через страницу поддержки. Кредит никогда не истекает. Модель отказывает в контенте, связанном с несовершеннолетними. Весь другой законный контент принимается.