Документация Hermes API: Быстрый старт

Установка и настройка

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

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

Установите предпочитаемый SDK и установите базовый URL. Конечная точка ожидает стандартные параметры чат-завершения. Храните ваш ключ в безопасности. Один ключ заменяет предыдущий, если вы сгенерируете новый.

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

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

Структурируйте запрос с системным сообщением и сообщением user. API возвращает completion. Вы можете установить 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 запросов в минуту. Параллельность — восемь запросов одновременно. Логика повторных попыток (retry logic) корректно обрабатывает перегрузку сервера.

Потоковые ответы с 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-модель уважает формат. Она не отказывает на основе контента.

Параметры включают temperature, top_p, stop, seed, presence_penalty и frequency_penalty. Температура контролирует случайность. Top_p контролирует разнообразие. Последовательности остановки останавливают генерацию. Seed обеспечивает воспроизводимость. Штрафы за присутствие и частоту регулируют использование токенов. Установите их для улучшения вывода. API поддерживает все стандартные параметры. Используйте их для настройки ответа. Базовый URL остается прежним. Аутентификация идентична.

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. Применяются бонусы.