Схема работы
Шаг 1: Отправка задачи
ОтправьтеPOST-запрос для создания задачи генерации:
taskId. Фактическая генерация выполняется в фоне.
Шаг 2: Получение результатов
Есть два варианта получения результатов:Вариант A: Polling (рекомендуется для начала)
Периодически проверяйте статус задачи:Вариант B: Webhooks (рекомендуется для продакшена)
Укажитеcallback_url при отправке:
POST, когда задача завершится.
Подробности в разделе Webhooks.
Состояния задачи
| Состояние | Описание |
|---|---|
pending | Задача в очереди, ожидает запуска |
processing | Задача выполняется |
success | Задача успешно завершена |
failed | Задача завершилась с ошибкой (см. failMsg) |
Рекомендации по polling
- Начинайте с интервалов 3–5 секунд для большинства задач
- Используйте экспоненциальный backoff для длительных задач (видео)
- Задайте максимальный таймаут (например, 5 минут)
- Обрабатывайте ошибки с логикой повторных попыток
Когда использовать каждый подход
| Подход | Лучше всего подходит для |
|---|---|
| Polling | Простые интеграции, клиентские приложения, тестирование |
| Webhooks | Продакшен-серверы, real-time приложения, высокая нагрузка |