PixVerse
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask
PixVerse 是视频生成模型,支持文生视频、首帧 / 首尾帧生视频,以及最多 7 张图片的多图参考生成(c1 另支持参考视频)。可同时生成音频并支持口型同步,输出 360P~1080P,时长 1~15 秒。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | PixVerse |
| ModelVersion | v6 / v5.6 / c1(小写) |
| 默认值 | ModelVersion=v6 / Resolution=1080P |
| 支持解除护栏 | 不支持 |
各版本支持规格
| 版本 | 分辨率 | 比例 | 时长 |
|---|---|---|---|
| 通用 | 480P / 720P / 1080P / 2K / 4K | — | — |
c1 | 360P / 540P / 720P / 1080P | — | 1–15 秒 |
v6 | 360P / 540P / 720P / 1080P | — | 1–15 秒 |
v5.6 | 360P / 540P / 720P / 1080P | — | 5 / 8 / 10 秒;1080P 不含 10 秒 |
输入条件
| 版本 | 条件 |
|---|---|
c1 | 参考 / 音频:图片最多 7 张,视频参考,音频同时生成 |
v6 | 参考 / 音频:图片最多 7 张,音频同时生成 |
v5.6 | 参考 / 音频:与 c1/v6 的参考 / 音频功能不同 |
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 PixVerse |
ModelVersion | 可选 | String | v6 / v5.6 / c1(小写) |
Prompt | 必填 | String | 生成提示词 |
FileInfos.N | 可选 | Array | 参考输入。Usage 为 FirstFrame(首帧)或 Reference(参考) |
OutputConfig.Resolution | 可选 | String | 480P / 720P / 1080P / 2K / 4K |
OutputConfig.Duration | 可选 | Integer | 视频时长(秒) |
OutputConfig.AspectRatio | 可选 | String | 16:9 / 9:16 / 1:1 等 |
请求示例
{
"SubAppId": 123456789,
"ModelName": "PixVerse",
"ModelVersion": "v6",
"Prompt": "a calm sunset over the ocean, cinematic",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}响应示例
{
"AigcVideoTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
"ExpireTime": "2026-08-01T10:29:48Z",
"MetaData": {
"Width": 1920,
"Height": 1080,
"Duration": 5.07,
"Container": "mov,mp4,m4a",
"Bitrate": 9494850
}
}
]
}
}
}特殊设置
Lip Sync(口型同步)
为人物说话的源视频添加口型同步。用 SceneType=lip_sync 指定,语音可用两种模式指定。
TTS 模式:指定台词与说话人
{
"SubAppId": 123456789,
"ModelName": "PixVerse",
"ModelVersion": "lip_sync",
"SceneType": "lip_sync",
"Prompt": "talking",
"FileInfos": [
{
"Type": "Url",
"Category": "Video",
"Url": "https://<cdn>/talking_head.mp4"
}
],
"ExtInfo": "{\"AdditionalParameters\":\"{\\\"lip_sync_tts_content\\\":\\\"你好,很高兴见到你。\\\",\\\"lip_sync_tts_speaker_id\\\":\\\"14\\\"}\"}",
"OutputConfig": {
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}参考音频模式:输入音频文件
{
"SubAppId": 123456789,
"ModelName": "PixVerse",
"ModelVersion": "lip_sync",
"SceneType": "lip_sync",
"Prompt": "talking",
"FileInfos": [
{
"Type": "Url",
"Category": "Video",
"Url": "https://<cdn>/talking_head.mp4"
},
{
"Type": "Url",
"Category": "Audio",
"Url": "https://<cdn>/voice.mp3"
}
],
"OutputConfig": {
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}源视频请使用公开 URL
源视频 URL 必须是外部可访问的公开 URL。预设说话人大多以中文说话人为基准,因此韩语台词建议使用参考音频模式。
版本选择
| ModelVersion | 特点 |
|---|---|
c1 | 最新版本。角色一致性最好,支持参考视频输入与口型同步 |
v6 | 通用高画质版本 |
v5.6 | 上一代稳定版本。视频时长可从 5 / 8 / 10 秒 中选择 |
c1 与 v6 为 1~15 秒,v5.6 仅支持 5 / 8 / 10 秒。
指定首帧与尾帧
用 FileInfos.N.Usage 区分首帧与尾帧。建议使用 LastFrame 的方式。
{
"SubAppId": 123456789,
"ModelName": "PixVerse",
"ModelVersion": "v6",
"Prompt": "Smooth transition",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Url": "https://<cos>/first.jpg",
"Usage": "FirstFrame"
},
{
"Type": "Url",
"Category": "Image",
"Url": "https://<cos>/last.jpg",
"Usage": "LastFrame"
}
],
"OutputConfig": {
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}Usage | 含义 |
|---|---|
FirstFrame | 首帧 |
LastFrame | 尾帧 |
Reference | 参考图片 |
尾帧有两种方式
以 FileInfos.Usage=LastFrame 的方式为基准。顶层 LastFrameUrl 出于向下兼容也可用,但新实现请使用 Usage=LastFrame。尾帧 URL 须在 5MB 以下。
多图参考(Text / @Name)
为每张参考图片用 Text 命名,并在提示词中以 @Name 指定。图片最多 7 张。
{
"SubAppId": 123456789,
"ModelName": "PixVerse",
"ModelVersion": "c1",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Url": "https://<cos>/character.png",
"Text": "hero",
"Usage": "Reference"
},
{
"Type": "Url",
"Category": "Image",
"Url": "https://<cos>/fan.jpg",
"Text": "fan",
"Usage": "Reference"
},
{
"Type": "Url",
"Category": "Image",
"Url": "https://<cos>/earring.jpg",
"Text": "earring",
"Usage": "Reference"
}
],
"Prompt": "the woman in @hero slowly raises her hand and opens the @fan, while the @earring sways gently as she turns her head",
"OutputConfig": {
"Duration": 8,
"AspectRatio": "3:4",
"AudioGeneration": "Enabled",
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}@Name 之后必须加空格
像 @hero runs 这样,参考对象名称后要留空格。请让提示词中的名称与 Text 的值保持一致,名称用英文 / 数字书写。
参考类型(ReferenceType)
为 Category=Video 的条目指定 ReferenceType 以确定参考的性质。适用于 GV、Kling、PixVerse。
| 值 | 含义 |
|---|---|
subject | 以被摄主体为中心的参考 |
background | 以背景为中心的参考 |
{
"SubAppId": 123456789,
"ModelName": "PixVerse",
"ModelVersion": "v5.6",
"FileInfos": [
{
"Type": "Url",
"Category": "Video",
"Url": "https://<cos>/source.mp4",
"ReferenceType": "subject"
}
],
"Prompt": "change the color of the main character's dress to white",
"OutputConfig": {
"StorageMode": "Permanent",
"MediaName": "PixVerse-video-edit"
},
"SessionContext": "job-001"
}口型同步(lip_sync)
同时指定 ModelVersion=lip_sync 与 SceneType=lip_sync。语音用音频文件或 TTS 指定。
预设说话人列表
在 ExtInfo 的 lip_sync_tts_speaker_id 中指定下列值之一。最新列表可通过 PixVerse TTS 音色查询 API 确认。
| speaker_id | 说明 |
|---|---|
Auto | 自动选择 |
2 | Zhen Youyu |
4 | 外国男性 |
6 | Li Jie |
10 | Jiang Jianghao |
11 | Lao Sen |
12 | Li Jieke |
13 | Qian Duoduo |
14 | Wang Xiaopai |
16 | 乡村大嗓门 |
18 | 河南方言 |
19 | 台湾腔 |
20 | 陕西方言 |
21 | 香港腔 |
{
"SubAppId": 123456789,
"ModelName": "PixVerse",
"ModelVersion": "lip_sync",
"SceneType": "lip_sync",
"FileInfos": [
{
"Type": "Url",
"Category": "Video",
"Url": "https://<cos>/talking_head.mp4"
}
],
"Prompt": "dancing",
"ExtInfo": "{\"AdditionalParameters\": \"{\\\"lip_sync_tts_content\\\": \\\"lets dance and sing with me\\\", \\\"lip_sync_tts_speaker_id\\\": \\\"2\\\"}\"}",
"OutputConfig": {
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}ExtInfo.AdditionalParameters 字段:
| 字段 | 说明 |
|---|---|
lip_sync_tts_content | 要匹配口型的台词 |
lip_sync_tts_speaker_id | 预设说话人 ID |
输入规格
| 项目 | 限制 |
|---|---|
| 图片大小 | 10MB 以下 |
| 图片格式 | jpeg / jpg / png |
| 尾帧 URL | 5MB 以下 |
| 参考图片 | 最多 7 张 |
其他参数
| 参数 | 说明 |
|---|---|
NegativePrompt | 描述要从结果中排除的元素的提示词 |
EnhancePrompt | 提示词自动校正。Enabled / Disabled |
Seed | 随机种子。取值相同时可复现结果 |
SessionContext | 原样传递到回调的值。最多 1000 字符 |
SessionId | 去重标识符。3 天 内相同 ID 的请求按既有请求为基准处理 |