Ограничения частоты

Узнайте, сколько запросов и задач допускает ваш тарифный план, и что делать при достижении лимита.

Лимиты по тарифным планам

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

Запросов в секунду: сколько API-запросов вы можете отправлять каждую секунду.
Одновременные задачи: сколько ваших задач могут одновременно находиться в статусе PENDING или IN_PROGRESS.

Лимиты зависят от вашего тарифного плана:

Тариф	Запросов в секунду	Одновременные задачи	Приоритет
Pro	20	10	По умолчанию
Premium	20	30	Выше, чем Pro
Ultra	20	100	Наивысший
Studio	20	60, или 20 на некоторых более ранних тарифах Studio	Выше, чем Pro
Enterprise	100	100 по умолчанию, или индивидуальный лимит	Наивысший

Приоритет — это не лимит. Когда очередь загружена, Meshy сначала запускает задачи с более высоким приоритетом.

Что учитывается в каждом лимите

Каждый API-запрос учитывается в лимите запросов в секунду, включая запросы на получение, список или потоковую передачу задач. Запросы из веб-приложения Meshy не учитываются.

Лимит одновременных задач учитывает задачи, а не запросы. Каждый эндпоинт, создающий задачу, проверяет этот лимит перед её созданием. Например, его проверяют Текст в 3D, Изображение в 3D, Мульти-изображение в 3D, Ретекстурирование, Ремешинг, Rigging, Анимация, Текст в изображение, эндпоинты 3D-печати и Creative Lab.

Запросы, которые не создают задачу, не учитываются в этом лимите. Например, Balance, Usage и запросы на получение, список или потоковую передачу задач не учитываются.

Чьи лимиты применяются

В следующей таблице показано, чьи лимиты учитывают ваши API-ключи, Playground и веб-приложение:

Где вы работаете	Личный аккаунт	Команда
API-ключи	Ваши лимиты	Лимиты команды, общие для всех API-ключей команды
Playground	Ваши лимиты	Ваши собственные лимиты как авторизованного участника
Веб-приложение	Ваши одновременные задачи	Ваши собственные одновременные задачи. Задачи, запущенные владельцем команды, также учитываются в лимитах команды.

Когда вы достигаете лимита

Когда вы превышаете лимит, API возвращает 429 Too Many Requests. Сообщение указывает, какой именно лимит вы достигли:

Слишком много запросов в секунду: сообщение — Rate limit exceeded. Подождите количество секунд, указанное в заголовке Retry-After, затем повторите запрос.
Слишком много одновременных задач: сообщение начинается с NoMorePendingTasks. На безлимитном тарифе без оставшихся кредитов оно начинается с NoMoreConcurrentTasks. Этот 429 не содержит заголовка Retry-After. Дождитесь завершения одной из ваших задач, прежде чем создавать следующую.

Заголовки ограничения частоты

Ответы API содержат следующие заголовки, помогающие вам регулировать темп запросов:

Заголовок	Описание
`X-RateLimit-Limit`	Количество запросов в секунду, разрешённое на вашем тарифе.
`X-RateLimit-Remaining`	Количество оставшихся запросов в текущей секунде.
`X-RateLimit-Reset`	Количество секунд до полного восстановления вашего бюджета.
`Retry-After`	Количество секунд ожидания перед следующим запросом. Отправляется с кодом `429` при превышении лимита запросов в секунду, а также когда вы получаете задачу, всё ещё находящуюся в статусе `PENDING` или `IN_PROGRESS`.

Если присутствует заголовок Retry-After, подождите указанное в нём количество секунд перед отправкой следующего запроса.