Wan Tasks API 集成与使用指南

简介

Wan Tasks API 是 Ace Data Cloud 提供的一项功能强大的服务，允许开发者通过输入任务 ID 来查询视频生成任务的执行状态。这项 API 主要用于与 Wan Videos Generation API 配合使用，帮助用户获取视频生成任务的实时信息，确保用户能够高效地管理和监控其视频生成流程。

环境准备/前置条件

在开始使用 Wan Tasks API 之前，您需要完成以下步骤：

申请使用 Wan Videos Generation API 服务。
获取对应的任务 ID，该任务 ID 是通过 Wan Videos Generation API 生成的。
登录您的 Ace Data Cloud 账户。

详细步骤

申请 API 服务

首先，您需要访问 Wan Videos Generation API 的申请页面，申请相应的服务。完成申请后，复制生成的任务 ID，如下图所示：

接下来，访问 Wan Tasks API 页面，点击"获取"按钮，进行 API 服务的申请：

如果您尚未登录系统，系统会自动引导您到登录页面，请注册或登录您的账户。首次申请用户可享受免费配额。

请求示例

Wan Tasks API 允许您查询 Wan Videos Generation API 的生成结果。我们将以任务 ID a4bca552-d964-46a1-8ff7-fd922f916582 为例，展示如何使用此 API。

设置请求头与请求体

请求头包括：

accept: 指定响应格式为 JSON，设置为 application/json。
authorization: API 调用的密钥，可以在申请后直接获取。

请求体包括：

id: 上传的任务 ID。
action: 任务的操作方法。

请求示例设置如下图所示：

代码示例

以下是使用 CURL 和 Python 调用 Wan Tasks API 的示例代码：

CURL

bash 复制代码

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

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 将返回视频任务的详细信息。以下是一个成功响应的示例：

json 复制代码

{
  "_id": "6974ce81ff2676299c399252",
  "id": "a4bca552-d964-46a1-8ff7-fd922f916582",
  "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"
  }
}

批量查询操作

如果需要查询多个任务 ID 的详细信息，请将 action 设置为 retrieve_batch。

请求体包括：

ids: 上传任务 ID 的数组。
action: 任务的操作方法。

请求示例设置如下：

json 复制代码

{
  "ids": ["a4bca552-d964-46a1-8ff7-fd922f916582", "另一个任务ID"],
  "action": "retrieve_batch"
}

错误处理

当调用 API 时，如果发生错误，API 将返回相应的错误代码和消息。例如：

400 token_mismatched: 请求错误，可能由于缺少或无效参数。
401 invalid_token: 未授权，令牌无效或缺失。

错误响应示例

json 复制代码

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  }
}

总结

通过本文，您已经学习了如何使用 Wan Tasks API 查询单个或批量视频任务的具体细节。我们希望本指南能帮助您更好地集成和使用此 API。如有任何疑问，欢迎随时联系技术支持团队。

详细文档 | API接口

技术标签：#WanTasksAPI #AceDataCloud #视频生成 #API使用 #开发者指南