Pixverse 视频生成 API 集成指南

0 阅读3分钟

在本文中,我们将介绍如何集成 Pixverse 视频生成 API,该 API 支持根据自定义参数生成官方 Pixverse 视频。这为创作者提供了强大的视频生成工具,适用于多种应用场景,如社交媒体内容、营销视频和娱乐项目等。

背景

Pixverse 是一个强大的数据云平台,提供多种数据处理和生成的 API,帮助开发者快速构建应用。借助 Pixverse 视频生成 API,用户可以通过简单的请求生成高质量的视频内容。

如何使用 Pixverse 视频生成 API

首先,您需要访问 Pixverse 视频生成 API 页面,点击“获取”按钮以获取请求所需的凭据。

获取凭据

如果您尚未登录或注册,系统会自动重定向您到登录页面。完成登录后,您将返回到当前页面。首次申请该 API 时会提供免费的配额,您可以免费使用该 API。

基本用法

您可以根据提示生成视频。例如,输入quiver,生成的代码如下所示:

视频生成示例

在请求中,主要参数包括:

  • model: 生成视频的模型,默认值为 v3.5
  • action: 生成视频的操作,默认值为 generate,可选择 extend
  • prompt: 生成视频的提示(必填)。
  • style: 可选的视频风格。
  • motion: 动作模式,默认值为正常。
  • quality: 视频清晰度,默认值为 540p
  • duration: 视频时长,5 或 8 秒,默认值为 5。
  • image_url: 参考图像的 URL,选填。
  • aspect_ratio: 纵横比,默认值为 16:9
  • seed: 可选,固定的随机种子。
  • template_id: 可选,指定模板效果。
  • callback_url: 回调结果的 URL。

点击“尝试”按钮后,您可以直接测试 API,等待 1-2 分钟,结果如下:

{
  "success": true,
  "task_id": "69e677ca-f1de-419f-99a4-cb39ea0cb5fc",
  "trace_id": "e544f904-ac13-4b42-a26e-2de69d9ac06b",
  "data": [
    {
      "id": 317982208110208,
      "first_frame": "",
      "video_url": "https://media.pixverse.ai/pixverse%2Fmp4%2Fmedia%2Fweb%2F77e48783-3dc9-48ab-84a0-0e310ff9b83d_seed0.mp4",
      "quality": "360p",
      "duration": 5
    }
  ]
}

获取到视频内容后,您可以利用返回的 video_url 在应用中展示视频。

自定义视频的首尾帧

如果您希望自定义视频的首尾帧,可以输入首尾帧图像的链接。frame 字段可以接受如下内容:

  • 首帧图像 首帧图像
  • 尾帧图像 尾帧图像

接下来,我们需要根据歌词、标题和风格自定义歌曲生成,指定以下内容:

{
  "action": "generate",
  "prompt": "gradation",
  "frame": ["https://cdn.acedata.cloud/c7zzmb.png", "https://cdn.acedata.cloud/fqd8br.png"]
}

对应的 Shell 代码为:

curl -X POST 'https://api.acedata.cloud/pixverse/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "prompt": "gradation",
  "frame": ["https://cdn.acedata.cloud/c7zzmb.png","https://cdn.acedata.cloud/fqd8br.png"]
}'

测试后,您可以获得相似的生成效果。

使用自定义视频模板效果生成视频

要使用特定的视频模板效果生成视频,只需在请求中添加 template_id 字段以指定模板效果。例如,您可以选择以下模板效果:

{
    "display_name": "Muscle Surge",
    "template_id": 308621408717184
}

然后,您可以使用如下参数生成视频:

{
  "action": "generate",
  "prompt": "A group of people began to dance",
  "template_id": 308621408717184
}

相应的 Python 代码如下:

import requests

url = "https://api.acedata.cloud/pixverse/videos"
headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}
payload = {
    "action": "generate",
    "prompt": "A group of people began to dance",
    "template_id": 308621408717184
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)

运行后,您会得到生成的视频链接,方便在应用中使用。

总结

通过以上步骤,您将能够成功集成并使用 Pixverse 视频生成 API。无论是生成简单的视频还是使用复杂的模板效果,该 API 都为开发者提供了灵活的接口和丰富的功能。使用这些工具,您可以轻松创建出高质量的创意视频内容。

对于更多的 API 详情,请访问 Ace Data Cloud

技术标签

  • #API集成
  • #视频生成
  • #Pixverse
  • #数据云
  • #开发者工具