Получить видео

Получение видеозадачи Seedance 2.0 через API платформы Video Generations.

Используйте ID задачи для получения состояния и результата. По умолчанию возвращается объект задачи платформы; raw=true возвращает нативную структуру задачи Volcengine Ark напрямую, show_raw=true добавляет ту же нативную структуру в обёртку платформы, а show_usage=true возвращает обработанные платформой данные использования. Адреса видео и конечного кадра могут иметь срок действия; своевременно загрузите их или сохраните в другом хранилище.

Если требуется структура задачи Volcengine Ark напрямую, см. нативный интерфейс получения.

Нативные данные задачи поддерживают разрешение 4k стандартной Seedance 2.0 и priority задачи; Fast поддерживает только 480p/720p.

GET/v1/video/generations/{task_id}

Используйте ID из ответа на создание для получения видеозадачи Seedance 2.0. При переходе в completed или failed прекратите опрос.

Рекомендуется опрашивать каждые 30–60 секунд. URL готового видео может иметь срок действия; своевременно загрузите видео и сохраните в другом хранилище.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

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

task_id*string

ID задачи из ответа на создание видео.

Длина1 <= length

Параметры строки запроса

raw?boolean

При true возвращает исходные данные задачи вышестоящего сервиса напрямую для диагностики.

show_raw?boolean

При true добавляет исходные данные задачи вышестоящего сервиса в поле data.data совместимого ответа-обёртки.

show_usage?boolean

При true и успешном выполнении задачи добавляет данные использования в поле data.usage совместимого ответа-обёртки.

Тело ответа

`application/json`

curl -X GET "https://example.com/v1/video/generations/cgt-20260330164007-wnc8k"

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "completed",
  "progress": 100,
  "created_at": 1774860007,
  "completed_at": 1774860088,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Структура нативной задачи Seedance 2.0Структура получения задачи Volcengine Ark, используемая raw и show_raw.

Аутентификация

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

Параметры строки запроса

Тело ответа

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`