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

Source: https://provod.ai/ru/docs/spend-limits

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

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

1. Откройте раздел [API-ключи](https://app.provod.ai/api-keys) в рабочем пространстве, которому принадлежит ключ.
2. Создайте отдельный ключ или найдите существующий.
3. Откройте его настройки лимита.
4. Выберите вариант без лимита или один из показанных периодов: `DAY`, `WEEK` или `MONTH`.
5. Укажите сумму в рублях и сохраните.

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

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

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

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

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

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

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

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

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

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

Создавайте, меняйте и удаляйте лимиты в интерфейсе кабинета. Документированного публичного контракта для автоматического управления лимитами сейчас нет. Не копируйте сетевые запросы из инструментов разработчика браузера: они не являются публичным API и не работают с платформенным ключом.

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

При `API_KEY_SPEND_LIMIT_EXCEEDED` дождитесь указанного в ответе `resetAt` или измените лимит ключа в разделе [API-ключи](https://app.provod.ai/api-keys). Повтор с задержкой сам по себе не увеличивает лимит. Если у ответа `429` другой код, выполните действие для этой публичной ошибки.

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


**Запрос заблокирован с HTTP 429**


Сначала прочитайте код ошибки. `API_KEY_SPEND_LIMIT_EXCEEDED` относится к бюджету: проверьте `period`, `spentAmount`, `reservedAmount` и `resetAt`. Для другого кода `429` действуют свои правила повторных запросов, а не изменение лимита.


**После resetAt возвращается та же ошибка лимита**


Обновите данные ключа, проверьте активное рабочее пространство, название ключа и видимый маскированный префикс, затем сопоставьте `resetAt` с московским временем. Если значение не обновилось, сохраните точный ответ и время запроса для поддержки.


**Итоговый расход превысил заданную сумму**


Сравните резерв запроса с его итоговой суммой в разделе использования. Один выполняющийся запрос может завершиться дороже оценки; лимит учтёт всю сумму и заблокирует следующие запросы. Это другой случай, чем одновременное резервирование бюджета несколькими запросами.

## FAQ

### Что такое provod.ai?

provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md).

### У provod.ai самые низкие цены среди российских провайдеров?

Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md).

### Можно ли обещать отсутствие наценки?

Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения.

### Насколько стабилен сервис?

provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора.

### Почему provod.ai подходит для юридически оформленной работы в России?

provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента.

### provod.ai работает без VPN?

Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге.

### Какие протоколы и интеграции доступны?

Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели.

### Есть изображения и видео?

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

### Какие источники считать актуальными?

Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).