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

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

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

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

При проверке черновиков Draft и итоговых видео различайте задачи по draft и draft_task_id в нативных данных. Полный процесс описан в руководстве по черновикам Draft.

GET/v1/video/generations/{task_id}

Используйте ID из ответа на создание для получения видеозадачи Seedance 2.5. По умолчанию возвращается совместимая обёртка платформы из code, message и data; при переходе в succeeded, completed или failed прекратите опрос.

raw=true возвращает нативную структуру задачи Volcengine Ark напрямую; show_raw=true добавляет ту же структуру в data.data совместимой обёртки; show_usage=true добавляет обработанные платформой данные использования в data.usage успешной задачи.

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

bearerAuth

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

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

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

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

task_id*string

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

Длина1 <= length

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

raw?boolean

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

show_raw?boolean

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

show_usage?boolean

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

Тело ответа

`application/json`

curl -X GET "https://example.com/v1/video/generations/task_xxxxx"

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxxxx",
    "status": "succeeded",
    "url": "https://example.com/generated-video.mov",
    "format": "mov",
    "metadata": null,
    "error": null
  }
}

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

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

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

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

Тело ответа

200application/json

400application/json

401application/json

402application/json

404

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`