Pixverse 视频生成 API 对接说明

本文将介绍一种 Pixverse Videos Generation API 对接说明，它是可以通过输入自定义参数来生成Pixverse官方的视频。

申请和使用

要使用 Pixverse Videos Generation API，首先可以到 Pixverse Videos Generation API 页面点击「Acquire」按钮，获取请求所需要的凭证：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费使用该 API。

基本使用

可以根据提示词来生成视频，比如可以输入 quiver，如图所示：

生成的代码如下：

可以点击「Try」按钮直接测试 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、视频链接、视频清晰度、视频时长等内容。

字段说明如下：

• success：生成是否成功，如果成功则为 true，否则为 false
• task_id：此次生成任务的ID
• trace_id：此次生成任务的追踪ID
• data：是一个列表，包含了生成的视频的详细信息。
• id： 生成视频的唯一ID，后续可以根据此ID进行扩展生成
• first_frame：视频的首帧图片链接
• last_frame：视频的尾帧图片链接
• video_width：此次视频结果的宽度
• video_height：此次视频结果的长度
• prompt：此次视频生成任务的提示词
• model：此次视频生成任务采用的模型
• video_url：此次视频生成任务的视频链接
• template_id：视频采用的模版特效ID
• template_name：视频采用的模版特效名称
• asset_id：视频采用的角色ID
• asset_name：视频采用的角色名称
• style：此次视频生成任务的风格
• aspect_ratio：此次视频的尺寸大小
• extended：此次视频是否为扩展生成的，0为不是扩展生成的，反之为扩展生成的

自定义首尾帧生成视频

如果想自定义首尾帧生成视频，可以输入首尾帧图片链接：

这时候 frame 字段可以传入类似如下内容：

• 首帧图片

• 尾帧图片

接下来我们要根据歌词、标题、风格自定义生成歌曲，就可以指定如下内容：

• action：此次视频生成任务的行为，分为俩种：生成视频 action、扩展视频 extend
• prompt：此次视频生成任务的提示词。
• frame：此次视频生成的首尾帧视频链接数组。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的Shell代码：

python 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"] }'

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

自定义视频模板特效生成

