Баланс и квоты
RouteAPI работает по предоплатной модели: сначала вы пополняете баланс аккаунта, а вызовы списывают средства с баланса по фактическому использованию. Для каждого API-ключа можно задать отдельную квоту, а также включить автопополнение, чтобы избежать перебоев из-за исчерпания баланса.
Цены в долларах США
Section titled “Цены в долларах США”Баланс аккаунта, цены моделей, квоты API-ключей и суммы пополнения указываются в долларах США (USD). Консоль может отображать суммы в другой валюте в соответствии с настройками сайта — это только пересчёт для отображения; списания и учёт всегда ведутся в долларах США.
Баланс аккаунта
Section titled “Баланс аккаунта”Баланс аккаунта — это общий пул средств для всех ваших API-ключей. Текущий баланс и историю использования можно посмотреть в кошельке.
- Каждый запрос оплачивается с баланса аккаунта; баланс не может уйти в минус.
- Если баланса не хватает на расчётную стоимость запроса, запрос отклоняется с кодом
403и ошибкойinsufficient_user_quota. Как рассчитывается стоимость, см. в разделе Использование и биллинг. - Если для аккаунта действует индивидуальная скидка, Витрина моделей показывает цену со скидкой, а в журнале использования отображается «Персональный множитель»; списание рассчитывается по цене со скидкой.
Квоты API-ключей
Section titled “Квоты API-ключей”При создании или редактировании ключа на странице API-ключи для каждого ключа можно настроить:
| Настройка | Описание |
|---|---|
| Квота (USD) | Максимальная сумма, которую может потратить ключ; можно задать без ограничений |
| Срок действия | После истечения ключ перестаёт работать; по умолчанию не истекает |
| Ограничение моделей | Ключу разрешено вызывать только указанные модели |
| Белый список IP | Принимаются только запросы с указанных IP |
Квота ключа — это верхний предел, а не отдельный кошелёк. Каждый запрос одновременно уменьшает квоту ключа и баланс аккаунта; если не хватает хотя бы одного из них, запрос отклоняется. Даже при неограниченной квоте фактически доступная сумма ограничена балансом аккаунта.
Обычно ключи создают для разных проектов, окружений или участников с отдельными квотами, чтобы одно приложение не израсходовало весь баланс аккаунта. В списке API-ключей отображаются использованная и общая квота каждого ключа.
| Ситуация | Ответ |
|---|---|
| Квота ключа исчерпана | 401, с сообщением об исчерпании квоты ключа |
| Остатка квоты ключа не хватает на расчётную стоимость запроса | 403, код ошибки pre_consume_token_quota_failed |
| Ключ истёк или отключён | 401 |
| Запрошена модель, не разрешённая для ключа, или IP источника не в белом списке | 403 |
Пополнение
Section titled “Пополнение”На странице кошелька выберите сумму и способ оплаты. Минимальная сумма пополнения — 1 доллар США. Доступные способы оплаты указаны на странице кошелька.
- Баланс зачисляется в указанной вами сумме в долларах США.
- При оплате банковской картой через Stripe фактическое списание включает комиссию 4% от суммы пополнения для покрытия расходов на обработку платежа и налогов. Итоговая сумма списания показывается на странице до оплаты.
Автопополнение
Section titled “Автопополнение”После включения автопополнения, когда баланс опускается ниже заданного порога, система автоматически пополняет фиксированную сумму с сохранённой банковской карты. Это подходит для производственных сред, которым нужна стабильная работа. Настраивается в разделе «Автопополнение» на странице кошелька.
| Настройка | Описание | Диапазон |
|---|---|---|
| Порог срабатывания | Пополнение запускается, когда баланс ниже этой суммы | Не более 1 000 USD, по умолчанию 20 USD |
| Сумма пополнения | Сумма каждого автопополнения | 10–5 000 USD, по умолчанию 100 USD |
| Лимит в месяц | Суммарный лимит автопополнений за календарный месяц; 0 — без ограничений | Не более 50 000 USD и не меньше суммы одного пополнения |
| Способ оплаты | Банковская карта для списания | Можно сохранить до 3 карт; используются в заданном порядке |
Как это работает:
- После расчёта каждого запроса проверяется баланс; если он ниже порога, запускается пополнение. Между двумя автопополнениями проходит не менее 10 минут.
- Если при сохранении настроек баланс уже ниже порога, пополнение запускается сразу.
- Если карта по умолчанию явно отклонена (например, истёк её срок действия или банк-эмитент отклонил платёж), система по очереди пробует следующую сохранённую карту. При неопределённом результате (например, требуется 3D-верификация) карта не меняется, чтобы избежать повторного списания.
- Если все карты не сработали, повторные попытки выполняются через 15 минут, 1 час, 3 часа и 6 часов. Если они снова не удались, попытки прекращаются и вам отправляется уведомление по почте. На странице кошелька также появится подсказка: после смены способа оплаты можно нажать «Пополнить сейчас».
- После достижения месячного лимита автопополнение в этом месяце больше не выполняется.
- На автопополнение также распространяется комиссия 4%.
Напоминания о балансе
Section titled “Напоминания о балансе”В настройках уведомлений в личных настройках можно задать порог напоминания о балансе; когда баланс ниже порога, вы получите уведомление по почте, через Webhook, Bark или Gotify. Если запрос отклонён из-за исчерпания баланса, система также отправит письмо — не чаще одного раза в день.
Что делать при нехватке баланса
Section titled “Что делать при нехватке баланса”- Пополните кошелёк или включите автопополнение.
- Если код ошибки —
pre_consume_token_quota_failedили сообщение говорит об исчерпании квоты ключа, нужно увеличить квоту этого ключа; пополнение аккаунта не поможет. - Если баланса, казалось бы, достаточно, но запросы отклоняются, проверьте, не задан ли в запросе слишком большой
max_tokens. Расчётная стоимость учитываетmax_tokens; подробнее см. в разделе Использование и биллинг. - Проверьте недавние расходы в журнале использования.