Управление задачами
Получить статус задачи видео
Запрос статуса и результатов задачи генерации видео
GET
- Запрос статуса выполнения и результатов асинхронной задачи генерации видео
- Обновление статуса и отслеживание прогресса в реальном времени
- Получение сгенерированных видео при завершении задачи
- Поддержка многоязычности (zh/en/ko/ja)
Авторизация
Все эндпоинты требуют аутентификации Bearer TokenПолучить API ключ:Посетите Страницу управления API ключами для получения API ключаДобавьте в заголовок запроса:
Параметры пути
ID задачи, возвращенный API генерации видео
Ответ
Уникальный идентификатор задачи
Тип объекта, всегда
generation.taskСтатус задачи
queued- Отправлена, ожидает обработкиin_progress- Обрабатываетсяcompleted- Успешно завершеноfailed- Ошибка
Прогресс задачи в процентах (0-100)
Используемая модель генерации видео
Время создания задачи (Unix timestamp)
Время завершения задачи (Unix timestamp, возвращается только при завершении)
Ожидаемое время завершения (секунды)
Результат задачи (возвращается только при успехе)
Время истечения URL видео (Unix timestamp)
Информация об ошибке (только при неудаче)
Справка по статусам задач
| Статус | Описание | Финальный | Рекомендуемое действие |
|---|---|---|---|
queued | Задача отправлена, ожидает в очереди | ❌ | Подождите 5-10 секунд и повторите запрос |
in_progress | Задача обрабатывается | ❌ | Подождите 10-15 секунд и повторите запрос |
completed | Задача успешно завершена | ✅ | Получите видео из result.data[0].url |
failed | Обработка задачи не удалась | ✅ | Проверьте информацию об ошибке |
Стратегия опроса
Пример опроса на Python
Срок действия ресурсов
Коды ошибок
| HTTP код | Тип ошибки | Описание |
|---|---|---|
| 400 | invalid_request | Неверные параметры запроса |
| 401 | unauthorized | Ошибка аутентификации, проверьте API Key |
| 402 | insufficient_quota | Недостаточно средств |
| 404 | task_not_found | Задача не найдена |
| 422 | content_policy_violation | Нарушение политики контента |
| 429 | rate_limit_exceeded | Превышен лимит запросов |
| 500 | internal_error | Внутренняя ошибка сервера |
Советы по производительности
Генерация видео занимает больше времени, рекомендации:
- Используйте Webhook-обратные вызовы: Если поддерживается, настройте URL обратного вызова, чтобы избежать частых опросов
- Установите разумный интервал опроса: Рекомендуется 10 секунд, слишком частые запросы тратят квоту
- Установите таймаут: Длинные видео могут занимать 5-10 минут, установите разумный таймаут
- Загружайте своевременно: Видео истекают через 24 часа, обязательно сохраните в своё хранилище немедленно