当前位置：首页 > news >正文

Pixverse 视频生成 API 集成指南

news 2026/5/27 13:17:32

Pixverse 视频生成 API 集成指南

简介

本文将为您介绍 Pixverse 视频生成 API 的集成指南，您可以通过输入自定义参数来生成官方的 Pixverse 视频。Pixverse 是一个强大的数据云平台，提供了多种视频生成的功能，非常适合需要快速制作视频内容的开发者和创作者。

环境准备/前置条件

在开始之前，您需要：

注册并登录 Pixverse 视频生成 API。
获取 API 访问凭证。

详细步骤

获取 API 凭证

首先，访问 Pixverse 视频生成 API 页面，并点击“获取”按钮以获取请求所需的凭证：

如果您尚未注册或登录，系统将自动重定向到登录页面。完成登录或注册后，您将返回当前页面。

首次申请时，您将获得免费的配额，可以免费使用该 API。

基本用法

您可以根据提示生成视频。例如，您可以输入quiver，如下图所示：

生成的代码如下：

主要请求参数说明：

model: 视频生成模型，默认值为v3.5。
action: 视频生成的动作，默认值为generate，可选extend。
prompt: 视频生成的提示（必填）。
style: 可选的视频风格。
motion: 动作模式，默认值为正常。
quality: 视频清晰度，默认值为540p。
duration: 视频时长，默认值为 5 秒。
image_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_width":0,"video_height":0,"prompt":"quiver","model":"v3.5","quality":"360p","motion":"normal","video_url":"https://media.pixverse.ai/pixverse%2Fmp4%2Fmedia%2Fweb%2F77e48783-3dc9-48ab-84a0-0e310ff9b83d_seed0.mp4","template_id":0,"template_name":"","style":"","aspect_ratio":"16:9","duration":5,"extended":0,"last_frame":"","seed":0,"asset_id":0,"asset_name":""}]}

在此，您已获取到视频的内容，包括视频 ID、视频链接、视频清晰度、视频时长等详细信息。

自定义首尾帧视频生成

如果您想自定义视频的首尾帧，可以输入首尾帧图像的链接：

首帧图像
尾帧图像

接下来，您需要根据歌词、标题和风格自定义生成的歌曲，指定以下内容：

action: 视频生成任务的动作，可以是生成视频generate或扩展视频extend。
prompt: 视频生成任务的提示。
frame: 首尾帧的视频链接数组。

填写后的示例：

生成的代码如下：

相应的 Shell 代码：

curl-XPOST'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://img-home.csdnimg.cn/images/20230724024159.png?origin_url=https%3A%2F%2Fcdn.acedata.cloud%2Fc7zzmb.png&pos_id=img-npZInjTE-1779789688157)","https://img-home.csdnimg.cn/images/20230724024159.png?origin_url=https%3A%2F%2Fcdn.acedata.cloud%2Ffqd8br.png&pos_id=img-BMJty3AS-1779789688683)"] }'

测试是允许的，生成的效果类似。

使用特定视频模板效果生成视频

如果您想使用特定的视频模板效果生成视频，只需添加template_id字段以指定模板效果。我们提供了多种模板效果，具体效果如下图所示：

[{"display_name":"Muscle Surge","workflow_tag":"muscle_241128","template_id":308621408717184,"thumbnail_path":"https://media.pixverse.ai/asset%2Ftemplate%2Fwithbaby.gif","qualities":["360p","540p","720p","1080p"]},// 其他模板...]

您可以选择一个template_id来生成视频。以302325299651648为例，生成视频的参数与基本用法相似，具体参数如下：

填写后，自动生成的代码如下：

相应的 Python 代码：

importrequests 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":302325299651648,"image_url":"https://cdn.acedata.cloud/n3r1mc.png"}response=requests.post(url,json=payload,headers=headers)print(response.text)

运行后，您将得到结果如下：

{"success":true,"task_id":"cf127eee-d23d-44c9-945c-793e68f86720","trace_id":"aa7ed21d-8363-4eeb-a46a-a120e31b4fde","data":[{"id":318162170958272,"first_frame":"","video_width":0,"video_height":0,"prompt":"A group of people began to dance","model":"v3.5","quality":"360p","motion":"normal","video_url":"https://media.pixverse.ai/pixverse%2Fmp4%2Fmedia%2Fweb%2F18d7fef6-2e59-48a5-a655-046464f34603_seed0.mp4","template_id":302325299651648,"template_name":"Zombie Mode","style":"","aspect_ratio":"16:9","duration":5,"extended":0,"last_frame":"","seed":0,"asset_id":0,"asset_name":""}]}