跳转到主要内容
POST
本接口采用异步处理。提交后使用返回的 task_id,通过 GET /v1/videos/generations/{task_id} 查询任务状态和结果。

模型能力

PixVerse V6 Max 是 PixVerse V6 的高画质版本,仅支持文生视频和单图生视频,使用同一个模型名 pixverse-v6-max。 首尾帧过渡、多图融合和视频续写请使用 PixVerse V6。

请求头

string
必填
Bearer 认证,格式为 Bearer <token>,其中 <token> 为你的 APIMart API Key。

请求参数

string
必填
固定为 pixverse-v6-max。
string
描述要生成的内容。文生视频必填,最长 5000 字符;图生视频可省略,最长 2048 字符。
string[]
输入图片 URL 列表。图生视频只能传 1 张图片;传入 2 张及以上会同步返回 HTTP 400。不传此字段为文生视频。图片要求:公网 HTTP(S) 可访问,支持 JPEG、PNG、WebP,文件小于 20 MB,每条边不超过 10000 像素。
integer
默认值:"5"
输出时长,单位为秒,支持 1–15,默认 5。
string
默认值:"540p"
输出分辨率,支持 360p、540p、720p、1080p,默认 540p。输出采用上游原生尺寸,以实际返回为准。实测代表规格包括 640×360、1108×832(宽 × 高,单位为像素)。也接受 quality 字段;同时传入时,resolution 优先。
string
分辨率的兼容字段,可选值与 resolution 相同。仅在未传 resolution 时使用;两者均不传时使用 540p。
string
默认值:"16:9"
仅对文生视频生效,支持 16:9、9:16、4:3、3:4、1:1、2:3、3:2、21:9,默认 16:9。图生视频始终跟随输入图片的宽高比,此字段不生效。
boolean
默认值:"false"
传 true 生成原生音轨;默认无声。有声生成的每秒单价更高。只识别请求体顶层的 audio。metadata.generate_audio_switch 不会开启音轨,也不会触发有声计费。
integer
随机种子,取值范围为 0–2147483647。

图生视频示例

请将示例 URL 替换为实际可公开访问的图片地址。只能提供 1 张图片,输出宽高比跟随该图片。

查询任务

将以下请求中的任务 ID 替换为提交时返回的 task_id:

计费

费用按输出秒数乘以对应分辨率及音频档位的每秒单价计算。有声与无声使用不同单价,有声单价更高。 未指定 resolution 或 quality 时,输出和计费均使用 540p。 当前单价以模型价格查询接口为准:

不支持的功能及参数错误

以下请求会同步返回 HTTP 400,不创建任务、不扣费: