Самая частая причина: резервируемая сумма больше баланса
Перед выполнением каждого запроса LaoZhang API оценивает его максимально возможную стоимость по цене модели, размеру входа и ожидаемому выводу и резервирует эту сумму на вашем балансе. По завершении запроса списывается сумма по фактическому расходу, а неиспользованная часть освобождается.- Если баланса хватает на зарезервированную сумму, запрос проходит.
- Если не хватает, запрос отклоняется до выполнения с ошибкой
insufficient_user_quota. Модель не вызывается, плата не списывается.
quota— доступный сейчас баланс.preConsumedQuota— сумма, которую этому запросу нужно зарезервировать.- Оба значения указаны во внутренних единицах квоты, где 500 000 — примерно $1. Здесь баланс около $100, а резерв около $300, поэтому запрос отклонён.
- Сократите вход до кода, документов или истории чата, которые действительно нужны для задачи.
- Задайте явный предел вывода, чтобы уменьшить ожидаемый вывод. См. материал Что такое max_tokens.
- Если большой вход действительно нужен, пополните баланс так, чтобы он превысил резерв. См. способы оплаты.
У токенов тоже есть собственная квота.
- Если при создании токена вы отключили безлимитную квоту, запросы с этим токеном отклоняются, когда квота закончилась, даже если на аккаунте есть деньги.
- Откройте токен в разделе Токены и увеличьте его квоту; новый ключ не нужен.
Порядок диагностики
1. Запишите фактическую ошибку
Не ставьте диагноз по общему сообщению клиента «недостаточно баланса». Если в теле ошибки естьinsufficient_user_quota, начните с раздела выше. Зафиксируйте:
- время запроса и часовой пояс;
- ID модели и эндпоинт;
- группу API-ключа;
- HTTP-статус и ошибку платформы;
- был ли у запроса расход или списание.
2. Проверьте актуальную цену и единицу тарификации
Откройте страницу цен в консоли и убедитесь, как тарифицируется нужная модель: по токенам, за запрос, за изображение, по длительности видео или иначе. Не оценивайте списание по цене апстрим-провайдера или устаревшей статической таблице в документации.3. Уменьшите размер входа
Длинный контекст, множество изображений, большие файлы, PDF, видео или высокий лимит вывода увеличивают оценку расхода. Повторите запрос с минимальным входом:- оставьте одно короткое сообщение;
- временно уберите изображения, файлы и вызовы инструментов;
- задайте явный, меньший лимит вывода;
- не меняйте остальные переменные, чтобы результат был показательным.
4. Проверьте группу, права и эндпоинт
Одно и то же имя модели может идти разными маршрутами в зависимости от группы API-ключа, типа оплаты или эндпоинта. Убедитесь, что:- ключ разрешает нужную модель и режим оплаты;
- эндпоинт соответствует актуальной документации;
- ID модели указан точно;
- аккаунту не нужна корректировка прав со стороны владельца сайта или поддержки.
5. Отделите ошибки платформы от ошибок апстрима
Если минимальный запрос всё равно падает, проверьте лимиты скорости, блокировки безопасности, недоступность апстрима, таймауты и временные проблемы маршрутизации. Не повторяйте бесконечно. Для неповторяемых ошибок исправьте параметры, права или баланс, а для временных используйте ограниченное число повторов с задержкой.Что отправить в поддержку
- email или имя пользователя аккаунта;
- время запроса и часовой пояс;
- ID модели, эндпоинт и группу API-ключа;
- ошибку с закрытыми секретами и идентификатор запроса;
- скриншоты баланса и страницы цен в консоли;
- результат минимального воспроизведения.