LogoLogoДокументация API
LogoLogoДокументация API
Главная страница
ОбзорАутентификация и идемпотентностьГенерация изображенийРедактирование изображенийКонвертация изображенийЗадачи и ограниченное ожиданиеКредитыОшибкиОграничения частоты и параллелизмаИстория изменений API
Документация API

Ограничения частоты и параллелизма

Лимиты запросов на ключ и лимиты задач на аккаунт

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

ОграничениеТекущее значение
Создание задач10 запросов в минуту на ключ API, суммарно по всем эндпоинтам создания
Аутентифицированные чтения120 запросов в минуту на ключ API
Активные задачи8 задач в статусе queued или processing на аккаунт
Размер пакетадо 4 результатов на задачу генерации или редактирования
Ограниченное ожиданиедо 30 секунд

Превышение лимита запросов или лимита активных задач возвращает HTTP 429 с кодом RATE_LIMIT_EXCEEDED. Используйте экспоненциальную задержку с джиттером и соблюдайте Retry-After, если он присутствует. Ключ идемпотентности должен оставаться неизменным, пока вы повторяете тот же логический запрос.

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

При максимальном размере пакета восемь активных задач генерации или редактирования могут запросить в сумме до 32 результатов. Это ограничение на объём отправки, а не гарантия того, что все результаты будут считаться одновременно.

Ошибки

Стабильная структура ошибок, коды и статусы HTTP

История изменений API

Версионированные изменения публичного контракта