Ліміти частоти
Кожен ключ має два ліміти: запитів за хвилину і за добу (доба рахується за 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. - Ідемпотентність - безпечні повтори без подвійного списання.