> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Запрос завершается ошибкой при положительном балансе: причины

> Исправьте insufficient_user_quota и другие сбои при видимом балансе: проверьте предварительное резервирование суммы, квоту токена, группу, цены и размер входа.

Видимый баланс не гарантирует, что запрос пройдёт проверки предварительного резервирования суммы, квоты токена, группы и прав. Чаще всего виноват большой вход, оценочная стоимость которого превышает баланс; на втором месте — токен, исчерпавший собственную квоту.

Последняя проверка — **5 октября 2026**; цены и правила квот сверяйте с консолью.

## Самая частая причина: резервируемая сумма больше баланса

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

* Если баланса хватает на зарезервированную сумму, запрос проходит.
* Если не хватает, запрос отклоняется до выполнения с ошибкой `insufficient_user_quota`. Модель не вызывается, плата не списывается.

Тело ошибки выглядит так:

```text theme={null}
user [12345] quota [50000000] preConsumedQuota [150000000] is not enough
```

* `quota` — доступный сейчас баланс.
* `preConsumedQuota` — сумма, которую этому запросу нужно зарезервировать.
* Оба значения указаны во внутренних единицах квоты, где 500 000 — примерно \$1. Здесь баланс около \$100, а резерв около \$300, поэтому запрос отклонён.

Резерв — оценка худшего случая, а не итоговое списание. Чтобы это исправить:

1. Сократите вход до кода, документов или истории чата, которые действительно нужны для задачи.
2. Задайте явный предел вывода, чтобы уменьшить ожидаемый вывод. См. материал [Что такое max\_tokens](https://docs.laozhang.ai/en/faq/max-tokens.md).
3. Если большой вход действительно нужен, пополните баланс так, чтобы он превысил резерв. См. [способы оплаты](https://docs.laozhang.ai/en/faq/payment-methods.md).

> [!NOTE]
>
> **У токенов тоже есть собственная квота.**
>
> * Если при создании токена вы отключили безлимитную квоту, запросы с этим токеном отклоняются, когда квота закончилась, даже если на аккаунте есть деньги.
> * Откройте токен в разделе [Токены](https://api.laozhang.ai/token) и увеличьте его квоту; новый ключ не нужен.

## Порядок диагностики

### 1. Запишите фактическую ошибку

Не ставьте диагноз по общему сообщению клиента «недостаточно баланса». Если в теле ошибки есть `insufficient_user_quota`, начните с раздела выше. Зафиксируйте:

* время запроса и часовой пояс;
* ID модели и эндпоинт;
* группу API-ключа;
* HTTP-статус и ошибку платформы;
* был ли у запроса расход или списание.

### 2. Проверьте актуальную цену и единицу тарификации

Откройте [страницу цен в консоли](https://api.laozhang.ai/account/pricing) и убедитесь, как тарифицируется нужная модель: по токенам, за запрос, за изображение, по длительности видео или иначе. Не оценивайте списание по цене апстрим-провайдера или устаревшей статической таблице в документации.

### 3. Уменьшите размер входа

Длинный контекст, множество изображений, большие файлы, PDF, видео или высокий лимит вывода увеличивают оценку расхода. Повторите запрос с минимальным входом:

* оставьте одно короткое сообщение;
* временно уберите изображения, файлы и вызовы инструментов;
* задайте явный, меньший лимит вывода;
* не меняйте остальные переменные, чтобы результат был показательным.

### 4. Проверьте группу, права и эндпоинт

Одно и то же имя модели может идти разными маршрутами в зависимости от группы API-ключа, типа оплаты или эндпоинта. Убедитесь, что:

* ключ разрешает нужную модель и режим оплаты;
* эндпоинт соответствует актуальной документации;
* ID модели указан точно;
* аккаунту не нужна корректировка прав со стороны владельца сайта или поддержки.

### 5. Отделите ошибки платформы от ошибок апстрима

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

## Что отправить в поддержку

* email или имя пользователя аккаунта;
* время запроса и часовой пояс;
* ID модели, эндпоинт и группу API-ключа;
* ошибку с закрытыми секретами и идентификатор запроса;
* скриншоты баланса и страницы цен в консоли;
* результат минимального воспроизведения.

Не присылайте полные API-ключи, промпты и ответы целиком и данные посторонних клиентов. По вопросам возвратов и корректировок баланса см. [способы оплаты и возвраты](https://docs.laozhang.ai/en/faq/payment-methods.md).

## Связанные материалы

* [Журнал вызовов](https://docs.laozhang.ai/en/faq/call-logs.md)
* [Доступность моделей и права доступа](https://docs.laozhang.ai/en/faq/model-availability.md)
* [Способы оплаты и возвраты](https://docs.laozhang.ai/en/faq/payment-methods.md)
* [API баланса](https://docs.laozhang.ai/ru/api-capabilities/balance-query.md)
* [Что такое max\_tokens](https://docs.laozhang.ai/en/faq/max-tokens.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.