Skip to main content
GET
  • Запрос статуса выполнения и результатов асинхронной задачи генерации видео
  • Обновление статуса и отслеживание прогресса в реальном времени
  • Получение сгенерированных видео при завершении задачи
  • Поддержка многоязычности (zh/en/ko/ja)
Все задачи генерации видео выполняются асинхронно. После отправки задачи необходимо запросить статус и результаты через API запроса.

Авторизация

string
обязательно
Все эндпоинты требуют аутентификации Bearer TokenПолучить API ключ:Посетите Страницу управления API ключами для получения API ключаДобавьте в заголовок запроса:

Параметры пути

string
обязательно
ID задачи, возвращенный API генерации видео

Ответ

string
Уникальный идентификатор задачи
string
Тип объекта, всегда generation.task
string
Статус задачи
  • queued - Отправлена, ожидает обработки
  • in_progress - Обрабатывается
  • completed - Успешно завершено
  • failed - Ошибка
integer
Прогресс задачи в процентах (0-100)
string
Используемая модель генерации видео
integer
Время создания задачи (Unix timestamp)
integer
Время завершения задачи (Unix timestamp, возвращается только при завершении)
integer
Ожидаемое время завершения (секунды)
object
Результат задачи (возвращается только при успехе)
object
Использование инструментов модели. Для Seedance 2 с tools: [{ "type": "web_search" }] поле usage.tool_usage.web_search содержит фактическое число поисков; 0 означает отсутствие поиска.
integer
Время истечения URL видео (Unix timestamp)
object
Информация об ошибке (только при неудаче)

Справка по статусам задач

Стратегия опроса

Пример опроса на Python

Срок действия ресурсов

URL сгенерированных видео действительны 24 часа
  • Загрузите и сохраните видео в течение срока действия
  • Поле expires_at указывает время истечения видео (Unix timestamp)
  • После истечения срока видео недоступны; для повторного получения отправьте новую задачу
  • Превью истекает одновременно с видео

Коды ошибок

Советы по производительности

Генерация видео занимает больше времени, рекомендации:
  1. Используйте ToAPIs Task Webhook: Webhook — основной канал, polling — резерв
  2. Интервал polling: не менее 5–10 секунд с jitter; при 429 соблюдайте Retry-After и exponential backoff
  3. Установите таймаут: Длинные видео могут занимать 5-10 минут, установите разумный таймаут
  4. Загружайте своевременно: Видео истекают через 24 часа, обязательно сохраните в своё хранилище немедленно
См. лимиты асинхронных задач. Batch-запрос принимает максимум 100 task ID.