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

Получайте нативный статус Wan 3.0, URL видео и использование.

Используйте output.task_id из создания. Возвращаемый output.task_id также публичный ID платформы. Результат и использование находятся в output и usage.

GET/api/v1/tasks/{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/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer your-api-key"

{
  "output": {
    "task_id": "task_example",
    "task_status": "PENDING"
  },
  "request_id": "REQUEST_ID"
}

Статусы и результаты

`output.task_status`	Значение и действие
`PENDING`	В очереди
`RUNNING`	Обработка
`SUCCEEDED`	Успех; прочитайте `output.video_url`
`FAILED`	Ошибка; прочитайте `output.code/message` и прекратите опрос
`CANCELED`	Отменено; прекратите опрос
`UNKNOWN`	Неизвестно; не считайте успехом

Опрашивайте примерно каждые 15 секунд с общим тайм-аутом. Записи платформы обновляются в фоне; получайте статус, не создавая задачу повторно.

Скачайте и сохраните видео сразу после готовности, до истечения ссылки.

usage.duration — суммарное время использования, включая вход и выход при наличии видео. input_video_duration/output_video_duration могут быть дробными; правило целочисленной длительности запроса к ним не применяется. Возможны video_count, fps, SR, ratio.

submit_time/scheduled_time/end_time — строки UTC+8, возвращаются при наличии, не Unix-время. request_id нужен для диагностики, не для поиска задачи.

Ошибки получения

При HTTP 400 и task_not_exist проверьте публичный ID, сайт и аккаунт API Key. Это отличается от статуса UNKNOWN. При HTTP 401 проверьте Bearer-аутентификацию.

Ответ ошибки может содержать только корневые code/message/request_id, без output. Для объекта video используйте получение платформы.

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

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

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

Тело ответа

200application/json

400application/json

401application/json

Статусы и результаты

Использование и время

Ошибки получения

`application/json`

`application/json`

`application/json`