Асинхронная генерация изображений

Что такое асинхронная генерация

Для долгих запросов генерации изображений платформа поддерживает асинхронный режим: после отправки запроса немедленно возвращается 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