Pixverse 任务 API 集成与使用

用户00045392116
4 阅读4分钟

在现代视频生成应用中，Pixverse 任务 API 是一个强大的工具，旨在通过输入由 Pixverse 视频生成 API 生成的任务 ID 来查询任务的执行状态。本文将详细介绍如何集成 Pixverse 任务 API，帮助开发者轻松获取任务状态，并充分利用这个 API 的强大功能。

背景介绍

Pixverse 是 Ace Data Cloud 提供的一个平台，专注于视频生成、处理和管理。通过其 API，用户可以生成视频、查询任务状态等。这些功能使得 Pixverse 成为内容创作者、广告商和开发者的理想选择。

申请使用

要使用 Pixverse 任务 API，首先需要在Pixverse 视频生成 API的申请页面申请相应的服务。申请后，您将获得一个任务 ID，这个 ID 在后续的 API 调用中将用于查询任务状态。

申请页面

如果您尚未注册或登录，系统会自动重定向您到登录页面。首次申请时，您可以享受免费的配额。

请求示例

Pixverse 任务 API 允许您查询 Pixverse 视频生成 API 的结果。有关如何使用 Pixverse 视频生成 API 的详细信息，请参考文档Pixverse 视频生成操作文档。

假设我们有一个任务 ID：e3d52b98-b944-438e-b122-1a9141b5626c，我们将展示如何使用这个 API 进行查询。

设置请求头和请求体

请求头包括：

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

请求体包括：

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

请求体的示例如下：

{
  "id": "e3d52b98-b944-438e-b122-1a9141b5626c",
  "action": "retrieve"
}

代码示例

以下是使用 cURL 和 Python 的代码示例：

cURL 示例

curl -X POST 'https://api.acedata.cloud/pixverse/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "e3d52b98-b944-438e-b122-1a9141b5626c",
  "action": "retrieve"
}'

Python 示例

import requests

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

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

payload = {
    "id": "e3d52b98-b944-438e-b122-1a9141b5626c",
    "action": "retrieve"
}

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

响应示例

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

{
  "_id": "6789f8ce550a4144a5a102e3",
  "id": "e3d52b98-b944-438e-b122-1a9141b5626c",
  "response": {
    "success": true,
    "task_id": "e3d52b98-b944-438e-b122-1a9141b5626c",
    "data": [
      {
        "video_url": "https://media.pixverse.ai/pixverse%2Fmp4%2Fmedia%2Fweb%2F2c8425c5-f772-4add-ad73-e9265f68e336_seed0.mp4",
        "duration": 5
      }
    ]
  }
}

批量查询操作

如果需要查询多个任务 ID 的详细信息，可以使用批量查询。此时，您需要将 action 设置为 retrieve_batch。

请求体示例如下：

{
  "ids": ["e3d52b98-b944-438e-b122-1a9141b5626c", "bb0b2c63-dbae-4536-97f7-aba9cd8c55fc"],
  "action": "retrieve_batch"
}

批量查询代码示例

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

cURL 示例

curl -X POST 'https://api.acedata.cloud/pixverse/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["e3d52b98-b944-438e-b122-1a9141b5626c", "bb0b2c63-dbae-4536-97f7-aba9cd8c55fc"],
  "action": "retrieve_batch"
}'

Python 示例

import requests

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

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

payload = {
    "ids": ["e3d52b98-b944-438e-b122-1a9141b5626c", "bb0b2c63-dbae-4536-97f7-aba9cd8c55fc"],
    "action": "retrieve_batch"
}

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

错误处理

在调用 API 时，如果出现错误，API 将返回相应的错误代码和消息。例如：

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

错误响应示例

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

总结

通过本文，您已了解如何使用 Pixverse 任务 API 查询单个或批量视频任务的详细信息。这将帮助您更好地集成和使用 API。如果您有任何问题，请随时联系技术支持团队。

技术标签：#Pixverse #API集成 #视频生成 #AceDataCloud #开发者工具

avatar
文章
阅读
粉丝