Ограничение расходов API-ключа
Задайте в кабинете дневной, недельный или месячный лимит в рублях для ключа проекта.
Обновлено
Используйте отдельный API-ключ и рублёвый лимит для каждого проекта, агента или участника команды, чьи расходы нужно контролировать независимо.
Задайте лимит в кабинете
- Откройте раздел API-ключи в рабочем пространстве, которому принадлежит ключ.
- Создайте отдельный ключ или найдите существующий.
- Откройте его настройки лимита.
- Выберите вариант без лимита или один из показанных периодов:
DAY,WEEKилиMONTH. - Укажите сумму в рублях и сохраните.
В строке ключа показано, сколько уже потрачено из заданной суммы. На той же странице можно посмотреть недавнее использование моделей этим ключом.
Используйте отдельный ключ и лимит для каждого проекта.
Разберитесь в календарных периодах
| Период | Окно в Europe/Moscow |
|---|---|
DAY | Начинается в полночь по Москве. |
WEEK | Начинается в понедельник в полночь по Москве. |
MONTH | Начинается в первый день месяца в полночь по Москве. |
При обработке заблокированного запроса используйте значение resetAt из ответа. Не вычисляйте сброс по часовому поясу клиента.
Узнайте, что проверяет лимит
Перед началом запроса сервис складывает уже списанную сумму, активные резервы и оценку нового запроса, а затем сравнивает итог с лимитом. Если итог превысит лимит ключа, выполнение модели не начинается, а API возвращает HTTP 429 с кодом API_KEY_SPEND_LIMIT_EXCEEDED.
В ответе указаны период, лимит, списанная и зарезервированная суммы, оценка нового запроса, валюта и resetAt. Резерв остаётся оценкой: после завершения списывается полная подтверждённая стоимость, даже если она выше резерва, а следующие запросы после этого могут быть заблокированы.
Используйте поддерживаемый способ управления
Создавайте, меняйте и удаляйте лимиты в интерфейсе кабинета. Документированного публичного контракта для автоматического управления лимитами сейчас нет. Не копируйте сетевые запросы из инструментов разработчика браузера: они не являются публичным API и не работают с платформенным ключом.
Обработайте заблокированный запрос
При API_KEY_SPEND_LIMIT_EXCEEDED дождитесь указанного в ответе resetAt или измените лимит ключа в разделе API-ключи. Повтор с задержкой сам по себе не увеличивает лимит. Если у ответа 429 другой код, выполните действие для этой публичной ошибки.