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 分钟，结果如下：
json
{
"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 代码：
bash
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://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 字段以指定模板效果。我们提供了多种模板效果，具体效果如下图所示：
json
[
{
"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 代码：
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": 302325299651648,
"image_url": "https://cdn.acedata.cloud/n3r1mc.png"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)运行后，您将得到结果如下：
json
{
"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": ""
}
]
}可以看到，结果内容与视频模板效果一致，实现了通过模板效果生成视频的功能。
扩展视频生成功能
如果您想扩展已生成的 Pixverse 视频，可以将参数 action 设置为 extend，并输入要扩展的视频 ID。视频 ID 可以通过基本用法获得，如