Перейти к основному содержанию
Основная функция Wan Tasks API заключается в том, чтобы запрашивать статус выполнения задачи, используя ID задачи, сгенерированный Wan Videos Generation API. В этом документе подробно описывается интеграция Wan Tasks API, чтобы помочь вам легко интегрировать и в полной мере использовать мощные функции этого API. С помощью Wan Tasks API вы можете легко запрашивать статус выполнения задач Wan Videos Generation API.

​
Процесс подачи заявки

Чтобы использовать Wan Tasks API, сначала необходимо перейти на страницу заявки Wan Videos Generation API и подать заявку на соответствующую услугу, затем скопировать ID задачи Wan Videos Generation API, как показано на рисунке:

Наконец, перейдите на страницу Tasks API Wan Tasks API и подайте заявку на соответствующую услугу, после перехода на страницу нажмите кнопку «Acquire», как показано на рисунке: Страница заявки Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на страницу входа, где вас пригласят зарегистрироваться и войти в систему. После входа в систему вы будете автоматически возвращены на текущую страницу. При первой подаче заявки предоставляется бесплатный лимит, который позволяет бесплатно использовать этот API.

​
Пример запроса

Wan Tasks API можно использовать для запроса результатов Wan Videos Generation API. Для получения информации о том, как использовать Wan Videos Generation API, пожалуйста, обратитесь к документу Wan Videos Generation API. Мы возьмем один из ID задач, возвращенных службой Wan Videos Generation API, в качестве примера, чтобы продемонстрировать, как использовать этот API. Предположим, у нас есть ID задачи: a4bca552-d964-46a1-8ff7-fd922f916582, далее мы покажем, как передать этот ID задачи.

​
Пример задачи

​
Установка заголовков запроса и тела запроса

Request Headers включает:
  • accept: указывает на прием ответа в формате JSON, здесь указывается application/json.
  • authorization: ключ для вызова API, который можно выбрать из выпадающего списка после подачи заявки.
Request Body включает:
  • id: загруженный ID задачи.
  • action: способ выполнения операции над задачей.
Настройка, как показано на рисунке:

​
Пример кода

Можно заметить, что на правой стороне страницы автоматически сгенерирован код на различных языках, как показано на рисунке:

Некоторые примеры кода:

​
CURL

curl -X POST 'https://api.acedata.cloud/wan/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
  "action": "retrieve"
}'

​
Python

import requests

url = "https://api.acedata.cloud/wan/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
Пример ответа

После успешного запроса API вернет информацию о деталях видео задачи. Например: 
{
  "_id": "6974ce81ff2676299c399252",
  "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
  "api_id": "6a4ecdbf-b219-4505-8277-5ec4b1ac14f8",
  "application_id": "52933893-8e8b-4cd6-b9e5-2354eedea000",
  "created_at": 1769262721.763,
  "credential_id": "c7173d71-d234-413e-ab72-7bfa6715d12f",
  "request": {
    "action": "text2video",
    "model": "wan2.6-t2v",
    "prompt": "Астронавты перемещаются из космоса к вулкану",
    "duration": 5
  },
  "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac",
  "type": "videos",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "job_id": "0d2042f9-ba8d-496d-8ab5-182617e28f9e",
  "response": {
    "success": true,
    "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/1d/db/20260124/da477ba2/0d2042f9-ba8d-496d-8ab5-182617e28f9e.mp4?Expires=1769349278&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=SjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D",
    "state": "completed",
    "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582"
  },
  "duration": 787.3310000896454,
  "finished_at": 1769263509.094
}
Возвращаемый результат содержит несколько полей, поле request — это тело запроса, отправленного для создания задачи, а поле response — это тело ответа, возвращенное после завершения задачи. Описание полей:
  • id: ID, сгенерированный для этой видео задачи, используется для уникальной идентификации этой задачи по созданию видео.
  • request: информация о запросе в видео задаче.
  • response: информация о возвращаемом ответе в видео задаче.

​
Пакетный запрос

Это запрос для получения деталей видео задач по нескольким ID задач, в отличие от предыдущего, здесь необходимо выбрать action как retrieve_batch. Request Body включает:
  • ids: массив загруженных ID задач.
  • action: способ выполнения операции над задачей.
Настройка, как показано на рисунке:

​
Пример кода

Можно заметить, что на правой стороне страницы автоматически сгенерирован код на различных языках, как показано на рисунке:

Некоторые примеры кода:

​
Пример ответа

После успешного запроса API вернет конкретную информацию о всех пакетных видео задачах. Например: 
{
  "items": [
    {
      "_id": "6974ce81ff2676299c399252",
      "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
      "api_id": "6a4ecdbf-b219-4505-8277-5ec4b1ac14f8",
      "application_id": "52933893-8e8b-4cd6-b9e5-2354eedea000",
      "created_at": 1769262721.763,
      "credential_id": "c7173d71-d234-413e-ab72-7bfa6715d12f",
      "request": {
        "action": "text2video",
        "model": "wan2.6-t2v",
        "prompt": "Астронавты перемещаются из космоса к вулкану",
        "duration": 5
      },
      "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "job_id": "0d2042f9-ba8d-496d-8ab5-182617e28f9e",
      "response": {
        "success": true,
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/1d/db/20260124/da477ba2/0d2042f9-ba8d-496d-8ab5-182617e28f9e.mp4?Expires=1769349278&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=SjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D",
        "state": "завершено",
        "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582"
      },
      "duration": 787.3310000896454,
      "finished_at": 1769263509.094
    },
    {
      "_id": "6974ce81ff2676299c399252",
      "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
      "api_id": "6a4ecdbf-b219-4505-8277-5ec4b1ac14f8",
      "application_id": "52933893-8e8b-4cd6-b9e5-2354eedea000",
      "created_at": 1769262721.763,
      "credential_id": "c7173d71-d234-413e-ab72-7bfa6715d12f",
      "request": {
        "action": "text2video",
        "model": "wan2.6-t2v",
        "prompt": "Астронавты перемещаются из космоса к вулкану",
        "duration": 5
      },
      "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "job_id": "0d2042f9-ba8d-496d-8ab5-182617e28f9e",
      "response": {
        "success": true,
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/1d/db/20260124/da477ba2/0d2042f9-ba8d-496d-8ab5-182617e28f9e.mp4?Expires=1769349278&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=SjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D",
        "state": "завершено",
        "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582"
      },
      "duration": 787.3310000896454,
      "finished_at": 1769263509.094
    }
  ],
  "count": 2
}
返回结果一共有多个字段，其中items是包含了批量视频任务的具体详情信息，每个视频任务的具体信息与上文的字段一样，字段信息如下。
  • items，批量视频任务的所有具体详情信息。它是一个数组，每个数组的元素 и上文查询单个任务的返回结果格式是一样的。
  • count，此处批量查询视频任务的个数。

​
CURL

curl -X POST 'https://api.acedata.cloud/wan/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["a4bca552-d964-46a1-8ff7-fd922f916582","a4bca552-d964-46a1-8ff7-fd922f916582"],
  "action": "retrieve_batch"
}'

​
Ошибки

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：
  • 400 token_mismatched：Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
  • 400 api_not_implemented：Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
  • 401 invalid_token：Неавторизован, недействительный или отсутствующий токен авторизации.
  • 429 too_many_requests：Слишком много запросов, вы превысили лимит частоты.
  • 500 api_error：Внутренняя ошибка сервера, что-то пошло не так на сервере.

​
Пример ошибки

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "не удалось получить"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Заключение

通过本文档，您已经了解了如何使用 Wan Tasks API 进行查询单个或批量视频任务的所有具体详情信息。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。