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

Получайте прогресс и результат объекта видео Wan 3.0 в формате платформы.

Запрашивайте по публичному ID из ответа создания. Возвращается один объект video.

GET/v1/videos/{task_id}

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

bearerAuth

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

Используйте API Key платформы: Authorization: Bearer your-api-key.

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

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

task_id*string

Публичный ID задачи платформы. Сохраняйте строкой для получения и скачивания, не используйте request_id или вложенный ID поставщика.

Длина1 <= length

Тело ответа

`application/json`

curl -X GET "https://api.agtcloud.cn/v1/videos/TASK_ID" \
  -H "Authorization: Bearer your-api-key"

{
  "id": "task_example",
  "object": "video",
  "model": "wan3.0-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1792760030,
  "completed_at": 1792760030,
  "metadata": {
    "url": ""
  }
}

Статус и URL видео

`status`	Значение и действие
`queued`	В очереди; повторите запрос позже
`in_progress`	Обработка; повторите запрос позже
`completed`	Готово; прочитайте `metadata.url`
`failed`	Ошибка; прочитайте доступный `error` и прекратите опрос
`unknown`	Статус не распознан; не считайте успехом

Сохраните id: получение не зависит от избыточного task_id в ответе создания. Не определяйте успех по progress, completed_at или наличию error. completed_at отражает обновление записи; проверяйте status.

После успеха сохраните URL или используйте скачивание видео. Здесь нет нативных output/usage; поля использования доступны в нативном получении.

Опрос и обработка ошибок

Опрос выполняйте примерно каждые 15 секунд с общим тайм-аутом. Запросы читают сохранённые записи, поэтому частые обращения могут вернуть тот же статус. Остановка опроса не отменяет генерацию.

При HTTP 400 и task_not_exist проверьте сайт задачи и используйте API Key её владельца. При HTTP 401 сначала исправьте аутентификацию. Успех генерации определяется по status.

Официальная документация Alibaba Cloud по генерации видео Wan 3.0Справочник нативного протокола; платформенные поля и ответы описаны на этой странице.

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

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

Тело ответа

200application/json

400application/json

401application/json

Статус и URL видео

Опрос и обработка ошибок

`application/json`

`application/json`

`application/json`