Pixverse v6 Video Generation

Supports text-to-video, image-to-video, first/last frame transition, multi-reference fusion, and video extension
Supports 360p/540p/720p/1080p resolutions with 1-15 seconds duration
Asynchronous task API; query the result by task ID after submission

Request example

curl --request POST \
  --url https://api.openveer.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "pixverse-v6",
    "prompt": "A cinematic shot of a corgi running through a sunflower field at golden hour",
    "size": "16:9",
    "resolution": "540p",
    "duration": 5
  }'

import requests

url = "https://api.openveer.com/v1/videos/generations"

payload = {
    "model": "pixverse-v6",
    "prompt": "A cinematic shot of a corgi running through a sunflower field at golden hour",
    "size": "16:9",
    "resolution": "540p",
    "duration": 5
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.openveer.com/v1/videos/generations";

const payload = {
  model: "pixverse-v6",
  prompt: "A cinematic shot of a corgi running through a sunflower field at golden hour",
  size: "16:9",
  resolution: "540p",
  duration: 5
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JWXXXXXXXXXXXX"
    }
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "message": "invalid duration 20, allowed range: 1-15 seconds"
  }
}

{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 403,
    "message": "insufficient quota: balance=0, required=0.25",
    "type": "quota_not_enough"
  }
}

{
  "error": {
    "code": 429,
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

Authentication

Authorization string

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:

Authorization: Bearer YOUR_API_KEY

Request Parameters

model string

Video generation model name. Fixed to pixverse-v6.

nsfw_check boolean

Whether to run content moderation before submitting the video task.

true: use omni-moderation-latest to review prompts and input images
false or omitted: do not send a moderation request, adding no moderation cost or latency (default)

prompt string

Video content description, up to 5000 characters. Required for all modes.

resolution string

Video resolution tier; directly affects pricing.

360p: SD
540p: Standard (default)
720p: HD
1080p: Full HD

Warning

Other resolution values will return a parameter error.

duration integer

Video duration in seconds, range 1-15.

Warning

First/last frame transition mode only supports 5 or 8 seconds.

size string

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

seed integer

Random seed, range 0-2147483647. Same prompt and seed can reproduce similar results.

negative_prompt string

Negative prompt used to exclude unwanted content, up to 2048 characters.

audio boolean

Whether to generate an audio track.

true: Generate audio (increases pricing)
false: No audio (default)

watermark boolean

Whether to add a watermark in the bottom-right corner of the video.

true: Add watermark
false: No watermark (default)

motion_mode string

Motion mode.

normal: Standard mode (pixverse-v6 only supports this value)

Warning

fast only applies to legacy models and will be rejected by the upstream when used with pixverse-v6.

generate_multi_clip_switch boolean

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)

image_urls string

">
Input image URL array for image-to-video; only the first image is used.

Images must be publicly accessible HTTP/HTTPS URLs.

first_frame_image url

First frame image URL for transition mode. Must be provided together with last_frame_image.

last_frame_image url

Last frame image URL for transition mode. Must be provided together with first_frame_image.

img_references string

">
Reference image URL array for multi-reference fusion mode; supports 1-7 images.

Providing this field triggers multi-reference fusion mode.

extend_from_task_id 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.

Mode	Trigger	Description
Text-to-video	No image or extension fields	Generate video based on `prompt`
Image-to-video	`image_urls` with one image	Use the first image as input
First/last frame transition	Both `first_frame_image` and `last_frame_image` provided	Generate a smooth transition between two frames
Multi-reference fusion	`img_references` array provided	Fuse 1-7 reference images into a video
Video extension	`extend_from_task_id` provided	Continue generation from a completed Pixverse task

Warning

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

Constraint	Description
Duration	`1 ≤ duration ≤ 15` seconds; transition mode only supports `5` or `8` seconds
Resolution	Only `360p`, `540p`, `720p`, `1080p` are supported
Aspect ratio	`size` is only effective in text-to-video and multi-reference fusion modes
Prompt length	`prompt` up to 5000 chars, `negative_prompt` up to 2048 chars
Image-to-video	`image_urls` only uses the first image
Transition	`first_frame_image` and `last_frame_image` must be provided together
Motion mode	`pixverse-v6` only supports `normal`
Multi-reference fusion	`img_references` supports 1-7 images
Video extension	`extend_from_task_id` must point to a `completed` `pixverse-v6` task owned by the current user

Response

code integer

Response status code. 200 on success.

data array

Returned task array.

status string

Initial task status. submitted upon successful submission.

task_id string

Unique task identifier used for querying status and results.

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 --request GET \
  --url https://api.openveer.com/v1/tasks/task_01JWXXXXXXXXXXXX \
  --header 'Authorization: Bearer <token>'

It is recommended to poll every 5 seconds until the status becomes completed or failed.

Successful Result Example

{
  "code": 200,
  "data": {
    "id": "task_01KSPX48B8V1M6C2ZN0D0T4BKB",
    "status": "completed",
    "progress": 100,
    "cost": 0.2,
    "credits_cost": 2,
    "created": 1779958948,
    "completed": 1779958999,
    "estimated_time": 100,
    "actual_time": 51,
    "result": {
      "videos": [
        {
          "url": ["https://upload.openveer.com/f/video/xxxx.mp4"],
          "expires_at": 1780045399
        }
      ]
    }
  }
}

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

{
  "code": 200,
  "data": {
    "id": "task_01KSPX48B8V1M6C2ZN0D0T4BKB",
    "status": "failed",
    "progress": 100,
    "cost": 0,
    "credits_cost": 0,
    "created": 1779958948,
    "completed": 1779958960,
    "error": {
      "code": "task_failed",
      "message": "pixverse error 400063: moderation failed",
      "type": "task_failed"
    }
  }
}

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

Use Cases

Case 1: Text-to-video

{
  "model": "pixverse-v6",
  "prompt": "A neon-lit alley in Tokyo at night, light rain, anamorphic lens flare",
  "size": "21:9",
  "resolution": "720p",
  "duration": 8,
  "seed": 42,
  "audio": true
}

Case 2: Image-to-video

{
  "model": "pixverse-v6",
  "prompt": "Camera slowly zooms in, gentle wind moves the leaves",
  "image_urls": ["https://example.com/first-frame.jpg"],
  "resolution": "540p",
  "duration": 5
}

Case 3: First/Last Frame Transition

{
  "model": "pixverse-v6",
  "prompt": "transform smoothly from a puppy to a cat",
  "first_frame_image": "https://example.com/puppy.jpg",
  "last_frame_image": "https://example.com/cat.jpg",
  "resolution": "540p",
  "duration": 5,
  "motion_mode": "normal"
}

Case 4: Multi-Reference Fusion

{
  "model": "pixverse-v6",
  "prompt": "A girl wearing the outfit from image 2, holding the cat from image 3",
  "img_references": [
    "https://example.com/character.jpg",
    "https://example.com/outfit.jpg",
    "https://example.com/cat.jpg"
  ],
  "size": "9:16",
  "resolution": "720p",
  "duration": 5
}

Case 5: Video Extension

{
  "model": "pixverse-v6",
  "prompt": "the character now walks into a forest",
  "extend_from_task_id": "task_01JWXXXXXXXXXXXX",
  "resolution": "540p",
  "duration": 5
}

This documentation is built and hosted on Mintlify, a developer documentation platform.