Skip to main content
GET
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
  • Запрос статуса выполнения и результатов асинхронной задачи генерации видео
  • Обновление статуса и отслеживание прогресса в реальном времени
  • Получение сгенерированных видео при завершении задачи
  • Поддержка многоязычности (zh/en/ko/ja)
Все задачи генерации видео выполняются асинхронно. После отправки задачи необходимо запросить статус и результаты через API запроса.
Видеозадачи Seedance, которым нужна проверка материалов, используют этот же API статуса. queued может включать подготовку и ожидание проверки, а прием задачи не означает начало генерации. На подготовку по умолчанию отводится 20 минут на раунд без учета последующей генерации видео. Причина ошибки указана в error.message.
Обычные задачи изображений и видео также доступны через GET /v1/tasks/{task_id} с теми же определениями usage и billing. Эта страница описывает ответ пути запроса генерации, указанного в начале. Примеры показывают поля, а не текущие цены модели или постоянный способ тарификации. Используйте поля и суммы, возвращённые для конкретной задачи.

Исходные и резервные URL Seedance

Для задач Seedance с включенной передачей исходного URL поле result.data[].url сохраняет исходный URL видео провайдера. Сначала используйте url и переключайтесь на fallback_url того же элемента результата только при недоступности основного адреса. Платформа не переключает URL автоматически в зависимости от региона клиента. Резервные поля необязательны и возвращаются только при наличии доступной копии. Они могут отсутствовать, если передача исходного URL отключена, копия недоступна или у старой задачи нет копии. Отсутствие поля не означает ошибку генерации. Для последнего кадра сначала используйте last_frame_url, а при его недоступности используйте fallback_last_frame_url. Резервный URL не продлевает срок действия исходного URL. Для длительного хранения своевременно скачайте результат.

Авторизация

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

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

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

Ответ

string
Уникальный идентификатор задачи
string
Необязательный бизнес-ID клиента, возвращается только при передаче client_business_id во время создания задачи.
string
Тип объекта, всегда generation.task
string
Статус задачи
  • queued - Отправлена, ожидает обработки
  • in_progress - Обрабатывается
  • completed - Успешно завершено
  • failed - Ошибка
integer
Прогресс задачи в процентах (0-100)
string
Используемая модель генерации видео
integer
Необязательное время обновления задачи на платформе, Unix timestamp. Сейчас возвращается для Seedance Global. generation.updated_at - время обновления у поставщика.
integer
Время создания задачи (Unix timestamp)
integer
Время окончания задачи, Unix timestamp. Этот путь запроса возвращает его для успешных и неуспешных задач, если время окончания сохранено.
integer
Время завершения задачи (Unix timestamp, возвращается только при завершении)
object
Результат задачи (возвращается только при успехе)
object
Необязательные метаданные генерации Seedance. Возвращаются только сохранённые публичные поля без подстановки значений по умолчанию. Эти параметры описывают генерацию и не заменяют оплачиваемые количества в usage верхнего уровня.generation.usage - существующее поле совместимости с возможными completion_tokens и total_tokens. Оно может отсутствовать или отличаться от окончательного оплачиваемого количества. Не складывайте его с usage верхнего уровня; для оплачиваемых количеств используйте верхний usage.
object
Необязательные оплачиваемые количества, токены видео и счётчики инструментов. Единицы и условия пропуска описаны в разделе Поля использования задачи.Поля от charge_type до input_images - это оплачиваемые количества, они возвращаются только вместе с billing.status=settled. Видео с фиксированной ценой возвращают количества, подтверждённые при отправке; видео, рассчитываемые по фактической длительности или токенам, возвращают итоговые расчётные количества. Не возвращённые поля пропускаются и не заменяются нулями.
object
Необязательный статус тарификации платформы и подтверждённая сумма. Статус тарификации не зависит от статуса генерации; completed не гарантирует, что расчёт завершён. Отсутствие объекта не означает бесплатную задачу. См. Цены и фактические списания.Поле data.billing в Task Webhook использует те же условия подтверждения и значения.
integer
Время истечения URL видео (Unix timestamp)
object
Информация об ошибке (только при неудаче)Коды ошибок и сообщения обычно являются строками. Seedance Global сохраняет исходные JSON-значения поставщика в error.code и error.message, включая числа или null. Отсутствующие поля не заменяются значениями платформы по умолчанию.

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

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

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

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

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

Ошибки и причины сбоя

Ошибки запросов, причины сбоя задач и восстановление описаны в справочнике ошибок. После успешной проверки учитывайте статус задачи; HTTP-статус не является бизнес-кодом ошибки.

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

Генерация видео занимает больше времени, рекомендации:
  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.