Что такое асинхронная генерация
Для долгих запросов генерации изображений платформа поддерживает асинхронный режим: после отправки запроса немедленно возвращается ID задачи. Клиент получает окончательный результат через опрос — не нужно удерживать долгое соединение.
Асинхронный режим подходит для сценариев с длительным временем генерации и предотвращает прерывание из-за таймаута. Также удобно отправлять несколько задач пакетом.
Процесс использования
Три шага: отправить → опросить → скачать.
1. Отправка задачи
Отправьте POST на https://api.tvtapi.com/v1/images/async с API-ключом (Bearer) и параметрами:
curl -X POST https://api.tvtapi.com/v1/images/async \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"model-name","prompt":"текст описания"}'
Ответ содержит task_id — ваш идентификатор для запросов и скачивания.
2. Опрос статуса
Опрашивайте статус через task_id:
curl https://api.tvtapi.com/v1/images/async/{task_id} \
-H "Authorization: Bearer sk-xxxxxxxx"
Состояния: queued (в очереди), in_progress (генерация), succeeded (успех), failed (провал). Опрашивайте каждые несколько секунд, пока статус не станет succeeded или failed.
3. Скачивание изображения
После успеха скачайте через:
curl -L https://api.tvtapi.com/v1/images/async/{task_id}/content \
-H "Authorization: Bearer sk-xxxxxxxx"
Этот эндпоинт возвращает редирект 302 на фактический URL хранения. У каждого изображения есть лимит скачиваний; после таймаута задача автоматически истекает.
Также в веб-интерфейсе
Если не хотите писать код, используйте рабочую панель изображений на /ru-ru/user/image-studio. В панели есть встроенный переключатель асинхронного режима — после включения она автоматически опрашивает и показывает результаты.
Примечания
- Асинхронная функция требует включения администратором, а аккаунт пользователя должен иметь соответствующее разрешение
- У задач есть срок действия; просроченные задачи нельзя скачать
- Если задача слишком долго остаётся в
in_progress, система автоматически помечает её какfailed