跳到内容

PixVerse ​

更新时间

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask

PixVerse 是视频生成模型,支持文生视频、首帧 / 首尾帧生视频,以及最多 7 张图片的多图参考生成(c1 另支持参考视频)。可同时生成音频并支持口型同步,输出 360P~1080P,时长 1~15 秒。

基本信息 ​

项目值
ModelNamePixVerse
ModelVersionv6 / v5.6 / c1(小写)
默认值ModelVersion=v6 / Resolution=1080P
支持解除护栏不支持

各版本支持规格 ​

版本分辨率比例时长
通用480P / 720P / 1080P / 2K / 4K——
c1360P / 540P / 720P / 1080P—1–15 秒
v6360P / 540P / 720P / 1080P—1–15 秒
v5.6360P / 540P / 720P / 1080P—5 / 8 / 10 秒;1080P 不含 10 秒

输入条件 ​

版本条件
c1参考 / 音频:图片最多 7 张,视频参考,音频同时生成
v6参考 / 音频:图片最多 7 张,音频同时生成
v5.6参考 / 音频:与 c1/v6 的参考 / 音频功能不同

请求参数 ​

参数必填类型说明
ModelName必填String固定值 PixVerse
ModelVersion可选Stringv6 / v5.6 / c1(小写)
Prompt必填String生成提示词
FileInfos.N可选Array参考输入。Usage 为 FirstFrame(首帧)或 Reference(参考)
OutputConfig.Resolution可选String480P / 720P / 1080P / 2K / 4K
OutputConfig.Duration可选Integer视频时长(秒)
OutputConfig.AspectRatio可选String16:9 / 9:16 / 1:1 等

请求示例 ​

json
{
  "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"
}

响应示例 ​

json
{
  "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 模式:指定台词与说话人 ​

json
{
  "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"
}

参考音频模式:输入音频文件 ​

json
{
  "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 的方式。

json
{
  "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 张。

json
{
  "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以背景为中心的参考
json
{
  "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自动选择
2Zhen Youyu
4外国男性
6Li Jie
10Jiang Jianghao
11Lao Sen
12Li Jieke
13Qian Duoduo
14Wang Xiaopai
16乡村大嗓门
18河南方言
19台湾腔
20陕西方言
21香港腔
json
{
  "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
尾帧 URL5MB 以下
参考图片最多 7 张

其他参数 ​

参数说明
NegativePrompt描述要从结果中排除的元素的提示词
EnhancePrompt提示词自动校正。Enabled / Disabled
Seed随机种子。取值相同时可复现结果
SessionContext原样传递到回调的值。最多 1000 字符
SessionId去重标识符。3 天 内相同 ID 的请求按既有请求为基准处理

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages