Pixverse视频生成API集成教程与最佳实践

这里先梳理几个核心要点：Pixverse 视频生成 API 允许你根据自定义参数生成官方品质的视频，功能覆盖社交媒体内容、营销视频、娱乐项目等多种场景。对于创作者来说，这相当于直接拿到了一个强大的视频生成工具箱。

背景

Pixverse 本身是一个数据云平台，它提供了多种数据处理和生成的 API，目的是帮助开发者快速搭建应用。而这次要说的视频生成 API，则让用户能通过简单的请求，就能产出高质量的视频内容——不用自己去啃复杂的渲染引擎。

如何使用 Pixverse 视频生成 API

开始之前，需要先拿到调用钥匙。访问 Pixverse 视频生成 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 就能在应用里展示视频。

自定义视频的首尾帧

如果想自定义视频的第一帧和最后一帧，可以直接输入首尾帧图像的 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 在灵活性和功能上都给开发者留了足够的操作空间。用好它，就能轻松制作出高质量、有创意的视频内容。