> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Аккаунт и оплата — недостаточно средств в BeatAPI

> Как исправить insufficient funds и 402 insufficient_credits, проверить баланс USD, лимит ключа, возвраты и расходы в BeatAPI.

# Аккаунт и оплата

## Insufficient funds: что делать?

Если клиент показывает «insufficient funds» или «недостаточно средств», проверьте код ошибки в ответе API. `402 insufficient_credits` означает, что баланс аккаунта равен нулю или меньше стоимости запроса. В этом случае ограничены платные запросы со всего аккаунта, а не с отдельного ключа.

1. Откройте [панель управления](https://beatapi.io/dashboard) и проверьте баланс в USD.
2. Пополните баланс и дождитесь подтверждения платежа. После зачисления средств ничего дополнительно включать не нужно.
3. Повторите нужный запрос. Пока на балансе недостаточно средств, повторные попытки будут возвращать `402`.

Уже принятые задачи продолжают выполняться. Данные не удаляются, ключи не отзываются. Если баланс положительный, но меньше цены запроса, ответ всё равно будет `402`.

`401 invalid_api_key` с сообщением об исчерпанном лимите ключа — другая ситуация. Проверьте ключ в [разделе API Keys](https://beatapi.io/dashboard/apikeys). Другие ключи аккаунта могут продолжать работать. Ключи, созданные в панели управления, не имеют собственного лимита расходов.

`403 forbidden` не означает, что на балансе недостаточно средств: выбранная модель может быть недоступна при оплате регистрационным бонусом. Прочитайте сообщение об ошибке и условия доступа к модели. Пополнение баланса открывает доступ к моделям, которые нельзя использовать за счёт бонуса.

## Как устроена оплата?

У аккаунта один баланс в USD. Подписки и обязательного ежемесячного платежа нет: вы пополняете баланс и оплачиваете использование.

* Текстовые запросы оплачиваются по числу токенов: отдельно учитываются входные, кэшированные входные и выходные токены.
* Для генерации изображений, видео, эффектов и запуска рабочих процессов средства резервируются при отправке задачи. Окончательное списание происходит после её завершения.
* Поля API с названием `credits` сохраняются для совместимости: 1 Credit = \$1 USD. Валюта платежа и валюта баланса — разные вещи.

## Где посмотреть расходы?

В [панели управления](https://beatapi.io/dashboard) показаны вызовы, токены, стоимость и разбивка по ключам. Программно те же данные доступны через `GET /v1/usage`, включая `by_model`, `by_capability` и `by_api_key`.

## Что происходит при ошибке задачи?

Зарезервированная сумма возвращается. Сведения о возврате доступны в ответе `GET /v1/tasks/{task_id}`, а общая сумма возвратов — в поле `credits_refunded` ответа `GET /v1/usage`, рядом с `credits_settled`. Если ваша система учёта фиксирует резервирование средств, учитывайте и возвраты, иначе расходы будут завышены.

## Почему баланс отрицательный?

`credit_balance` может быть меньше нуля. Стоимость длительной задачи окончательно рассчитывается при её завершении. Уже принятая задача продолжает выполняться и оплачивается, даже если за это время баланс достиг нуля. Пополните баланс, чтобы покрыть задолженность и продолжить работу.

Если ваше приложение обслуживает пользователей, настройте уведомление о `402`, не дожидаясь жалоб.

## От чего зависит лимит запросов?

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

Текущий лимит и следующий уровень видны в панели управления и в `GET /api/user/self`, поле `rate_limit`:

```jsonc
"rate_limit": {
  "enabled": true,
  "window_minutes": 1,
  "success_count": 20,
  "next_tier": { "min_topup_quota": 50000000, "success_count": 30 }
}
```

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

У бесплатных моделей категории Free, например `jev-1.14-free`, отдельный лимит на аккаунт: 1 успешный запрос в минуту до первого пополнения и до 10 после пополнения на любую сумму. Эти вызовы не расходуют лимит платных запросов. Превышение возвращает `429` с `Retry-After`.

## Сгорает ли баланс?

Нет. Средства остаются на балансе до использования.

## Почему одинаковый промпт стоит по-разному?

1. Длина ответа меняется. Выходные токены обычно дороже входных; ограничивайте длину, если это нужно приложению.
2. Кэшированный вход дешевле нового. Повторный длинный системный промпт может попасть в кэш.
3. У некоторых моделей цена зависит от времени. DeepSeek HC удваивает тарифы по будням с 09:00 до 12:00 и с 14:00 до 18:00 по Пекину; обычные платные модели DeepSeek используют единый тариф. У Hunyuan `hy3` своё ежедневное пиковое окно. Точные часы указаны в примечаниях к [ценам](https://beatapi.io/ru/pricing).
4. У некоторых семейств, включая GPT-5.6 и Grok, тариф повышается, когда длина контекста превышает определённый порог. Во время длительной сессии агента это может произойти незаметно.

Применённый тариф указан в данных об использовании для соответствующего ответа.

## Как разделить расходы приложений?

Создайте отдельный API-ключ для каждого приложения. В поле `by_api_key` ответа `GET /v1/usage` задачи и расходы будут сгруппированы по ключам.

## Как пополнить баланс или оспорить списание?

Пополните баланс в [панели управления](https://beatapi.io/dashboard). Он обновляется после подтверждения платежа. По вопросу списания создайте обращение там же и укажите `request_id` запроса или ID задачи. Не отправляйте секретный API-ключ.

Если возникли проблемы с подключением, откройте [руководство по подключению](/ru/faq/connection-usage).