Heli
Создать аккаунт

Ошибка 402 insufficient balance в Heli: что делать

Heli работает по предоплате: запросы к моделям оплачиваются с рублёвого баланса аккаунта. Когда доступных средств не хватает, API отвечает 402 с кодом insufficient_balance. Это не сбой и не проблема ключа — ключ верный, нужно пополнить баланс. Ниже — как распознать ошибку в коде, почему она иногда приходит при ненулевом балансе и как не допускать остановки сервиса.

Как выглядит ответ

code
HTTP/1.1 402 Payment Required
{
  "error": {
    "message": "Insufficient balance. Пополните баланс в кабинете, чтобы продолжить.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_balance"
  }
}

# Обработка в Python
try:
    resp = client.chat.completions.create(model=MODEL, messages=messages)
except openai.APIStatusError as e:
    if e.status_code == 402 and e.code == "insufficient_balance":
        notify_admin("Heli: закончился баланс")  # ваша функция оповещения
        return FALLBACK_TEXT
    raise

Почему 402 при ненулевом балансе

Перед выполнением запроса Heli проверяет, хватит ли доступного баланса на оценку его стоимости. Оценка учитывает длину контекста и max_tokens, а если max_tokens не передан — берётся консервативный запас. Поэтому при почти нулевом балансе длинный запрос может получить 402, а короткий пройдёт. Списывается фактическая стоимость по токенам ответа.

Если в одном аккаунте одновременно идёт много запросов, доступная сумма уменьшается на время их выполнения. При небольшом остатке это тоже может давать 402 на пике нагрузки.

Что сделать

  • Проверьте остаток во вкладке «Баланс» кабинета getheli.ru.
  • Пополните баланс через «Пополнить»: банковская карта через Robokassa или счёт для юрлиц и ИП. Все платежи — в рублях.
  • После пополнения повторите запрос: ключи и настройки менять не нужно.
  • Посмотрите расход по ключам во вкладке «Ключи» и по моделям в разделе «Расходы»: резкий рост может означать утечку ключа или зациклившегося агента.
  • Не путайте 402 с 429 code budget: второе означает, что сработал ваш лимит расходов во вкладке «Лимиты», а баланс при этом может быть.

Какие модели продлят баланс

Самый простой способ тратить меньше — отдать массовые задачи лёгким моделям и задавать разумный max_tokens. Сильные модели оставьте для задач, где разница в качестве заметна.

DeepSeek V4 Flash — недорогая универсальная модель.

Gemini 3.5 Flash Lite — классификация и короткие ответы.

GPT-5.4 mini — structured output и tool calling.

Как не допустить остановки

  • Задайте бюджеты во вкладке «Лимиты»: письма приходят при 50, 80, 90 и 100% расхода.
  • Не повторяйте 402 автоматически: ретраи только увеличат нагрузку и не пройдут до пополнения.
  • Для сервиса с пользователями держите запасной ответ на случай 402 и оповещение администратору.

Оплата API в рублях

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

Кошелёк, пополнение и возврат

Как снизить расход на API

Попробуйте Heli

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

Создать аккаунтВойти

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

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