> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Очереди и параллельные запросы

> Узнайте, как работают аккаунты TTAPI и система очередей, включая ограничения параллелизма API, постановку запросов в очередь, приоритет очереди и ограничение частоты запросов.

## Что означает очередь в TTAPI

В TTAPI `queue` - это не классический лимит вроде `QPS` или `RPM`. Под очередь понимается количество **активных задач**, которые ваш аккаунт может удерживать одновременно для конкретного продукта.

Активная задача обычно означает одно из следующих состояний:

* задача принята, но еще ожидает своей очереди
* задача уже выполняется, но еще не завершена
* окончательный результат будет получен позже через опрос или вебхук

То есть очередь ближе к лимиту параллельно выполняемых задач, чем к ограничению числа запросов в секунду.

## Какие продукты используют очередь

| Продукт      | Есть очередь-лимит | Почему                                              |
| :----------- | :----------------- | :-------------------------------------------------- |
| `Midjourney` | Да                 | Задачи выполняются не мгновенно и обычно асинхронны |
| `Suno`       | Да                 | Генерация музыки длительная и асинхронная           |
| `Sora`       | Да                 | Генерация видео ресурсоемкая и медленная            |
| `Producer`   | Да                 | Аудиогенерация и обработка не являются мгновенными  |

Все эти продукты объединяет один и тот же паттерн: более длительное время выполнения, более высокий расход ресурсов и отложенное получение финального результата.

## Зачем нужны очередь-лимиты

TTAPI опирается на конечный пул аккаунтов и вычислительных ресурсов внутри каждого продуктового направления.

Без очередь-контроля один клиент может внезапно отправить слишком много параллельных задач и занять общий пул, что приведет к таким последствиям:

* насыщение одной продуктовой линии
* блокировка отправки или получения задач для других пользователей
* накопление большой очереди во всем сервисе
* срабатывание ограничений со стороны внешних-поставщиков или деградация сервиса

Цель очередь-лимитов не в том, чтобы мешать нормальному использованию. Их задача - предотвращать злоупотребления или незапланированные всплески трафика, которые могут дестабилизировать платформу.

## Расширение очередь

Если вы ожидаете стабильный и предсказуемый трафик, можно [связаться с нами](/grids/ru/about/connect) и запросить увеличение очередь.

Полезно сразу указать:

* для какого продукта нужна дополнительная очередь
* какой пиковый параллелизм вы ожидаете
* какой у вас типичный дневной объем задач
* в какое временное окно ожидается рост трафика
* связан ли рост с запуском, кампанией или плановым масштабированием

Сейчас расширение очередь предоставляется **бесплатно**, но в будущем мы можем включить его в дополнительные платные сервисы.
