Разберитесь с кредитами и лимитами

Текущие опубликованные ставки моделей класса official смотрите в Тарифах, доступный баланс — в кабинете. До платного запроса проверьте оба значения в организации, которой принадлежит API-ключ. Тарифная страница не показывает ставку возможного исполнения Jailbreak; его итоговое списание может отличаться от показанной official-ставки. Не считайте стоимость по фиксированному примеру в документации: доступные модели, ставки и права могут меняться данными каталога и тарифа. Бесплатный каталог моделей проверяет видимость без генерации.

Один логический запрос списывается один раз по закреплённой ставке фактически использованного класса доступа. Купленные кредиты пополнения оплачивают только доступ official. Jailbreak, если он разрешён подпиской, использует месячные кредиты подписки. Каталог может показывать выбираемый селектор <canonical-model-id>-jailbreak: он включает возможность Jailbreak, но не создаёт отдельную каноническую модель. Ответ, история и списание сохраняют канонический ID модели. Платный повтор с тем же ключом идемпотентности и параметрами возвращает прежний терминальный результат в пределах срока хранения вместо второго списания.

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

Перед платным вызовом

1. Проверьте выбранную организацию, тариф и баланс. Баланс другой организации не авторизует этот ключ.
2. Посмотрите опубликованную official-ставку модели и тариф в Тарифах, затем выберите доступный канонический ID модели. Если включён Jailbreak, не считайте official-ставку гарантией итогового списания.
3. Задайте ограниченное max_output_tokens и сделайте один осознанный запрос. Сохраните публичный ID запроса и Idempotency-Key, если возможен повтор. Повторяйте с тем же ключом только те же нормализованные параметры в пределах 24 часов.
4. Проверьте исход и окончательное списание в активности API. Пока резерв не закрыт, строка не называет его расходом. Баланс и опубликованные ставки дают контекст, но не заменяют списание этой строки.

Восстановитесь после лимита

HTTP 402 insufficient_credits означает, что подходящего источника кредитов не хватает. Купленные кредиты не оплачивают исполнение Jailbreak; если задействована эта возможность, проверьте доступные месячные кредиты подписки. HTTP 429 usage_limit_exceeded может отражать окно или период подписки. Читайте публичные подсказки о повторе/обновлении и x-should-retry; немедленный цикл не создаст новый лимит. Отдельный временный rate_limit_exceeded допускает повтор после указанной паузы с тем же ключом логического запроса. Порядок действий — в ошибках и лимитах.

До пополнения или смены тарифа выясните, дело в подходящем источнике кредитов, лимите подписки или временной частоте запросов. Пополнение не сбрасывает исчерпанное окно подписки, но подходящие купленные кредиты позволяют продолжить official запросы сверх этого окна; Jailbreak ими оплатить нельзя. Повтор 402 без изменения доступных подходящих кредитов не поможет. При временном 429 соблюдайте Retry-After; при x-should-retry: false сначала устраните причину. Доступные действия аккаунта проверяйте на текущей странице тарифов, а не угадывайте способ оплаты по API-ошибке.