跳至正文
EN
获取 API Key
☰

PixVerse V6 API 接入文档

使用 VezAPI 密钥接入 PixVerse V6。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

PixVerse V6 视频扩展

POST/api/v1/jobs/createTask

模型标识： pixverse-v6/extend

参数类型说明与限制
model
必填		string

生成任务的模型名称。必填字段。

可选值："pixverse-v6/extend"

默认："pixverse-v6/extend"

callBackUrl
可选		string

用于在生成任务完成时接收通知的回调 URL。选填，但建议在生产环境中使用。 - 任务生成后，系统将通过 POST 请求将任务状态和结果推送到此 URL - 回调内容包括生成内容的 URL 和任务相关信息 - 您的回调 API 必须支持 POST 请求和 JSON 格式的请求体 - 或者，您可以通过调用任务详情 API 主动轮询任务状态

input
必填		object
请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "pixverse-v6/extend",
  "input": {
    "prompt": "A cat walking on the beach at sunset",
    "duration": 5,
    "quality": "1080p",
    "seed": 42,
    "taskId": "task_abc123456"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

PixVerse V6 图生视频

POST/api/v1/jobs/createTask

模型标识： pixverse-v6/image-to-video

参数类型说明与限制
model
必填		string

生成任务的模型名称。必填字段。

可选值："pixverse-v6/image-to-video"

默认："pixverse-v6/image-to-video"

callBackUrl
可选		string

用于在生成任务完成时接收通知的回调 URL。选填，但建议在生产环境中使用。 - 任务生成后，系统将通过 POST 请求将任务状态和结果推送到此 URL - 回调内容包括生成内容的 URL 和任务相关信息 - 您的回调 API 必须支持 POST 请求和 JSON 格式的请求体 - 或者，您可以通过调用任务详情 API 主动轮询任务状态

input
必填		object

生成任务的输入参数

input.prompt
必填		string

生成提示词，不能为空，长度限制为 3–5000 个字符

minLength: 3

maxLength: 5000

input.image_urls
必填		array

不使用模板时传 1 张图（作为首帧）；使用模板时按模板的 effect_type 传 1 或 2 张。单张图片大小不超过 20 MB。支持 HTTP、HTTPS 和 OSS 地址，图片格式支持 JPG、JPEG、PNG 和 WebP。

maxItems: 2

input.quality
必填		string

必填。清晰度。

可选值："360p", "540p", "720p", "1080p"

input.duration
必填		integer

生成视频时长，单位为秒，范围为 1–15。未传入 template_id 时必填；传入 template_id 后，视频时长由所选模板固定，请勿同时传入该参数。

minimum: 1

maximum: 15

input.generate_audio_switch
可选		boolean

是否生成音频。

默认：false

input.generate_multi_clip_switch
可选		boolean

是否启用 PixVerse V6 multi-clip。

默认：false

input.seed
可选		integer

随机种子，可选。范围 0-2147483647。

minimum: 0

maximum: 2147483647

input.template_id
可选		string

用于选择 PixVerse 视频特效模板，请传入对应的 template_id。传入 template_id 后，视频时长将由所选模板固定，不能同时设置 duration。effect_type 表示该模板要求传入的图片数量，请按对应数量上传图片。如需预览模板效果，请在浏览器中打开 [see VezAPI documentation]<template_id>.mp4，并将 <template_id> 替换为实际的模板 ID。例如：[see VezAPI documentation] 可用模板列表： 412736208886848 - 跃入爱的深蓝 - 让每一个吻都化作一场梦。 - effect_type: 2 411563216524736 - 天际轨道旗帜 - 坚定不移。接下来是城市级入场特效。 - effect_type: 1 411316927927040 - Vibe Copines：氛围闺蜜 - 与 tungtung 一起拿捏这份氛围。 - effect_type: 1 411174903569216 - 人群焦点 - 第一视角：镜头捕捉到你了——上传自拍或合照，成为全场焦点 - effect_type: 1 410999246341952 - 戳戳我的小可爱 - 捏捏这个小家伙，看它变得萌萌地生气。 - effect_type: 1 408891141511104 - 今天是我的生日 - 是的，我知道你不认识我，但今天是我的生日 - effect_type: 1 410317363057408 - 迷你足球英雄 - 将任何照片变成迷你Q版足球英雄，在电影般的超写实体育场中与巨型球员同场竞技。 - effect_type: 1 410285445698304 - 熔岩崛起 - 从灰烬中崛起。以火攻火。 - effect_type: 1 410133101388544 - 赛博装甲：雨中重生 🌧️⚡ - 粉碎风暴。唤醒体内的钢铁之躯。 - effect_type: 1 409899296377728 - 产品地标 - 上传你的产品，把它变成一座建筑！ - effect_type: 1 408897485909952 - 迷你足球场 - 上传您的产品，在产品中创建迷你足球场！ - effect_type: 1 408869061406656 - 一脚穿越世界 - 上传您的产品，让它在一年一度的全球盛大比赛之夜闪耀登场！ - effect_type: 1 408661207662528 - 小镇足球家 - 上传您的产品，享受胜利的时刻！ - effect_type: 1 409767750265728 - 一战封神 - 你意外地成为了比赛的MVP。 - effect_type: 1 409766559675264 - 惊悚舞步 - 上传照片，观看它变成病毒式传播的标志性舞蹈潮流！ - effect_type: 1 409589071559552 - 戴戴舞 - 氛围助威舞模板。一张正面照，轻松加入舞场片段。 - effect_type: 1 407804339389760 - 切绒小厨 - 上传你的产品，在毛茸茸厨房里烹饪吧 - effect_type: 1 407658863287616 - 夏日明信片 - 上传你的产品，加入夏日特辑！ - effect_type: 1 407474361215744 - 吸入产品宇宙 - 上传您的产品，进入产品宇宙！ - effect_type: 1 407473438360320 - 毛茸茸工厂 - 上传您的产品，在毛茸茸工厂中制作 - effect_type: 1 407467702283008 - 逐浪夏日 - 上传你的产品照片，开始冲浪！ - effect_type: 1 385844572217469 - 爱之发射器 - 一次拍摄中的情人节时刻。 - effect_type: 1 406428904874432 - 猫咪小铺 - 上传你的商品图，让可爱的猫咪变身你的街头小贩！ - effect_type: 1 406423682060736 - 庭院焕新趴 - 上传你的庭院，给它一个魔法般的改造吧！ - effect_type: 1 406411724685760 - 滑雪乐 - 上传一张你的宠物、玩具或产品的照片，让它开启一段有趣的滑雪冒险。 - effect_type: 1 406372274350528 - 美甲实验室 - 上传您的美甲照片，让我们的专属美甲师为您打造精致美甲。 - effect_type: 1 406218913317312 - 节奏冲刺 - 卡准律动，摘下王冠。欢迎来到满分狂潮。 - effect_type: 1 406218479198656 - 荧幕绝杀王 - 球场需要英雄。于是，你穿透屏幕破壁而入。 - effect_type: 1 406064763308480 - 动态足球海报 - 一张自拍到球衣照（单人与多人） - effect_type: 1 406413607395776 - 足球直播王！ - 在您打出精彩进球的瞬间，超级跑车礼物倾泻而下。 - effect_type: 1 405662117814720 - 奖杯突破 - 上传你的照片，化身冠军足球选手，突破屏幕，赢得奖杯！ - effect_type: 1 406014934000064 - 赛后锐评 - 如果赛后将麦克风交给你，你会说什么？ - effect_type: 1 405658369331648 - 球场传奇 - 奔跑、庆祝，创造一个传奇的足球时刻。 - effect_type: 1 405321470423488 - 一步一步来 - 循序渐进，自信闪耀 - effect_type: 1 405175211454656 - 超级明星大厅 - 欢迎来到你的冠军赛季。 - effect_type: 1 404955806201792 - 赛后锐评 - 如果赛后采访轮到你，你会怎么评价这场比赛？ - effect_type: 1 404820147974080 - 世界之巅 - 高举奖杯，成为足球盛宴当之无愧的英雄。 - effect_type: 2 398980393937856 - 最后的拥抱 - 海啸来临前的最后一个拥抱。 - effect_type: 2 403916646846400 - 我的未来无限可能 - 拥抱你无限的潜能，闪耀前程。 - effect_type: 1 403739217192896 - Apex Dance - 平躺节奏，颓废风混乱舞步 - effect_type: 1 403560060358144 - 爱豆ending镜头 - 一抬眼就是百万直拍的程度。 - effect_type: 1 403556618212098 - 摩托GP直播 - 直播一个无法编排的时刻。 - effect_type: 1 398965022284579 - 膝滑 - 用标志性和充满活力的膝滑进球庆祝胜利。 - effect_type: 1 402201060373270 - 通往队长的隧道 - 在电影般的体育场旅程中，从一个普通女孩转变为传奇足球队长。 - effect_type: 1 403085292466285 - 金色场地破坏者 - 他不在名单上，但他依然掌控了场面。 - effect_type: 1 402061828030966 - 奖杯庆祝 - 你一直想要一个巨大的奖杯吗？在这里，你至少可以以数字形式获得它。 - effect_type: 1 402888569901524 - 跳入人群 2 - 跳入人群 - effect_type: 1 402155676592228 - 世界冠军举起 - 你是队长，举起胜利的奖杯。人山人海，金色的彩带，纯粹的胜利。 - effect_type: 1 402047865383360 - 场边球童 - 从场边独特的视角体验比赛。作为一名准备参与的年轻人才，感受比赛的激动人心。 - effect_type: 1 402046136040202 - 史诗级的扑救 - 成为传奇门将。在惊人的飞身扑救中接住球。 - effect_type: 1

可选值："412736208886848", "411563216524736", "411316927927040", "411174903569216", "410999246341952", "408891141511104", "410317363057408", "410285445698304", "410133101388544", "409899296377728", "408897485909952", "408869061406656", "408661207662528", "409767750265728", "409766559675264", "409589071559552", "407804339389760", "407658863287616", "407474361215744", "407473438360320", "407467702283008", "385844572217469", "406428904874432", "406423682060736", "406411724685760", "406372274350528", "406218913317312", "406218479198656", "406064763308480", "406413607395776", "405662117814720", "406014934000064", "405658369331648", "405321470423488", "405175211454656", "404955806201792", "404820147974080", "398980393937856", "403916646846400", "403739217192896", "403560060358144", "403556618212098", "398965022284579", "402201060373270", "403085292466285", "402061828030966", "402888569901524", "402155676592228", "402047865383360", "402046136040202"

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "pixverse-v6/image-to-video",
  "input": {
    "prompt": "Cinematic sunrise illuminating a mist-shrouded mountain lake, camera slowly skimming over the water, a flock of birds flying across the sky",
    "image_urls": [
      "Your prompt"
    ],
    "quality": "720p",
    "duration": 5
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

PixVerse V6 参考图生视频

POST/api/v1/jobs/createTask

模型标识： pixverse-v6/reference-to-video

参数类型说明与限制
model
必填		string

生成任务的模型名称。必填字段。

可选值："pixverse-v6/reference-to-video"

默认："pixverse-v6/reference-to-video"

callBackUrl
可选		string

用于在生成任务完成时接收通知的回调 URL。选填，但建议在生产环境中使用。 - 任务生成后，系统将通过 POST 请求将任务状态和结果推送到此 URL - 回调内容包括生成内容的 URL 和任务相关信息 - 您的回调 API 必须支持 POST 请求和 JSON 格式的请求体 - 或者，您可以通过调用任务详情 API 主动轮询任务状态

input
必填		object

生成任务的输入参数

input.prompt
必填		string

生成提示词，不能为空，长度限制为 3–5000 个字符。

minLength: 3

maxLength: 5000

input.image_references
必填		array

参考图列表。ref_name 在同一列表内必须唯一，可在 prompt 中通过 @ref_name 引用该参考对象。

minItems: 1

maxItems: 7

input.image_references[].image_url
必填		string

参考图片 URL。

input.image_references[].type
可选		string

参考图类型。subject 表示主体，background 表示背景。

可选值："subject", "background"

默认："subject"

input.image_references[].ref_name
可选		string

参考图名称，最长 30 个字符。可在提示词中使用 `@名称` 引用。

minLength: 1

maxLength: 30

input.aspect_ratio
必填		string

必填。画幅比例。(PixVerseV6AspectRatio)

可选值："16:9", "4:3", "1:1", "3:4", "9:16", "2:3", "3:2", "21:9"

input.quality
必填		string

必填。清晰度。

可选值："360p", "540p", "720p", "1080p"

input.duration
必填		integer

必填。生成视频时长，单位秒。校验范围为 1-15。

minimum: 1

maximum: 15

input.generate_audio_switch
可选		boolean

是否生成音频。

默认：false

input.seed
可选		integer

随机种子，可选。范围 0-2147483647。

minimum: 0

maximum: 2147483647

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "pixverse-v6/reference-to-video",
  "input": {
    "prompt": "A cinematic sunrise illuminates a mist-shrouded mountain lake; the camera slowly sweeps across the water'\''s surface as a flock of birds flies overhead.",
    "image_references": [
      {
        "image_url": "https://example.com/input.png",
        "type": "subject",
        "ref_name": "dog"
      },
      {
        "image_url": "https://example.com/input.png",
        "type": "background",
        "ref_name": "room"
      }
    ],
    "aspect_ratio": "16:9",
    "quality": "720p",
    "duration": 5
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

PixVerse V6 文生视频

POST/api/v1/jobs/createTask

模型标识： pixverse-v6/text-to-video

参数类型说明与限制
model
必填		string

生成任务的模型名称。必填字段。

可选值："pixverse-v6/text-to-video"

默认："pixverse-v6/text-to-video"

callBackUrl
可选		string

用于在生成任务完成时接收通知的回调 URL。选填，但建议在生产环境中使用。 - 任务生成后，系统将通过 POST 请求将任务状态和结果推送到此 URL - 回调内容包括生成内容的 URL 和任务相关信息 - 您的回调 API 必须支持 POST 请求和 JSON 格式的请求体 - 或者，您可以通过调用任务详情 API 主动轮询任务状态

input
必填		object

生成任务的输入参数

input.prompt
必填		string

生成提示词，不能为空，长度限制为 3–5000 个字符。

minLength: 3

maxLength: 5000

input.duration
必填		integer

必填。输出视频时长（秒）。PixVerse V6 支持 1-15 秒。

minimum: 1

maximum: 15

input.quality
必填		string

必填。输出视频分辨率/质量。支持 360p、540p、720p 和 1080p。

可选值："360p", "540p", "720p", "1080p"

input.aspect_ratio
必填		string

必填。输出视频宽高比。在文本生成视频和 Fusion 多参考图生成视频模式下支持。

可选值："16:9", "4:3", "1:1", "3:4", "9:16", "2:3", "3:2", "21:9"

input.generate_audio_switch
可选		boolean

是否生成音频。

默认：false

input.generate_multi_clip_switch
可选		boolean

是否启用 PixVerse V6 的多片段生成。

默认：false

input.seed
可选		integer

随机种子，范围 0-2147483647。使用相同的参数和种子有助于提高结果的复现性。

minimum: 0

maximum: 2147483647

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "pixverse-v6/text-to-video",
  "input": {
    "prompt": "A cinematic sunrise illuminates a mist-shrouded mountain lake; the camera slowly sweeps across the water'\''s surface as a flock of birds flies overhead.",
    "aspect_ratio": "16:9",
    "quality": "720p",
    "duration": 5
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

PixVerse V6 首尾帧/转场

POST/api/v1/jobs/createTask

模型标识： pixverse-v6/transition

参数类型说明与限制
model
必填		string

生成任务的模型名称。必填字段。

可选值："pixverse-v6/transition"

默认："pixverse-v6/transition"

callBackUrl
可选		string

用于在生成任务完成时接收通知的回调 URL。选填，但建议在生产环境中使用。 - 任务生成后，系统将通过 POST 请求将任务状态和结果推送到此 URL - 回调内容包括生成内容的 URL 和任务相关信息 - 您的回调 API 必须支持 POST 请求和 JSON 格式的请求体 - 或者，您可以通过调用任务详情 API 主动轮询任务状态

input
必填		object

生成任务的输入参数

input.prompt
必填		string

生成提示词，不能为空，长度限制为 3–5000 个字符。

minLength: 3

maxLength: 5000

input.duration
必填		integer

必填。生成视频时长，单位秒

minimum: 1

maximum: 15

input.quality
必填		string

必填。清晰度。

可选值："360p", "540p", "720p", "1080p"

input.generate_audio_switch
可选		boolean

是否生成音频。

input.seed
可选		integer

随机种子，可选。范围 0-2147483647。

minimum: 0

maximum: 2147483647

input.first_frame_image_url
必填		string

首帧图片 URL，必填。支持 HTTP、HTTPS 和 OSS 地址，图片格式支持 JPG、JPEG、PNG 和 WebP，单个图片文件大小不超过 20 MB。

input.last_frame_image_url
必填		string

尾帧图片 URL，必填。支持 HTTP、HTTPS 和 OSS 地址，图片格式支持 JPG、JPEG、PNG 和 WebP，单个图片文件大小不超过 20 MB。

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "pixverse-v6/transition",
  "input": {
    "prompt": "A cinematic sunrise illuminates a mist-shrouded mountain lake; the camera slowly sweeps across the water'\''s surface as a flock of birds flies overhead.",
    "first_frame_image_url": "https://example.com/input.png",
    "last_frame_image_url": "https://example.com/input.png",
    "quality": "720p",
    "duration": 5
  }
}'
返回值与错误

HTTP 200

参数类型说明与限制
code
必填		integer

请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
必填		string

响应消息，失败时的错误描述

data
必填		object
data.taskId
必填		string

可以使用任务 ID 与“获取任务详细信息”端点一起查询任务状态。

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。