Heli + Chatbox: провайдер OpenAI API Compatible

Chatbox — клиент для работы с языковыми моделями на Windows, macOS, Linux и мобильных устройствах. Он хранит переписку локально, поддерживает вложения, изображения и разные провайдеры. Для сервисов со своим OpenAI-совместимым API в Chatbox есть пользовательский провайдер, и Heli подключается через него: один ключ sk-heli-…, модели разных вендоров и оплата в рублях.

Пошаговая настройка

Главная ловушка — адрес. Если указать API Host с /v1, Chatbox обратится к /v1/v1/chat/completions и получит 404, которую легко принять за проблему с ключом.

Число сообщений истории, которые уходят вместе с вопросом, и максимальную длину ответа можно настроить. Чем короче контекст, тем быстрее ответ и меньше расход, поэтому для новой темы лучше начинать новый диалог, а не продолжать старый.

  • Зарегистрируйтесь на getheli.ru (подтверждение почты или вход через Google / Яндекс ID) и создайте ключ на вкладке «Ключи» кабинета.
  • В Chatbox откройте настройки → Model Provider и нажмите Add внизу списка.
  • Укажите название, например Heli, и тип API: OpenAI API Compatible.
  • API Key: ключ sk-heli-…. API Host: https://getheli.ru — без /v1.
  • API Path оставьте пустым: по умолчанию Chatbox добавляет /v1/chat/completions сам.
  • Добавьте модели по точным слагам Heli и при желании отметьте их возможности, например vision или tool use. Сохраните и нажмите Check.

Итоговые настройки и проверка

code
Name:      Heli
API Mode:  OpenAI API Compatible
API Key:   sk-heli-ВАШ_КЛЮЧ
API Host:  https://getheli.ru
API Path:  (пусто → /v1/chat/completions)
Models:    anthropic/claude-sonnet-5
           deepseek/deepseek-v4-flash
           google/gemini-3.5-flash

# Тот же запрос из терминала
curl https://getheli.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-heli-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek/deepseek-v4-flash", "messages": [{"role": "user", "content": "ping"}]}'

Какие модели выбрать

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

Claude Sonnet 5 — документы, код, длинные ответы.

DeepSeek V4 Flash — черновики, перевод, повседневные вопросы.

Gemini 3.5 Flash — быстрые ответы и изображения.

Частые ошибки

  • 404 при проверке — в API Host добавлен /v1 или заполнен API Path; оставьте https://getheli.ru и пустой путь.
  • 401 — ключ скопирован с пробелом или отозван; создайте новый на вкладке «Ключи».
  • 402 insufficient_balance — закончился баланс; пополните его в кабинете.
  • Модель не найдена — проверьте слаг по GET /v1/models: нужен префикс вендора.
  • Долгое ожидание ответа — выберите более быструю модель или сократите вложения и историю диалога.

Документация API

Оплата — пополнение баланса.

Heli + LobeChat

Попробуйте Heli

Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.

Документация API · Модели и цены

Читайте также