Получить задачу · Прежний формат

Получайте задачи Wan 3.0 в прежнем формате ответа.

Путь возвращает прежний объект в code/message/data. Для новых интеграций предпочтительно получение платформы; структуры невзаимозаменяемы.

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

{
  "code": "success",
  "message": "",
  "data": {
    "created_at": 1792760030,
    "updated_at": 1792760030,
    "task_id": "task_example",
    "status": "NOT_START",
    "fail_reason": "",
    "submit_time": 1792760030,
    "start_time": 0,
    "finish_time": 0,
    "progress": "0%",
    "data": {
      "request_id": "REQUEST_ID",
      "output": {
        "task_id": "upstream_task_example",
        "task_status": "PENDING"
      }
    }
  }
}

Чтение прежнего результата

code: "success" означает только успех запроса; проверьте data.status:

Статус	Значение
`NOT_START/SUBMITTED/QUEUED`	Не начато, отправлено или в очереди
`IN_PROGRESS`	Обработка
`SUCCESS`	Успех; прочитайте `data.result_url`
`FAILURE`	Ошибка; прочитайте `data.fail_reason` и прекратите опрос

data.progress — строка, например "100%", в отличие от числового прогресса платформы. created_at/updated_at/submit_time/start_time/finish_time — Unix-время в секундах; до начала или завершения соответствующее время может быть 0. Примеры содержат поля задачи; фактический ответ может включать другие.

Получение и скачивание выполняются по публичному ID создания, здесь это data.task_id. data.data содержит нативный ответ; его ID не используется для запросов или скачивания платформы.

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

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

HTTP 400 task_not_exist и HTTP 401 — ошибки запроса, не обычные статусы задачи. Проверьте ID, сайт и API Key до обработки данных.

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

Получить задачу · Прежний формат

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

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

Тело ответа

200application/json

400application/json

401application/json

Чтение прежнего результата

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

`application/json`

`application/json`

`application/json`