Veo Tasks API 的集成与使用

简介

Veo Tasks API 是 Ace Data Cloud 提供的一个强大接口，主要用于查询由 Veo Videos Generation API 生成的任务执行状态。通过这个 API，开发者可以轻松地获取视频生成任务的执行结果，从而优化视频处理流程。在本文中，我们将详细介绍如何集成 Veo Tasks API，并提供具体的代码示例，帮助你快速上手。

环境准备/前置条件

在使用 Veo Tasks API 之前，请确保你已完成以下准备工作：

1. 访问 Veo Videos Generation API 页面并申请相应服务。
2. 获取由 Veo Videos Generation API 生成的任务 ID。
3. 访问 Veo Tasks API 页面申请服务。

以下是任务 ID 的获取界面示例：

在申请服务后，点击页面上的“Acquire”按钮，如下图所示：

如果未登录系统，你将被重定向到 登录页面，完成注册或登录后将返回申请页面。首次申请可享受免费的配额。

详细步骤

请求示例

使用 Veo Tasks API 查询 Veo Videos Generation API 的结果时，我们以任务 ID 1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed 为例，演示如何传入任务 ID。

设置请求头和请求体

请求头包括：

• accept: 指定响应格式为 JSON，设置为 application/json。
• authorization: 用于调用 API 的密钥。

请求体包括：

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

设置示例如下：

代码示例

你可以在页面右侧看到自动生成的多种语言代码示例：

以下是 CURL 和 Python 的代码示例：

CURL 示例

curl -X POST 'https://api.acedata.cloud/veo/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
  "action": "retrieve"
}'

Python 示例

import requests

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

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

payload = {
    "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
    "action": "retrieve"
}

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

响应示例

成功请求后，API 将返回视频任务的详细信息。例如：

{
  "_id": "68834c16550a4144a5112589",
  "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
  "response": {
    "success": true,
    "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
    "data": [
      {
        "video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
        "state": "succeeded"
      }
    ]
  }
}

返回的结果包括多个字段，其中 request 字段为任务发起时的请求体，response 字段为任务完成后的返回信息。

批量查询操作

若要查询多个任务 ID 的视频任务详细信息，需将 action 设置为 retrieve_batch。

请求体包括：

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

代码示例

以下是 CURL 的批量查询示例：

curl -X POST 'https://api.acedata.cloud/veo/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"],
  "action": "retrieve_batch"
}'

错误处理

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

• 400 token_mismatched: 请求错误，可能是缺少或无效的参数。
• 401 invalid_token: 未授权，令牌无效或缺失。
• 429 too_many_requests: 请求过多，超过速率限制。

错误响应示例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

总结

通过本文，你已经学习了如何使用 Veo Tasks API 查询单个或批量视频任务的详细信息。希望本教程能帮助你更好地集成和使用这一 API。如有任何问题，请随时联系技术支持团队。

技术标签：#VeoTasksAPI #AceDataCloud #视频处理 #API集成 #Python