Skip to main content
POST

Authentication

string
required
All endpoints require authentication using a Bearer Token.Get an API Key:Visit the API Key management page to obtain your API Key.Add the following header in your request:

Request Parameters

string
required
Video generation model name. Fixed to pixverse-v6.
string
required
Video content description, up to 5000 characters. Required for all modes.
string
default:"540p"
Video resolution tier; directly affects pricing.
  • 360p: SD
  • 540p: Standard (default)
  • 720p: HD
  • 1080p: Full HD
Other resolution values will return a parameter error.
integer
default:"5"
Video duration in seconds, range 1-15.
First/last frame transition mode only supports 5 or 8 seconds.
string
default:"16:9"
Video aspect ratio. Only effective in text-to-video and multi-reference fusion modes.
  • 16:9: Landscape widescreen (default)
  • 4:3: Landscape 4:3
  • 1:1: Square
  • 3:4: Portrait 3:4
  • 9:16: Portrait vertical
  • 2:3: Portrait 2:3
  • 3:2: Landscape 3:2
  • 21:9: Cinematic widescreen
integer
default:"0"
Random seed, range 0-2147483647. Same prompt and seed can reproduce similar results.
string
Negative prompt used to exclude unwanted content, up to 2048 characters.
boolean
default:"false"
Whether to generate an audio track.
  • true: Generate audio (increases pricing)
  • false: No audio (default)
boolean
default:"false"
Whether to add a watermark in the bottom-right corner of the video.
  • true: Add watermark
  • false: No watermark (default)
string
Motion mode.
  • normal: Standard mode (pixverse-v6 only supports this value)
fast only applies to legacy models and will be rejected by the upstream when used with pixverse-v6.
boolean
default:"false"
Whether to generate a multi-clip continuous video. Only supported in text-to-video and image-to-video modes.
  • true: Generate multi-clip continuous video
  • false: Single clip (default)
array<url>
Input image URL array for image-to-video; only the first image is used.Images must be publicly accessible HTTP/HTTPS URLs.
url
First frame image URL for transition mode. Must be provided together with last_frame_image.
url
Last frame image URL for transition mode. Must be provided together with first_frame_image.
array<url>
Reference image URL array for multi-reference fusion mode; supports 1-7 images.Providing this field triggers multi-reference fusion mode.
string
Source task ID for video extension. Providing this field triggers video extension mode.The source task must belong to the current user, use model pixverse-v6, and have status completed.

Generation Modes

The adapter automatically dispatches to the corresponding generation mode based on request fields. Matching is done in priority order; the first match wins.
All image inputs only accept publicly accessible HTTP/HTTPS URLs. base64 and Data URI are not supported. If you only have local images, upload them to object storage first and pass the URL.

Parameter Rules

Response

integer
Response status code. 200 on success.
array
Returned task array.

Querying Task Results

Video generation is an asynchronous task. After submission, a task_id is returned. Use the Get Task Status endpoint to query progress and results.
cURL
It is recommended to poll every 5 seconds until the status becomes completed or failed.

Successful Result Example

The video URL is at data.result.videos[0].url[0]. The url field is itself an array. Video links typically expire after 24 hours; download or transfer them in time.

Failed Result Example

On failure, cost is typically 0. Read the error reason from data.error.message.

Use Cases

Case 1: Text-to-video

Case 2: Image-to-video

Case 3: First/Last Frame Transition

Case 4: Multi-Reference Fusion

Case 5: Video Extension