Квоты и лимиты
Лимиты файлов, API-ключей и расходов для Konergy API.
Лимиты файлов
| Тип файла | Максимальный размер файла | Допустимые форматы |
|---|---|---|
| Изображение | 10 МБ | JPEG, PNG, GIF, WebP, BMP |
| 25 МБ |
Для /api/jobs/process и /api/jobs/process-pdf максимальный размер тела HTTP-запроса составляет 12 МБ. Для этих эндпоинтов фактический допустимый размер PDF-вложения может быть ниже 25 МБ. При превышении лимита возвращается ошибка 413 FILE_TOO_LARGE.
Лимиты API-ключей
| Субъект | Максимум активных ключей |
|---|---|
| Пользователь (личные) | 10 |
| Организация | 50 |
При попытке создать ключ сверх лимита возвращается ошибка 422 API_KEY_LIMIT_REACHED. Для увеличения лимита отзовите неиспользуемые ключи или обратитесь в поддержку.
Лимиты расходов (Spend Limits)
Организации могут установить ежемесячный лимит расходов для контроля бюджета. При достижении лимита все запросы организации блокируются с ошибкой 402 SPEND_LIMIT_EXCEEDED.
| Параметр | Значение |
|---|---|
| Минимальный лимит | 50 000 копеек (500 ₽) |
| Порог предупреждения (warningThreshold) | от 0.1 до 1.0 (по умолчанию 0.8) |
| Статус: normal | Расход ниже порога предупреждения |
| Статус: warning | Расход достиг порога предупреждения |
| Статус: exceeded | Расход достиг 100% лимита, запросы заблокированы |
Подробнее об управлении лимитами расходов читайте в разделе Биллинг и цены.
Как увеличить лимиты
- Отзовите неиспользуемые ключи — освободите слоты для создания новых
- Увеличьте spend limit — измените ежемесячный лимит расходов через Management API
- Обратитесь в поддержку — для индивидуального увеличения лимитов напишите на support@konergy.ru