Документація Hermes API: Швидкий старт

Встановлення та налаштування

API hermes працює з будь-яким клієнтом, який підтримує формат OpenAI. Вам потрібен базовий URL та API-ключ. Створіть обліковий запис через Google або електронну пошту на сторінці Get API key. Система миттєво покаже ваш ключ. Номер телефону не потрібен. Ви отримуєте пробний кредит $0.50 на сім днів. Поповніть баланс пізніше лише криптовалютою.

• Базова URL-адреса: HTTPS://api.apihermes.cc/v1
• Заголовок Auth: Authorization: Bearer YOUR_API_KEY
• Ідентифікатор моделі: uncensored

Встановіть бажаний SDK та встановіть базову URL-адресу. Кінцева точка очікує стандартні параметри chat completion. Зберігайте ваш ключ у безпеці. Один ключ замінює попередній, якщо ви згенеруєте новий.

Запит на базове завершення чату

Базовий запит надсилає повідомлення та отримує текстову відповідь. ID моделі — uncensored. Він обробляє законний дорослий контент без відмов. Ви платите за кожен використаний токен. Помилки та відмови коштують нічого. Контекстне вікно вміщує всього 100 000 токенів.

Структуруйте запит із повідомленням system та повідомленням user. API повертає завершення. Ви можете встановити max_tokens для контролю довжини виводу. Ліміт виводу за замовчуванням становить 2,048 токенів. Ви можете збільшити його до 16,000 токенів на запит. Потокова передача працює через SSE. Доступний виклик функцій. Підтримується режим JSON.

Copycurl https://api.apihermes.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a GET request for the user endpoint"}]
  }'

Тіло запиту обмежене до 8 МБ. Ліміти швидкості становлять 300 запитів на хвилину. Паралелізм — вісім запитів одночасно. Логіка повторних спроб коректно обробляє перевантаження сервера.

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

Потокова передача надає токени по мірі їх генерації. Сервер надсилає події Server-Sent Events. Кожен чанк містить частковий текст. Останній чанк включає статистику використання токенів. Цей підхід зменшує сприйняту затримку для довгих відповідей. Він ідеально підходить для інтерфейсів чату. Ви повинні правильно обробляти потік. Можливі розриви з’єднань. API не гарантує порядок доставки окрім самого потоку.

Встановіть параметр stream у true. Парсіть рядки даних. Об'єднайте вміст. Перевірте finish_reason для визначення завершення. Модель uncensored працює з будь-яким SDK, сумісним з OpenAI. Налаштуйте клієнт для обробки SSE. Відстежуйте кількість токенів. Базовий URL залишається незмінним. Аутентифікація ідентична. Додаткова настройка не потрібна.

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)

Помилки з’являються в потоці. Обробляйте їх, закриваючи з’єднання. Передоплачений кредит списується лише за завершені токени. Це економить гроші під час переривань. Ви ніколи не платите за частковий сміттєвий вивід. Система є прозорою.

Використання Function Calling та Tools

Виклик функцій дозволяє моделі виконувати код або інструменти. Визначте інструменти в тілі запиту. Модель повертає виклик інструмента. Ви виконуєте інструмент. Ви надсилаєте результат назад. Модель генерує остаточну відповідь. Це дозволяє складні робочі процеси. Це не просто обгортка для чату. API підтримує інструменти та tool_choice. Використовуйте це для агентів або автоматизації.

Структуруйте масив інструментів. Включіть назву, опис та параметри. Модель вирішує, коли викликати інструмент. Ви повинні проаналізувати аргументи. Виконайте функцію. Передайте результат у розмову. Модель продовжує. Цей цикл повторюється до отримання остаточної відповіді. Вікно контексту відстежує всі взаємодії з інструментами. Відстежуйте використання токенів. Витрати зростають з виводом інструментів. Слідкуйте за використанням у фінальному фрагменті.

Copyfrom openai import OpenAI

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

Нецензурована модель обробляє різноманітні схеми інструментів. Вона не відмовляє на основі контенту. Використовуйте це для рольових ігор або технічних завдань. API є надійним. Помилки відсутні. Передоплатна система забезпечує справедливість. Ви контролюєте потік. Базовий URL є стабільним. Аутентифікація проста.

Режим JSON та параметри

Режим JSON змушує модель виводити дійсний JSON. Встановіть response_format на json_object. Це корисно для структурованих даних. Модель уникає обгорток markdown. Вона повертає сирій JSON. Використовуйте це для парсингу. Це покращує надійність. Вікно контексту все ще застосовується. Ви платите за токени. Uncensored модель поважає формат. Вона не відмовляє на основі контенту.

Parameters include temperature, top_p, stop, seed, presence_penalty, and frequency_penalty. Temperature controls randomness. Top_p controls diversity. Stop sequences halt generation. Seed ensures reproducibility. Presence and frequency penalties adjust token usage. Set these to refine the output. The API supports all standard parameters. Use them to tune the response. The base URL remains the same. Auth is identical.

Copyimport OpenAI from "openai";

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

Помилки обробляються через коди стану HTTP. 401 означає недійсний ключ. 402 означає недостатньо коштів. 429 означає перевищення ліміту швидкості. Обробляйте їх у своєму коді. Попередньо оплачений кредит списується лише за успішно згенеровані токени. Це забезпечує справедливість. Ви ніколи не платите за частковий вивід. Система прозора. uncensored модель надійна. Використовуйте її для будь-яких законних завдань.

Обробка помилок та ліміти частоти запитів

API повертає стандартні коди стану HTTP. 401 вказує на недійсний API-ключ. 402 вказує на недостатній попередньо оплачений кредит. 429 вказує на ліміт швидкості. Ліміт становить 300 запитів на хвилину. Паралельність обмежена вісьмома запитами одночасно. Тіла запитів обмежені 8 МБ. Обробляйте ці помилки коректно. Повторюйте спроби з експоненційним сповільненням. uncensored модель не відхиляє законний контент. Помилки безкоштовні. Ви не платите за невдалі запити. Попередньо оплачений кредит є захищеним. Він ніколи не прострочується. Використовуйте сторінку Підтримка для подвійних списань. Тільки криптовалюта. USDT або USDC. Бонуси застосовуються.