Швидкий старт API та інтеграція

Базова URL-адреса та аутентифікація

Проект Heretic надає одну хостовану кінцеву точку для генерації тексту. Використовуйте https://api.hereticproject.com/v1 як вашу базову URL-адресу. Аутентифікація базується на bearer-токені, який передається через Authorization header. Створіть свій ключ, увійшовши через Google або електронну пошту на панелі керування. Система видає один активний ключ на обліковий запис; генерація нового ключа негайно робить попередній недійсним.

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

Ендпоінт /v1/chat/completions

Надсилайте повідомлення на стандартний ендпоінт завершення чату. Ідентифікатор моделі — 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"}]
  }'

Інтеграція SDK Python

Використовуйте офіційну Python-бібліотеку OpenAI з власним базовим URL. Встановіть api_key вашого API рядка. Налаштуйте base_url щоб вказати на сервер Heretic Project. Це дозволяє вам використовувати знайомі методи, такі як 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 у вашому запиті. Сервер надсилає події, що генеруються сервером (SSE). Кожен чанк містить оновлення часткового тексту. Це знижує сприйняту затримку для кінцевих користувачів. Дані про використання токенів з'являються в останньому чанку потоку.

Обробляйте кожен об'єкт дельти, щоб накопичити повну відповідь. Припиніть прослуховування, коли потік закриється або виникне помилка. Цей метод ідеально підходить для чат-інтерфейсів. Він дозволяє користувачам бачити формування думок у реальному часі. Навантаження є мінімальним порівняно з повними відповідями.

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 вказує на недостатність попередньо оплаченого кредиту. Помилки при поверненні коштів обробляються через сторінку Підтримки. Кредит ніколи не прострочується. Модель відхиляє контент, що стосується неповнолітніх. Усі інші законні контент приймаються.