provod.ai / docs
Оплата и контроль

Ограничение расходов API-ключа

Задайте в кабинете дневной, недельный или месячный лимит в рублях для ключа проекта.

Обновлено

Используйте отдельный API-ключ и рублёвый лимит для каждого проекта, агента или участника команды, чьи расходы нужно контролировать независимо.

Задайте лимит в кабинете

  1. Откройте раздел API-ключи в рабочем пространстве, которому принадлежит ключ.
  2. Создайте отдельный ключ или найдите существующий.
  3. Откройте его настройки лимита.
  4. Выберите вариант без лимита или один из показанных периодов: DAY, WEEK или MONTH.
  5. Укажите сумму в рублях и сохраните.

В строке ключа показано, сколько уже потрачено из заданной суммы. На той же странице можно посмотреть недавнее использование моделей этим ключом.

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

Используйте отдельный ключ и лимит для каждого проекта.

Разберитесь в календарных периодах

ПериодОкно в Europe/Moscow
DAYНачинается в полночь по Москве.
WEEKНачинается в понедельник в полночь по Москве.
MONTHНачинается в первый день месяца в полночь по Москве.

При обработке заблокированного запроса используйте значение resetAt из ответа. Не вычисляйте сброс по часовому поясу клиента.

Узнайте, что проверяет лимит

Перед началом запроса сервис складывает уже списанную сумму, активные резервы и оценку нового запроса, а затем сравнивает итог с лимитом. Если итог превысит лимит ключа, выполнение модели не начинается, а API возвращает HTTP 429 с кодом API_KEY_SPEND_LIMIT_EXCEEDED.

В ответе указаны период, лимит, списанная и зарезервированная суммы, оценка нового запроса, валюта и resetAt. Резерв остаётся оценкой: после завершения списывается полная подтверждённая стоимость, даже если она выше резерва, а следующие запросы после этого могут быть заблокированы.

Проверьте лимит из терминала или агента

Обычный API-ключ позволяет прочитать собственный лимит через GET https://api.provod.ai/v1/key. Используйте ключ из локальной конфигурации клиента; передавать полный ключ в чат поддержки не нужно.

curl --fail-with-body https://api.provod.ai/v1/key \
  -H "Authorization: Bearer $PROVOD_API_KEY"

Ответ находится в data: limit — настроенная сумма в рублях, limit_remaining — сумма за вычетом списаний текущего периода, limit_reset — период (day, week или month). null означает отсутствие настроенного лимита, а не нулевой баланс.

Это сведения о лимите ключа, а не баланс рабочего пространства. Активные резервы и стоимость нового запроса проверяются отдельно при запуске модели. При нескольких лимитах этот совместимый формат показывает один период; все настройки доступны в кабинете. /v1/account возвращает сведения об аккаунте, а не остаток лимита.

Используйте поддерживаемый способ управления

Создавайте, меняйте и удаляйте лимиты в интерфейсе кабинета. Для автоматизации существует отдельный control OAuth API /api/cli/api-keys: он требует токен с соответствующими provod:keys:* scopes и правами текущего пространства. Обычный платформенный ключ генерации не подходит для управления ключами и лимитами. Не копируйте сетевые запросы из инструментов разработчика браузера: они не являются публичным API и не работают с платформенным ключом.

Обработайте заблокированный запрос

При API_KEY_SPEND_LIMIT_EXCEEDED дождитесь указанного в ответе resetAt или измените лимит ключа в разделе API-ключи. Повтор с задержкой сам по себе не увеличивает лимит. Если у ответа 429 другой код, выполните действие для этой публичной ошибки.

Управление ключами и точные расходы

Для запросов к моделям используйте обычный API-ключ. Отдельный управляющий ключ нужен для создания ключей, лимитов и аналитики своего пространства. Chat Completions и Responses возвращают фактическое списание в usage.cost с usage.currency; точная строка — provod.billing.total_charge. После обрыва используйте сохранённый x-generation-id и получение стоимости генерации, не повторную генерацию.

Решение проблем

На этой странице