简介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 的生成结果。我们将以任务 IDa4bca552-d964-46a1-8ff7-fd922f916582为例展示如何使用此 API。设置请求头与请求体请求头包括accept: 指定响应格式为 JSON设置为application/json。authorization: API 调用的密钥可以在申请后直接获取。请求体包括id: 上传的任务 ID。action: 任务的操作方法。请求示例设置如下图所示代码示例以下是使用 CURL 和 Python 调用 Wan Tasks API 的示例代码CURLcurl -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 }Pythonimport 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, jsonpayload, headersheaders) print(response.text)响应示例成功请求后API 将返回视频任务的详细信息。以下是一个成功响应的示例{ _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?Expires1769349278OSSAccessKeyIdLTAI5tKPD3TMqf2Lna1fASuhSignatureSjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D, state: completed } }批量查询操作如果需要查询多个任务 ID 的详细信息请将action设置为retrieve_batch。请求体包括ids: 上传任务 ID 的数组。action: 任务的操作方法。请求示例设置如下{ ids: [a4bca552-d964-46a1-8ff7-fd922f916582, 另一个任务ID], action: retrieve_batch }错误处理当调用 API 时如果发生错误API 将返回相应的错误代码和消息。例如400 token_mismatched: 请求错误可能由于缺少或无效参数。401 invalid_token: 未授权令牌无效或缺失。错误响应示例{ success: false, error: { code: api_error, message: fetch failed } }总结通过本文您已经学习了如何使用 Wan Tasks API 查询单个或批量视频任务的具体细节。我们希望本指南能帮助您更好地集成和使用此 API。如有任何疑问欢迎随时联系技术支持团队。详细文档 | API接口技术标签#WanTasksAPI #AceDataCloud #视频生成 #API使用 #开发者指南