> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Интеграция и использование Wan Tasks API

> Tongyi Wansiang Video Generation 集成指南 - XHuoAPI

Основная функция 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](https://api.xhuoapi.ai/documents/52b0f490-1bbf-4fe5-b60e-96626d333d2c) и подать заявку на соответствующую услугу, затем скопировать ID задачи Wan Videos Generation API, как показано на рисунке:

<p>
  <img src="https://cdn.xhuoapi.ai/om6p6g.png" width="500" className="m-auto" />
</p>

Наконец, перейдите на страницу Tasks API [Wan Tasks API](https://api.xhuoapi.ai/documents/240ef446-cbec-461c-a633-4a64178d7018) и подайте заявку на соответствующую услугу, после перехода на страницу нажмите кнопку «Acquire», как показано на рисунке:

![Страница заявки](https://cdn.xhuoapi.ai/rci31i.png)

Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на [страницу входа](https://api.xhuoapi.ai), где вас пригласят зарегистрироваться и войти в систему. После входа в систему вы будете автоматически возвращены на текущую страницу.

При первой подаче заявки предоставляется бесплатный лимит, который позволяет бесплатно использовать этот API.

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

Wan Tasks API можно использовать для запроса результатов Wan Videos Generation API. Для получения информации о том, как использовать Wan Videos Generation API, пожалуйста, обратитесь к документу [Wan Videos Generation API](https://api.xhuoapi.ai/documents/52b0f490-1bbf-4fe5-b60e-96626d333d2c).

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

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

<p>
  <img src="https://cdn.xhuoapi.ai/om6p6g.png" width="500" className="m-auto" />
</p>

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

**Request Headers** включает:

* `accept`: указывает на прием ответа в формате JSON, здесь указывается `application/json`.
* `authorization`: ключ для вызова API, который можно выбрать из выпадающего списка после подачи заявки.

**Request Body** включает:

* `id`: загруженный ID задачи.
* `action`: способ выполнения операции над задачей.

Настройка, как показано на рисунке:

<p>
  <img src="https://cdn.xhuoapi.ai/vr3hxw.png" width="500" className="m-auto" />
</p>

### Пример кода

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

<p>
  <img src="https://cdn.xhuoapi.ai/ehmsdi.png" width="500" className="m-auto" />
</p>

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

#### CURL

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/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

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/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 вернет информацию о деталях видео задачи. Например:

```json theme={null}
{
  "_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`: способ выполнения операции над задачей.

Настройка, как показано на рисунке:

<p>
  <img src="https://cdn.xhuoapi.ai/wlks1o.png" width="500" className="m-auto" />
</p>

### Пример кода

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

<p>
  <img src="https://cdn.xhuoapi.ai/5h1k8t.png" width="500" className="m-auto" />
</p>

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

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

После успешного запроса API вернет конкретную информацию о всех пакетных видео задачах. Например:

```json theme={null}
{
  "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

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/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`：Внутренняя ошибка сервера, что-то пошло не так на сервере.

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

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

## Заключение

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