Лимиты частоты
У каждого ключа два лимита: запросов в минуту и в сутки (сутки считаются по UTC). Значения именно для вашего ключа показывает GET /me в поле rateLimit (rpm и rpd).
Каждый ответ на запрос с ключом несет состояние того лимита, который сейчас ближе к исчерпанию, - включая скачивание файлов (оно тоже считается в лимит частоты). Ответы, данные до проверки ключа или лимита, этих заголовков не несут: неверный ключ (401), испорченное тело (400), неизвестный путь (404), неверные параметры запроса (400 validation), нет нужной области (403 forbidden_scope), запись, отклоненная для тестового ключа (403).
В браузере (CORS) доступны для чтения заголовки RateLimit-*, Retry-After, Grem-Sandbox, X-Request-Id и Content-Range.
RateLimit-Limit: 60
RateLimit-Remaining: 12
RateLimit-Reset: 41
| Заголовок | Что означает |
|---|---|
RateLimit-Limit | сколько запросов разрешено в текущем окне |
RateLimit-Remaining | сколько осталось |
RateLimit-Reset | через сколько секунд окно сбросится |
Сверх лимита приходит 429 с title: rate_limited и заголовком Retry-After. Лимит частоты - техническая защита, он ничего не списывает.
Следите за RateLimit-Remaining и распределяйте запросы во времени. Опрос статуса задач тоже считается в лимит частоты, хотя и бесплатный - не опрашивайте чаще, чем раз в несколько секунд, или перейдите на вебхуки.
Оплата
Отдельного тарифа для API нет: доступ входит в вашу подписку, а платные действия списываются с того же кошелька, что и в кабинете.
Платный вызов состоит из двух частей:
- Вызов API. Берется из пула вызовов, включенного в тариф. Сверх пула вызовы оплачиваются по факту.
- Цена инструмента - столько же, сколько то же действие стоит в кабинете (из включенной квоты плана или из кошелька).
Пул вызовов API в тарифах:
| Тариф | Вызовов API в месяц |
|---|---|
| Free | 100 |
| Start | 5 000 |
| PRO | 25 000 |
| MAX | 100 000 |
| Agency Start | 50 000 |
| Agency Growth | 250 000 |
| Agency Scale | без ограничения в рамках разумного использования |
Для других тарифов и актуальных квот инструментов и цен смотрите страницу тарифов в кабинете.
Что платное, а что нет
Класс оплаты каждой операции указан в /openapi.json в поле x-grem-billing: free, api_call или api_call+sku:... (вызов плюс цена инструмента).
| Платное | Бесплатное |
|---|---|
запуск инструментов (POST оценки, текстов, видео, фото, PDF, сайта и т. д.) - вызов + цена инструмента | все запросы чтения (GET), включая опрос статуса задач и скачивание файлов |
| флаер и подтверждение проверки отчета - только вызов | объекты: создание, изменение, удаление |
| сообщение в чат - вызов + цена сообщения | лиды и Swipe Match: создание, изменение, события |
| создание, изменение и удаление сессий чата - только вызов | загрузка изображений |
| управление вебхуками |
Отклоненный запрос (4xx или 5xx) вызов API не списывает. Исключение - 502 provider_error после таймаута: работа может завершиться и быть оплачена - проверьте GET /works (улучшение фото, сайт и черновик - в кабинете или среди своих объектов). Повтор экспресс-оценки с тем же Idempotency-Key возвращает результат бесплатно (ни оценка, ни вызов API); в других инструментах после таймаута ключ занят 15 минут - проверьте результат, а не повторяйте.
Вызовы, расходы и ошибки по ключам видно в кабинете на странице API, вкладка Аналитика.
Связанные статьи
- Ошибки -
402и429. - Идемпотентность - безопасные повторы без двойного списания.