Veo Tasks API 的对接和使用Veo Tasks API 的主要功能是通过输入 Veo Videos Generation API 生成的任务ID来查询该任务的执行情况。本文档将详细介绍 Veo Tasks API 的对接说明帮助您轻松集成并充分利用该 API 的强大功能。通过 Veo Tasks API 您可以轻松实现查询 Veo Videos Generation API 的任务执行情况。申请流程要使用 Veo Tasks API需要先到 申请页面 Veo Videos Generation API 申请相应的服务然后复制 Veo Videos Generation API的任务ID如图所示最后进入Tasks API页面 [Veo Tasks API ](https://platform.acedata.cloud/documents/52778f8b-93ce-4db3-a62c-bcf0a92e5f3c?inviter_id5467b179-223f-42ef-b91e-c6e5a133ce9c)申请相应的服务进入页面之后点击「Acquire」按钮如图所示如果您尚未登录或注册会自动跳转到登录页面邀请您来注册和登录登录注册之后会自动返回当前页面。首次申请时会有免费额度赠送可以免费使用该 API。请求示例Veo Tasks API 可以用于查询 Veo Videos Generation API 的结果。关于怎样使用 Veo Videos Generation API请参考文档 Veo Videos Generation API 。我们以 Veo Videos Generation API 服务返回的任务ID一个为例演示如何使用该 API。假设我们有一个任务ID1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed接下来演示如何通过传入一个任务ID来。任务示例图### 设置请求头和请求体Request Headers包括accept指定接收 JSON 格式的响应结果这里填写为application/json。authorization调用 API 的密钥申请之后可以直接下拉选择。Request Body包括id上传的任务ID。action对任务的操作方式。设置如下图所示### 代码示例可以发现在页面右侧已经自动生成了各种语言的代码如图所示部分代码示例如下CURLcurl-XPOSThttps://api.acedata.cloud/veo/tasks\-Haccept: application/json\-Hauthorization: Bearer {token}\-Hcontent-type: application/json\-d{ id: 1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed, action: retrieve }Pythonimportrequests urlhttps://api.acedata.cloud/veo/tasksheaders{accept:application/json,authorization:Bearer {token},content-type:application/json}payload{id:1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed,action:retrieve}responserequests.post(url,jsonpayload,headersheaders)print(response.text)响应示例请求成功后API 将返回此处视频任务的详情信息。例如{_id:68834c16550a4144a5112589,id:1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed,api_id:52a0fa83-3c78-4793-b45a-c1a5c869ae46,application_id:b7341df0-3a87-40ef-8f3c-a7dda97816a2,created_at:1753435158.509,credential_id:1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae,request:{callback_url:https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc,action:text2video,model:veo2,prompt:White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle.},trace_id:d1d53c04-58c5-4c40-bb63-f00188540e56,type:videos,user_id:ad7afe47-cea9-4cda-980f-2ad8810e51cf,response:{success:true,task_id:1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed,trace_id:d1d53c04-58c5-4c40-bb63-f00188540e56,data:[{id:2f43ceed37944b4d836e1a1899dad0a1,video_url:https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4,created_at:2025-07-25 17:19:20,complete_at:2025-07-25 17:21:45,state:succeeded}]}}返回结果一共有多个字段request 字段就是发起任务时的 request body同时response 字段是任务完成后返回的response body。字段介绍如下。id生成此视频任务的 ID用于唯一标识此次视频生成任务。request查询视频任务中的请求信息。response查询视频任务中的返回信息。批量查询操作这是是针对多个任务ID来进行查询视频任务详情与上面不同的是需要将action选中为retrieve_batchRequest Body包括ids上传的任务ID数组。action对任务的操作方式。设置如下图所示### 代码示例可以发现在页面右侧已经自动生成了各种语言的代码如图所示部分代码示例如下CURLcurl-XPOSThttps://api.acedata.cloud/veo/tasks\-Haccept: application/json\-Hauthorization: Bearer {token}\-Hcontent-type: application/json\-d{ ids: [1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed,1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed], action: retrieve_batch }响应示例请求成功后API 将返回此次所有批量视频任务的具体详情信息。例如{items:[{_id:68834c16550a4144a5112589,id:1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed,api_id:52a0fa83-3c78-4793-b45a-c1a5c869ae46,application_id:b7341df0-3a87-40ef-8f3c-a7dda97816a2,created_at:1753435158.509,credential_id:1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae,request:{callback_url:https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc,action:text2video,model:veo2,prompt:White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle.},trace_id:d1d53c04-58c5-4c40-bb63-f00188540e56,type:videos,user_id:ad7afe47-cea9-4cda-980f-2ad8810e51cf,response:{success:true,task_id:1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed,trace_id:d1d53c04-58c5-4c40-bb63-f00188540e56,data:[{id:2f43ceed37944b4d836e1a1899dad0a1,video_url:https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4,created_at:2025-07-25 17:19:20,complete_at:2025-07-25 17:21:45,state:succeeded}]}},{_id:68834c16550a4144a5112589,id:1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed,api_id:52a0fa83-3c78-4793-b45a-c1a5c869ae46,application_id:b7341df0-3a87-40ef-8f3c-a7dda97816a2,created_at:1753435158.509,credential_id:1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae,request:{callback_url:https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc,action:text2video,model:veo2,prompt:White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle.},trace_id:d1d53c04-58c5-4c40-bb63-f00188540e56,type:videos,user_id:ad7afe47-cea9-4cda-980f-2ad8810e51cf,response:{success:true,task_id:1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed,trace_id:d1d53c04-58c5-4c40-bb63-f00188540e56,data:[{id:2f43ceed37944b4d836e1a1899dad0a1,video_url:https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4,created_at:2025-07-25 17:19:20,complete_at:2025-07-25 17:21:45,state:succeeded}]}}],count:2}返回结果一共有多个字段其中items是包含了批量视频任务的具体详情信息每个视频任务的具体信息与上文的字段一样字段信息如下。items批量视频任务的所有具体详情信息。它是一个数组每个数组的元素和上文查询单个任务的返回结果格式是一样的。count此处批量查询视频任务的个数。错误处理在调用 API 时如果遇到错误API 会返回相应的错误代码和信息。例如400 token_mismatchedBad request, possibly due to missing or invalid parameters.400 api_not_implementedBad request, possibly due to missing or invalid parameters.401 invalid_tokenUnauthorized, invalid or missing authorization token.429 too_many_requestsToo many requests, you have exceeded the rate limit.500 api_errorInternal server error, something went wrong on the server.错误响应示例{success:false,error:{code:api_error,message:fetch failed},trace_id:2cf86e86-22a4-46e1-ac2f-032c0f2a4e89}结论通过本文档您已经了解了如何使用 Veo Tasks API 进行查询单个或批量视频任务的所有具体详情信息。希望本文档能帮助您更好地对接和使用该 API。如有任何问题请随时联系我们的技术支持团队。ess: false,“error”: {“code”: “api_error”,“message”: “fetch failed”},“trace_id”: “2cf86e86-22a4-46e1-ac2f-032c0f2a4e89”}## 结论 通过本文档您已经了解了如何使用 Veo Tasks API 进行查询单个或批量视频任务的所有具体详情信息。希望本文档能帮助您更好地对接和使用该 API。如有任何问题请随时联系我们的技术支持团队。