跳至正文
EN
获取 API Key
☰
Pixverse · 模型接口

PixVerse V6 Max API

PixVerse V6 Max API 的模型能力、计价规格、请求参数和接入示例。使用 VezAPI 账号密钥统一接入。

文生视频图生视频

PixVerse V6 Max API 接入文档

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

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

PixVerse V6 Max 图生视频

POST/api/v1/jobs/createTask

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

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

生成任务的模型名称。必填字段。用于 PixVerse V6 Max 图生视频。

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

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

callBackUrl
可选		string

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

input
必填		object

图生视频任务的输入参数

input.prompt
必填		string

生成提示词。必填，不能为空，最长 5000 个字符。

minLength: 1

maxLength: 5000

input.image_urls
必填		array

必填。作为首帧的输入图片。数组长度必须恰好为 1。支持 HTTP、HTTPS 和 OSS 地址，格式为 JPG、JPEG、PNG、WebP。单边不超过 10000 px，大小不超过 20 MB。画面比例由这张图决定，请勿再传 `aspect_ratio`。

minItems: 1

maxItems: 1

input.quality
必填		string

必填。输出视频分辨率。支持 360p、540p、720p 和 1080p。大小写不敏感。

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

input.duration
必填		integer

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

minimum: 1

maximum: 15

input.generate_audio_switch
可选		boolean

是否生成与画面同步的原生音频。默认 false。

默认：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-max/image-to-video",
  "input": {
    "prompt": "Use the supplied image as the exact first frame. The subject slowly walks toward the camera in one continuous shot, natural performance, subtle handheld breathing, no cuts",
    "image_urls": [
      "https://example.com/input.png"
    ],
    "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 Max 文生视频

POST/api/v1/jobs/createTask

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

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

生成任务的模型名称。必填字段。用于 PixVerse V6 Max 文生视频。

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

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

callBackUrl
可选		string

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

input
必填		object

文生视频任务的输入参数

input.prompt
必填		string

生成提示词。必填，不能为空，最长 5000 个字符。

minLength: 1

maxLength: 5000

input.aspect_ratio
必填		string

必填。输出视频宽高比。仅用于文生视频。图生视频不要传该字段，画面比例由输入图决定。

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

input.quality
必填		string

必填。输出视频分辨率。支持 360p、540p、720p 和 1080p。大小写不敏感。

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

input.duration
必填		integer

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

minimum: 1

maximum: 15

input.generate_audio_switch
可选		boolean

是否生成与画面同步的原生音频。默认 false。

默认：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-max/text-to-video",
  "input": {
    "prompt": "A cinematic tracking shot of a skateboarder racing through a neon-lit rainy city at night, low-angle follow cam, wet-street reflections, continuous motion",
    "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.

任务状态与回调

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

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

文件、日志与计费

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

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

打开完整文档 →

PixVerse V6 Max API 价格

下方费率为参考估算，最终按实际优惠扣分 1:1 结算。按标准充值包换算，1,000 积分约为 10 美元，大额充值包可降低每积分实际单价。

规格积分计价单位美元参考
pixverse-v6-max, Text /Image to Video, 360p(no audio)4.8每秒$0.048
pixverse-v6-max, Text /Image to Video, 360p(with audio)7.2每秒$0.072
pixverse-v6-max, Text /Image to Video, 540p(no audio)7.2每秒$0.072
pixverse-v6-max, Text /Image to Video, 540p(with audio)8.8每秒$0.088
pixverse-v6-max, Text /Image to Video, 720p(no audio)8.8每秒$0.088
pixverse-v6-max, Text /Image to Video, 720p(with audio)12每秒$0.12
pixverse-v6-max, Text /Image to Video, 1080p(no audio)17.6每秒$0.176
pixverse-v6-max, Text /Image to Video, 1080p(with audio)22.4每秒$0.224