Справочник API

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

Используйте выделенный базовый URL для всех запросов. Ваш API-ключ аутентифицируется через Authorization Заголовок.

• Базовый 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 сигнализирует о некорректном теле запроса.

Возвраты не выдаются за потребленные токены. Регулярно проверяйте баланс, чтобы избежать перебоев в обслуживании.