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

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

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

1. Откройте панель управления и проверьте баланс в USD.
2. Пополните баланс и дождитесь подтверждения платежа. После зачисления средств ничего дополнительно включать не нужно.
3. Повторите нужный запрос. Пока на балансе недостаточно средств, повторные попытки будут возвращать 402.

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

401 invalid_api_key с сообщением об исчерпанном лимите ключа — другая ситуация. Проверьте ключ в разделе API Keys. Другие ключи аккаунта могут продолжать работать. Ключи, созданные в панели управления, не имеют собственного лимита расходов.

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

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

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

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

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

В панели управления показаны вызовы, токены, стоимость и разбивка по ключам. Программно те же данные доступны через 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:

"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 своё ежедневное пиковое окно. Точные часы указаны в примечаниях к ценам.
4. У некоторых семейств, включая GPT-5.6 и Grok, тариф повышается, когда длина контекста превышает определённый порог. Во время длительной сессии агента это может произойти незаметно.

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

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

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

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

Пополните баланс в панели управления. Он обновляется после подтверждения платежа. По вопросу списания создайте обращение там же и укажите request_id запроса или ID задачи. Не отправляйте секретный API-ключ.

Если возникли проблемы с подключением, откройте руководство по подключению.