Skip to main content
POST
This endpoint is asynchronous. After submission, use the returned task_id with GET /v1/videos/generations/{task_id} to query the task status and result.

Model capabilities

PixVerse V6 Max is the higher-quality version of PixVerse V6. It supports only text-to-video and single-image-to-video, using the same model name, pixverse-v6-max. For first/last frame transitions, multi-image fusion, and video extension, use PixVerse V6.

Request headers

string
required
Bearer authentication: Bearer <token>, where <token> is your APIMart API Key.

Request parameters

string
required
Must be pixverse-v6-max.
string
Describe the content to generate. Required for text-to-video, up to 5000 characters; optional for image-to-video, up to 2048 characters.
string[]
Input image URL list. Image-to-video accepts exactly 1 image; supplying 2 or more returns HTTP 400 synchronously. Omit this field for text-to-video.Images must be publicly accessible over HTTP(S), in JPEG, PNG, or WebP format, under 20 MB, with each side no longer than 10000 pixels.
integer
default:"5"
Output duration in seconds, from 1 to 15; default: 5.
string
default:"540p"
Output resolution: 360p, 540p, 720p, or 1080p; default: 540p.Output uses the upstream model’s native dimensions; the actual returned dimensions are authoritative. Representative observed sizes include 640×360 and 1108×832 (width × height, in pixels).The quality field is also accepted. When both are supplied, resolution takes precedence.
string
Compatibility field for resolution, with the same values as resolution. Used only when resolution is omitted; if both fields are omitted, 540p is used.
string
default:"16:9"
Applies only to text-to-video. Supports 16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2, and 21:9; default: 16:9.Image-to-video always follows the input image’s aspect ratio; this field has no effect.
boolean
default:"false"
Set to true to generate native audio; the default is silent. Generation with audio has a higher per-second rate.Only the top-level audio field in the request body is recognized. metadata.generate_audio_switch does not enable audio or trigger audio-tier billing.
integer
Random seed, from 0 to 2147483647.

Image-to-video example

Replace the example URL with a real, publicly accessible image URL. Supply only 1 image; the output aspect ratio follows that image.

Query a task

Replace the task ID in the following request with the task_id returned on submission:

Billing

Cost is the output duration in seconds multiplied by the per-second rate for the selected resolution and audio tier. Audio and silent generation use separate rates; audio costs more per second. If neither resolution nor quality is specified, both output and billing use 540p. Current rates are provided by the model pricing endpoint:

Unsupported features and parameter errors

The following requests return HTTP 400 synchronously, without creating a task or charging: