---
title: "PixVerse V6"
description: "Generate 720p frame transitions or new scenes from reference images, with optional native audio."
seo:
  title: "PixVerse V6 API Documentation: Parameters & Examples"
  description: "PixVerse V6 API documentation: model ID pixverse/pixverse-v6, input modes, parameters, defaults and request examples. Generate 720p frame transitions or new scenes from reference images, with optional native audio."
---

{/* Generated by scripts/generate-model-pages.mjs from openapi/model-contracts.json. Do not edit; write notes in docs/models/_notes/pixverse/pixverse-v6.mdx */}

| Model ID | Alias | Endpoint |
| --- | --- | --- |
| `pixverse/pixverse-v6` | `pixverse-v6` | [Video generation](/docs/guides/video-generation) |

## Input modes

| Mode | References | Reference roles |
| --- | --- | --- |
| `image` Image input | 2 | `first_frame`, `last_frame` |
| `reference` Reference media | 1 to 7 | `reference_image` |

Prompt limit: 5,000 characters; longer prompts are rejected with 400.

## Parameters

| Parameter | Description | Values | Default | Required |
| --- | --- | --- | --- | --- |
| `duration` | Duration: Output video duration in seconds. Only in `image`. | `5`, `8` | `5` | No |
| `duration` | Duration: Output video duration in seconds. Only in `reference`. | `1` to `15` | `5` | No |
| `resolution` | Resolution: Output resolution. | `720p` | `720p` | No |
| `aspect_ratio` | Aspect ratio: Output aspect ratio. Only in `image`. | `auto` | `auto` | No |
| `aspect_ratio` | Aspect ratio: Output aspect ratio. Only in `reference`. | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` | `16:9` | No |
| `generate_audio` | Generate audio: Generate native audio with the video. | `false`, `true` | `false` | No |
| `n` | Outputs per request: Number of outputs from one API request (one Job), not the application batch size. For multiple Jobs, submit separate requests; n=1 does not prevent application-managed batching. | `1` | `1` | No |

## Examples

`image` input:

```json
{
  "model": "pixverse/pixverse-v6",
  "input": {
    "type": "image",
    "prompt": "A paper boat drifting down a rainy city street, slow tracking shot",
    "references": [
      {
        "role": "first_frame",
        "file_id": "file_..."
      },
      {
        "role": "last_frame",
        "file_id": "file_..."
      }
    ]
  },
  "parameters": {
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": false,
    "n": 1
  }
}
```

`reference` input:

```json
{
  "model": "pixverse/pixverse-v6",
  "input": {
    "type": "reference",
    "prompt": "A paper boat drifting down a rainy city street, slow tracking shot",
    "references": [
      {
        "role": "reference_image",
        "file_id": "file_..."
      }
    ]
  },
  "parameters": {
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false,
    "n": 1
  }
}
```

The authoritative contract is `GET /v1/models/pixverse/pixverse-v6?view=contract`. A valid parameter does not mean every channel can run it, so [quote](/docs/concepts/billing#get-a-quote) the complete request. Prices and channels are listed in [Model Market](https://yir.ai/models).

Use `input.type: "image"` and provide one `first_frame` image and one `last_frame` image. APIMart supports 5- and 8-second transitions at 720p. The source images determine the aspect ratio.

Set `parameters.generate_audio` to `true` to generate audio. Quote accounts for the audio setting and duration. Yir settles from the provider's task-level charge.

For Fusion, set `input.type` to `"reference"` and pass 1–7 `reference_image` entries. APIMart supports 1–15 seconds at 720p, with 16:9 as the default aspect ratio. The output-second rate includes the reference images and depends on whether audio is enabled.