如果想使用特定的视频模板特效来生成视频的话，我们只需要添加一个模板ID字段 template_id 来指定模板特效，我们提供了以下几个模板特效， 具体的模板特效如下图所示： json [ { "display_name": "Muscle Surge", "workflow_tag": "muscle_241128", "template_id": 308621408717184, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fwithbaby.gif", "thumbnail_video_path": "", "marker": "hot", "created_at": "2024-11-28T17:53:21Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "Show off your strong muscles and have everyone hooked.", "i18n_json": "{\"zh-CN\":{\"display_name\":\"成为肌肉猛男\",\"display_prompt\":\"体验猛男快乐\"}}", "example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Hug Your Love", "workflow_tag": "hug_love_241030", "template_id": 303624424723200, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fhug2.gif", "thumbnail_video_path": "", "marker": "hot", "created_at": "2024-10-31T12:07:47Z", "updated_at": "2025-01-06T05:32:42Z", "display_prompt": "Hug each other\t", "i18n_json": "{\"zh-CN\":{\"display_name\":\"爱的抱抱\",\"display_prompt\":\"互相拥抱在一起\"}}", "example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Alive Art", "workflow_tag": "alive_art_241028", "template_id": 302325299721280, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Faliveart.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-10-24T03:55:29Z", "updated_at": "2025-01-06T05:32:53Z", "display_prompt": "The [OBJECT] comes to life and walks out of the [SCENE]", "i18n_json": "{\"zh-CN\":{\"display_name\":\"活灵活现\",\"display_prompt\":\"它活了！\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Sheep Curls", "workflow_tag": "sheep_241208", "template_id": 310371322329472, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FSheepCurls.gif", "thumbnail_video_path": "", "marker": "new", "created_at": "2024-12-08T15:14:11Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "Change hairstyle for a better mood", "i18n_json": "{\"zh-CN\":{\"display_name\":\"万物皆可羊毛卷\",\"display_prompt\":\"心情不好，换个发型看看\"}}", "example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Sailor Moon", "workflow_tag": "meishaonv_241225", "template_id": 313359138372032, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fmeishaonv2.gif", "thumbnail_video_path": "", "marker": "", "created_at": "2024-12-25T12:29:05Z", "updated_at": "2025-01-06T05:32:33Z", "display_prompt": "Moon Prism Power, Make Up!", "i18n_json": "{\"zh-CN\":{\"display_name\":\"成为美少女战士\",\"display_prompt\":\"月之水晶力量，变身！\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Black Myth: Wukong", "workflow_tag": "heiwukong_241225", "template_id": 313359209531840, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fmonkey.gif", "thumbnail_video_path": "", "marker": "", "created_at": "2024-12-25T12:29:40Z", "updated_at": "2025-01-06T05:32:25Z", "display_prompt": "I am Sun Wukong, the Victorious Fighting Buddha!", "i18n_json": "{\"zh-CN\":{\"display_name\":\"黑悟空引擎\",\"display_prompt\":\"放马西行，直面天命！\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Santa's Secret Gifts", "workflow_tag": "santa_gift_241213", "template_id": 311521768592256, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fgift111.gif", "thumbnail_video_path": "", "marker": "new", "created_at": "2024-12-15T03:16:32Z", "updated_at": "2024-12-30T06:08:16Z", "display_prompt": "I want a：", "i18n_json": "{\"zh-CN\":{\"display_name\":\"圣诞礼物盲盒\",\"display_prompt\":\"我想要：\"}}", "example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Where is Santa?", "workflow_tag": "where_is_santa_241213", "template_id": 311521879229312, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fwheresanta.gif", "thumbnail_video_path": "", "marker": "new", "created_at": "2024-12-15T03:17:26Z", "updated_at": "2024-12-30T06:08:24Z", "display_prompt": "Discovering Santa Claus in the parallel world!", "i18n_json": "{\"zh-CN\":{\"display_name\":\"圣诞老人藏在哪？\",\"display_prompt\":\"“发现”世界各处的圣诞老人\"}}", "example_list": "[{\"img_id\":119280295,\"img_url\":\"https://media.pixverse.ai/upload%2Fde34a072-325e-4d86-88d9-2daef292e1b4.jpeg\"},{\"img_id\":119280616,\"img_url\":\"https://media.pixverse.ai/upload%2F5b4da0a2-86c3-4204-adda-74bfa7c3d0d1.jpg\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Christmas OOTD", "workflow_tag": "tobe_santa_241219", "template_id": 312314911869312, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fbesanta33.gif", "thumbnail_video_path": "", "marker": "new", "created_at": "2024-12-19T14:51:09Z", "updated_at": "2024-12-30T06:08:08Z", "display_prompt": "Dress up as a Christmas star", "i18n_json": "{\"zh-CN\":{\"display_name\":\"圣诞战袍\",\"display_prompt\":\"测测什么圣诞装适合你\"}}", "example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "We Are Venom!", "workflow_tag": "venom_241030", "template_id": 303624537709312, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FWeAreVenom.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-10-31T12:08:42Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "Transform into a [BLACK] Venom", "i18n_json": "{\"zh-CN\":{\"display_name\":\"毒液变身！\",\"display_prompt\":\"变身成为【黑色】毒液\"}}", "example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]", "qualities": [ "360p", "540p" ] }, { "display_name": "Hot Harley Quinn", "workflow_tag": "harley_quinn_241121", "template_id": 307489434436288, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FHotHarleyQuinn.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-22T08:21:19Z", "updated_at": "2024-12-26T07:40:43Z", "display_prompt": "Transform into Harley Quinn, mastering allure and chaos", "i18n_json": "{\"zh-CN\":{\"display_name\":\"小丑女哈莉·奎茵变身\",\"display_prompt\":\"化身小丑女哈莉·奎茵，掌控魅惑与疯狂\"}}", "example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113742000,\"img_url\":\"https://media.pixverse.ai/upload%2F19090035-612e-40ed-9c8d-a7aaf781d492.png\"},{\"img_id\":113742074,\"img_url\":\"https://media.pixverse.ai/upload%2F50ed9020-7b58-4dd9-aa39-ff06b9e0df12.png\"}]", "qualities": [ "360p", "540p" ] }, { "display_name": "Crazy Cat Woman", "workflow_tag": "cat_woman_241121", "template_id": 307489548427968, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FCrazyCatWoman.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-22T08:22:15Z", "updated_at": "2024-12-26T07:40:24Z", "display_prompt": "Transform into a Crazy Cat Woman and slay", "i18n_json": "{\"zh-CN\":{\"display_name\":\"疯狂猫女变身\",\"display_prompt\":\"变身妖娆猫女，撩翻全场！\"}}", "example_list": "[{\"img_id\":113742074,\"img_url\":\"https://media.pixverse.ai/upload%2F50ed9020-7b58-4dd9-aa39-ff06b9e0df12.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]", "qualities": [ "360p", "540p" ] }, { "display_name": "Wonder Woman", "workflow_tag": "wonder_woman_241202", "template_id": 309283958194560, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FWonderWoman.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-12-02T11:45:11Z", "updated_at": "2024-12-26T07:40:35Z", "display_prompt": "Transform into Wonder Woman and conquer the impossible", "i18n_json": "{\"zh-CN\":{\"display_name\":\"神奇女侠变身\",\"display_prompt\":\"成为神奇女侠，征服一切不可能\"}}", "example_list": "[{\"img_id\":113742074,\"img_url\":\"https://media.pixverse.ai/upload%2F50ed9020-7b58-4dd9-aa39-ff06b9e0df12.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]", "qualities": [ "360p", "540p" ] }, { "display_name": "Hulk", "workflow_tag": "hulk_241106", "template_id": 304826314164992, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2FHulk.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-07T07:08:47Z", "updated_at": "2024-12-26T07:38:48Z", "display_prompt": "Unleash the Beast", "i18n_json": "{\"zh-CN\":{\"display_name\":\"召唤绿巨人\",\"display_prompt\":\"变身成绿巨人并捶爆一切\"}}", "example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Joker's Rebirth", "workflow_tag": "joker_241106", "template_id": 304826126435072, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_joker.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-07T07:07:16Z", "updated_at": "2024-12-26T07:38:54Z", "display_prompt": "Transform into a Joker", "i18n_json": "{\"zh-CN\":{\"display_name\":\"小丑重生\",\"display_prompt\":\"变身成小丑，诡异地微笑\"}}", "example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Batman", "workflow_tag": "bat_man_241106", "template_id": 304826374632192, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_batman.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-07T07:09:17Z", "updated_at": "2024-12-26T07:39:00Z", "display_prompt": "Transform into a Batman and embrace the night", "i18n_json": "{\"zh-CN\":{\"display_name\":\"蝙蝠侠归来\",\"display_prompt\":\"变身成蝙蝠侠并守护黑夜\"}}", "example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Iron Man", "workflow_tag": "iron_man_241106", "template_id": 304826054394624, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_ironman.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-07T07:06:40Z", "updated_at": "2024-12-26T07:39:06Z", "display_prompt": "Activate Iron Mode", "i18n_json": "{\"zh-CN\":{\"display_name\":\"钢铁侠变身\",\"display_prompt\":\"激活钢铁模式\"}}", "example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Hair Growth Magic", "workflow_tag": "hair_magic_241128", "template_id": 308552687706496, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_hairgrowth.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-28T08:34:06Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "Grow lots of hair. Never be bald.", "i18n_json": "{\"zh-CN\":{\"display_name\":\"发量王者\",\"display_prompt\":\"长出迷人秀发，永无秃头困扰。\"}}", "example_list": "[{\"img_id\":113750602,\"img_url\":\"https://media.pixverse.ai/upload%2F920dc791-8c9f-4518-8761-82958a827190.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"},{\"img_id\":113750791,\"img_url\":\"https://media.pixverse.ai/upload%2Ff2853009-8238-4e0f-93ec-cfc68fee28b7.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "COLORFUL Venom!", "workflow_tag": "random_venom_241104", "template_id": 304358279051648, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_colorfulvenom.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-04T15:39:54Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "Transform into a [COLORFUL] Venom", "i18n_json": "{\"zh-CN\":{\"display_name\":\"毒液！(彩色盲盒版)\",\"display_prompt\":\"变身成为【彩色】毒液\"}}", "example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]", "qualities": [ "360p", "540p" ] }, { "display_name": "Who is Venom?", "workflow_tag": "who_is_venom_241112", "template_id": 305714097668480, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_whoisvenom.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-12T07:33:35Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "Which one of you guys is Venom? ", "i18n_json": "{\"zh-CN\":{\"display_name\":\"测测谁是毒液？\",\"display_prompt\":\"两人之中，必有一毒，速速现出原形\"}}", "example_list": "[{\"img_id\":111917190,\"img_url\":\"https://media.pixverse.ai/upload%2F6a6a0f6a-99be-4eac-83a1-9d265ca65823.png\"},{\"img_id\":111917753,\"img_url\":\"https://media.pixverse.ai/upload%2F079945d6-01aa-4688-9e9a-02e308c01db5.png\"},{\"img_id\":111917942,\"img_url\":\"https://media.pixverse.ai/upload%2F814307ed-4123-4f6b-a32e-4072b55378cb.png\"}]", "qualities": [ "360p", "540p" ] }, { "display_name": "Get a Venom buddy", "workflow_tag": "baby_venom_241114", "template_id": 306059795500352, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_venombuddy.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-14T06:26:53Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "Your Venom buddy appears and gives you a hug", "i18n_json": "{\"zh-CN\":{\"display_name\":\"召唤毒液兄弟\",\"display_prompt\":\"你的毒液兄弟回到你身边，并与你深情相拥\"}}", "example_list": "[{\"img_id\":113741803,\"img_url\":\"https://media.pixverse.ai/upload%2Fb2626bc2-050d-4ea6-a864-e2054c012df5.png\"},{\"img_id\":113750690,\"img_url\":\"https://media.pixverse.ai/upload%2Fddd29e75-beeb-461c-9388-3e14c2709e73.png\"}]", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Wicked Shots", "workflow_tag": "wicked_paintings_241028", "template_id": 303788802773760, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_wickedshot.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-11-01T10:25:30Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "The [SUBJECT] in the picture smiles wickedly and starts firing", "i18n_json": "{\"zh-CN\":{\"display_name\":\"扫射一切\",\"display_prompt\":\"邪魅一笑，并掏出一把机关枪开始扫射\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Squish It", "workflow_tag": "squish_it_241028", "template_id": 302325299692608, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_squishit.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-10-24T03:55:29Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "A pair of hands appears and squishes the [OBJECT] as if it's slime", "i18n_json": "{\"zh-CN\":{\"display_name\":\"捏捏更解压\",\"display_prompt\":\"变成可以捏捏的软泥\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Lego Blast", "workflow_tag": "lego_blast_241028", "template_id": 302325299702848, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_legoblast.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-10-24T03:55:29Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "The [OBJECT] shatters into pieces of Legos", "i18n_json": "{\"zh-CN\":{\"display_name\":\"乐高大爆炸\",\"display_prompt\":\"爆炸并碎裂成一片片乐高积木\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Leggy Run", "workflow_tag": "leggy_run_241028", "template_id": 302325299711040, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_leggyrun.gif", "thumbnail_video_path": "", "marker": "hot", "created_at": "2024-10-24T03:55:29Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "The [OBJECT] grows legs and runs away", "i18n_json": "{\"zh-CN\":{\"display_name\":\"全员腿精\",\"display_prompt\":\"长出了一双腿然后开始乱跑\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Monster Invades", "workflow_tag": "monster_invasion_241028", "template_id": 302325299682368, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_monster.gif", "thumbnail_video_path": "", "marker": "default", "created_at": "2024-10-24T03:55:29Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "A monster suddenly appears in the [SCENE] and starts walking around", "i18n_json": "{\"zh-CN\":{\"display_name\":\"怪兽入侵\",\"display_prompt\":\"场景中突然出现了一只怪兽\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Wizard Hat", "workflow_tag": "animal_wizard_241028", "template_id": 302325299661888, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_wizardhat.gif", "thumbnail_video_path": "", "marker": "hot", "created_at": "2024-10-24T03:55:29Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "The [SUBJECT] wears a magic wizard hat", "i18n_json": "{\"zh-CN\":{\"display_name\":\"戴上魔法帽\",\"display_prompt\":\"头顶出现了一顶可爱的魔法帽\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Zombie Hand", "workflow_tag": "zombie_hand_241028", "template_id": 302325299672128, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_weirdhand.gif", "thumbnail_video_path": "", "marker": "hot", "created_at": "2024-10-24T03:55:29Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "A zombie hand appears in the [SCENE]", "i18n_json": "{\"zh-CN\":{\"display_name\":\"僵尸手出没\",\"display_prompt\":\"从图片中的场景中钻出一只僵尸的手\"}}", "example_list": "", "qualities": [ "360p", "540p", "720p", "1080p" ] }, { "display_name": "Zombie Mode", "workflow_tag": "zombie_mode_241028", "template_id": 302325299651648, "thumbnail_path": "https://media.pixverse.ai/asset%2Ftemplate%2Fcapcut_zombiemode.gif", "thumbnail_video_path": "", "marker": "hot", "created_at": "2024-10-24T03:55:29Z", "updated_at": "2024-12-25T10:19:28Z", "display_prompt": "The [SUBJECT] suddenly transforms into a zombie.", "i18n_json": "{\"zh-CN\":{\"display_name\":\"坏了，我变僵尸了\",\"display_prompt\":\"突然变成僵尸\"}}", "example_list": "", "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 的获取是根据基本使用来获取，如下图所示：

这时候可以看到视频的 ID 为：

"id": 317989274748288

注意，这里的视频中 id 是生成后视频的 ID，如果你不知道如何生成视频，可以参考上文的基本使用来生成视频。

接下来我们要必须填歌词、风格自定义生成歌曲，就可以指定如下内容：

• action：此次视频生成任务的行为，一般有普通生成 generate 和扩展视频 extend。
• prompt：此次视频生成的提示词。
• video_id：此次扩展视频任务的参考视频ID。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的 Python 代码：

```python import requests

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

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

payload = { "action": "extend", "prompt": "A group of people began to dance", "video_id": 317989274748288 }

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

点击运行，可以发现会得到一个结果，如下：

json { "success": true, "task_id": "38b6d70d-eea2-40da-9f8b-945df93e831b", "trace_id": "b105bbb6-faf1-4d86-9c10-4b8a8e638d05", "data": [ { "id": 318162960027008, "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%2F2368ad8b-81dc-4a2f-9b6c-e0ac205351f9_seed0.mp4", "template_id": 0, "template_name": "", "style": "", "aspect_ratio": "16:9", "duration": 5, "extended": 1, "last_frame": "", "seed": 0, "asset_id": 0, "asset_name": "" } ] }

可以看出，结果内容与上文的是一致的，这也就实现视频的扩展生成功能。

自定义角色生成视频

如果想对根据一张图片角色来生成视频的话，需要额外输入根据图片创建的角色
ID字段 asset_id，字段 asset_id 的获取是使用 Pixverse Character API来获取，具体的结果如下图所示：

当生成角色ID之后就可以按照基本使用来生成视频了，这里以 asset_id= 318174747147968 为示例，下面是具体的参数：

点击运行后可以生成自定义角色的视频结果，具体的结果如下图所示：

json { "success": true, "task_id": "d39994c7-53ba-4c3f-ae8f-44287c487d51", "trace_id": "32da3212-2d4c-4302-87ef-01ecb903a92b", "data": [ { "id": 318175009783232, "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%2F61d477e4-3dab-4322-962d-18980b4e6f8c_seed0.mp4", "template_id": 0, "template_name": "", "style": "", "aspect_ratio": "16:9", "duration": 5, "extended": 0, "last_frame": "", "seed": 0, "asset_id": 318174747147968, "asset_name": "my-46169546-a9c0-4437-96ee-a9750bbd489f" } ] }

生成的结果与上文类似，这就完成了按照角色来生成视频的过程。

目前所支持的特效模板

模版id以及对应的效果：

| 模版id | 效果 | |----------------|-----------------------| | 321958627120000 | AI发对象咯 | | 324641581197696 | 一起摇摆！ | | 324641385496960 | 360°旋转微波炉 | | 325367418993728 | 樱花乌托邦 | | 325501134629952 | 北极熊出没！ | | 315447659476032 | 不打不相识 | | 324640938615168 | 万物皆可毛绒玩具 | | 308621408717184 | 成为肌肉猛男 | | 313358700761536 | 万物皆可变形金刚 | | 316645675647872 | 雪茄大佬 | | 321956810449792 | 奥斯卡影帝 | | 323578865822784 | 性别转换器 | | 303624424723200 | 爱的抱抱 | | 313555098280384 | 换上比基尼 | | 313649491716544 | 猛虎的抱抱 | | 313649622731200 | 天使之翼 | | 316826014376384 | 拥抱耶稣 | | 315446315336768 | 爱的亲亲 | | 322852853601344 | 万物皆可走红毯 | | 304826314164992 | 绿巨人变身 | | 315447659476032 | 黑悟空引擎 | | 313359138372032 | 成为美少女战士 | | 308552687706496 | 发量王者 | | 307489548427968 | 疯狂猫女变身 | | 304826126435072 | 小丑重生 | | 304826374632192 | 蝙蝠侠归来 | | 304358279051648 | 毒液！(彩色盲盒版) | | 304826054394624 | 钢铁侠变身 | | 317013509917440 | 新年战裙 | | 313358844899776 | 做自己的财神 | | 313359048325568 | 蛇年的第一个贴贴 | | 307489434436288 | 小丑女哈莉·奎茵变身 | | 311521768592256 | 圣诞礼物盲盒 | | 311521879229312 | 圣诞老人藏在哪？ | | 312314911869312 | 圣诞战袍 | | 306059795500352 | 召唤毒液兄弟 | | 303788802773760 | 扫射一切 | | 302325299702848 | 乐高大爆炸 | | 302325299682368 | 怪兽入侵 | | 302325299661888 | 戴上魔法帽 | | 302325299651648 | 坏了，我变僵尸了 | | 302325299672128 | 僵尸手出没 |

风格：

| 动作模式 | 效果 | |----------|----------| | normal | 普通模式 | | fast | 性能模式 |

运镜

| 参数 | 效果 | |-------------------|--------------| | horizontal_left | 水平向左 | | horizontal_right | 水平向右 | | vertical_up | 垂直向上 | | vertical_down | 垂直向下 | | crane_up | 上升镜头 | | hitchcock | 希区柯克变焦 | | zoom_in | 放大 | | zoom_out | 缩小 | | quickly_zoom_in | 快速推进 | | quickly_zoom_out | 快速拉远 | | smooth_zoom_in | 平滑推进 | | super_dolly_out | 超级拉远 | | left_follow | 左侧跟拍 | | right_follow | 右侧跟拍 | | pan_left | 左侧环弧 | | pan_right | 右侧环弧 | | fix_bg | 固定镜头 | | camera_rotation | 镜头旋转 | | robo_arm | 机械臂运动 | | whip_pan | 快速摇镜 |

异步回调

由于 Pixverse 生成音乐的时间相对较长，大约需要 1-2 分钟，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。

整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成音乐的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。

下面我们通过示例来了解下具体怎样操作。

首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：

将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/8dc4cd74-4f4c-49ab-95c8-fa503cca5534。

接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入 prompt，如图所示：

点击运行，可以发现会立即得到一个结果，如下：

{ "task_id": "84acf7e2-66a7-407a-8295-f0cc7a58579b" }

稍等片刻，我们可以在 https://webhook.site/8dc4cd74-4f4c-49ab-95c8-fa503cca5534 上观察到生成歌曲的结果，如图所示：

内容如下：

json { "success": true, "task_id": "84acf7e2-66a7-407a-8295-f0cc7a58579b", "trace_id": "a4b9b5d5-10fe-4a8e-8cd4-642056908fe8", "data": [ { "id": 318175621179584, "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%2Ff1739bd1-a005-48f8-8464-0b6e4ba7b071_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": "" } ] }

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。

错误处理

如果发生错误，您将得到类似如下的错误信息：

json { "success": false, "error": { "code": "forbidden", "message": "Song Description contained artist name: eminem" }, "trace_id": "9bb7c2f4-3b7b-4965-b50a-f663874b1b6f", "task_id": "9bb3a2a6-c438-436d-a9f3-fa466abc077c" }