Довідник API

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

Використовуйте виділену базову URL-адресу для всіх запитів. Ваш API-ключ автентифікується через Authorization header.

• Базовий URL: https://api.hereticuncensored.com/v1
• Ідентифікатор моделі: uncensored

Отримайте свій ключ з панелі керування. Він дійсний миттєво після створення.

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

Перший запит

Надішліть простий запит на отримання відповіді чату, щоб перевірити з’єднання. Модель відповідає без стандартних фільтрів вмісту для законного дорослого використання.

• Встановити model до uncensored.
• Включіть ваш messages масив.

Перевірте відповідь на choices що містить згенерований текст.

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)

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

Ініціалізуйте клієнта, вказавши базовий URL та ключ. Це забезпечує сумісність зі стандартними бібліотеками OpenAI.

• Встановіть офіційний openai пакет.
• Пройти baseURL та apiKey під час ініціалізації.

Виклик chat.completions.create() з вашим промптом. Структура відповіді відображає стандартний формат 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);

Потокові відповіді

Увімкнути доставку токенів у реальному часі, встановивши stream до true. Це зменшує сприйняту затримку для довгих виводів.

• Слухати delta чankи.
• Поєднуйте фрагменти для відновлення повної відповіді.

Метадані про використання токенів з’являються в кінцевому чанку. Це ідеально підходить для чат-інтерфейсів, які вимагають миттєвого зворотного зв’язку.

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)

Ліміти частоти та контекст

API підтримує контекстне вікно на 100,000 токенів. Ви можете надсилати до 300 запитів на хвилину на ключ.

• Максимальна кількість одночасних запитів: 8
• Максимальна кількість токенів виводу: 16 000 (типово 2 048)

Перевищення лімітів викликає помилку 429. Керуйте конкурентністю, щоб підтримувати стабільну пропускну здатність для великообсягових робіт.

Обробка помилок та коди

Гарно обробляйте помилки, щоб підтримувати стабільність додатку. Поширені коди включають 401 для недійсних ключів та 402 для недостатності кредитів.

• 429 вказує на вичерпання ліміту швидкості.
• 400 сигналізує про некоректне тіло запиту.

Повернення коштів не випускаються для спожитих токенів. Регулярно перевіряйте свій баланс, щоб уникнути перерв у роботі послуги.