---
title: PixVerse V5 | Runware Docs
url: https://runware.ai/docs/models/pixverse-v5
description: PixVerse V5 cinematic text to video and image to video
---
# PixVerse V5

![PixVerse V5](https://assets.runware.ai/covers/pixverse-v5.jpg)

PixVerse V5 generates high fidelity video from text prompts or single images. It delivers smooth motion and sharp cinematic frames with strong prompt alignment. Ideal for creators who need fast iteration, keyframe control, and consistent style across shots.

- **Status**: live
- **ID**: `pixverse:1@5`
- Try in Playground
- **Creator**: PixVerse
- **Release Date**: August 29, 2025
- **Capabilities**: Text to Video, Image to Video, Checkpoint

## Pricing

$0.0224 from, per second · ~57s per request

**Rates** (per second)

- 360p: `$0.0224`
- 540p: `$0.0224`
- 720p: `$0.03`
- 1080p: `$0.0598`

**4 example generations**

- [first-last-frame](https://runware.ai/docs/models/pixverse-v5/examples#example-precision-fermentation-sampling-b-roll) · 540p · 5s: `$0.112` (~47s)
- [visual-effect](https://runware.ai/docs/models/pixverse-v5/examples#example-couture-beekeeping-suit-rotation-reel) · 1080p · 5s: `$0.299` (~49s)
- [first-frame](https://runware.ai/docs/models/pixverse-v5/examples#example-nocturnal-transit-logo-motion-loop) · 720p · 8s: `$0.299` (~1m 5s)
- [text-to-video](https://runware.ai/docs/models/pixverse-v5/examples#example-backwater-valve-cutaway-explainer) · 1080p · 5s: `$0.299` (~1m 42s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

Provide exactly one of: `inputs.frameImages` or `width/height`.

---

`resolution` cannot be used with `width/height`.

---

When `resolution` is provided, `inputs.frameImages` is required.

---

`width` and `height` must be used together.

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `360p (16:9)` | `640x360` |
| `360p (4:3)` | `480x360` |
| `360p (1:1)` | `360x360` |
| `360p (3:4)` | `360x480` |
| `360p (9:16)` | `360x640` |
| `540p (16:9)` | `960x540` |
| `540p (4:3)` | `720x540` |
| `540p (1:1)` | `540x540` |
| `540p (3:4)` | `540x720` |
| `540p (9:16)` | `540x960` |
| `720p (16:9)` | `1280x720` |
| `720p (4:3)` | `960x720` |
| `720p (1:1)` | `720x720` |
| `720p (3:4)` | `720x960` |
| `720p (9:16)` | `720x1280` |
| `1080p (16:9)` | `1920x1080` |
| `1080p (4:3)` | `1440x1080` |
| `1080p (1:1)` | `1080x1080` |
| `1080p (3:4)` | `1080x1440` |
| `1080p (9:16)` | `1080x1920` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/pixverse-v5#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `videoInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/pixverse-v5#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/pixverse-v5#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Video output type.

**Allowed values**: `URL`

### [outputFormat](https://runware.ai/docs/models/pixverse-v5#request-outputformat)

- **Type**: `string`
- **Default**: `MP4`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`MP4\`: Widely supported video container (H.264), recommended for general use.
- \`WEBM\`: Optimized for web delivery.
- \`MOV\`: QuickTime format, common in professional workflows (Apple ecosystem).

**Allowed values**: `MP4` `WEBM` `MOV`

### [outputQuality](https://runware.ai/docs/models/pixverse-v5#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/pixverse-v5#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/pixverse-v5#request-deliverymethod)

- **Type**: `string`
- **Default**: `async`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/pixverse-v5#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/pixverse-v5#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (2 properties)`

Content safety checking configuration for video generation.

#### [checkContent](https://runware.ai/docs/models/pixverse-v5#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`

Enable or disable content safety checking. Increases total generation time and adds a small charge on top of the generation cost.

#### [mode](https://runware.ai/docs/models/pixverse-v5#request-safety-mode)

- **Path**: `safety.mode`
- **Type**: `string`
- **Default**: `fast`

Safety checking mode for video generation.

**Allowed values**:

- `fast` Checks key frames.
- `full` Checks all frames.

### [ttl](https://runware.ai/docs/models/pixverse-v5#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/pixverse-v5#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/pixverse-v5#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `4`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [frameImages](https://runware.ai/docs/models/pixverse-v5#request-inputs-frameimages)

- **Path**: `inputs.frameImages`
- **Type**: `array of strings or objects`
- **Min items**: `1`
- **Max items**: `2`

An array of frame-specific image inputs to guide video generation. Each item can be either a plain image input (UUID, URL, Data URI, or Base64) or an object that pairs an image with a target position in the video.

The `frameImages` parameter allows you to constrain specific frames within the video sequence, ensuring that particular visual content appears at designated points. Position can be specified using `frame` (named positions or frame indices) or `timestamp` (seconds), depending on model support. This is different from `referenceImages`, which provide overall visual guidance without constraining specific timeline positions.

When the `frame` parameter is omitted, automatic distribution rules apply:

- **1 image**: Used as the first frame.
- **2 images**: First and last frames.

**Examples**:

**Shorthand format:** When you don't need to specify a frame position, you can pass a plain image input directly.

```json
"frameImages": [
  "aac49721-1964-481a-ae78-8a4e29b91402"
]
```

**Object format:** When you need to specify a position, use an object with `image` and either `frame` or `timestamp` (model-dependent).

```json
"frameImages": [
  {
    "image": "aac49721-1964-481a-ae78-8a4e29b91402",
    "frame": "first"
  }
]
```

**First and last frames:** With two images, they automatically become the first and last frames of the video sequence. You can mix shorthand and object formats.

```json
"frameImages": [
  "aac49721-1964-481a-ae78-8a4e29b91402",
  {
    "image": "3ad204c3-a9de-4963-8a1a-c3911e3afafe",
    "frame": "last"
  }
]
```

**Format 1: string[]**:

- **Type**: `string`

Image input (UUID, URL, Data URI, or Base64).

**Format 2: object[]**:

#### [image](https://runware.ai/docs/models/pixverse-v5#request-inputs-frameimages-format-2-image)

- **Path**: `inputs.frameImages.image`
- **Type**: `string`
- **Required**: true

Image input (UUID, URL, Data URI, or Base64).

#### [frame](https://runware.ai/docs/models/pixverse-v5#request-inputs-frameimages-format-2-frame)

- **Path**: `inputs.frameImages.frame`
- **Type**: `object`

Target frame position for the image. Supports first and last frame.

**Allowed values**:

- `first` First frame of the video.
- `last` Last frame of the video.
- `0` Frame index 0 (first frame).
- `-1` Frame index -1 (last frame).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/pixverse-v5#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `pixverse:1@5`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/pixverse-v5#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `2`
- **Max**: `2048`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [negativePrompt](https://runware.ai/docs/models/pixverse-v5#request-negativeprompt)

- **Type**: `string`
- **Min**: `2`
- **Max**: `2048`

Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).

**Learn more** (1 resource):

- [Prompts: Negative Prompts](https://runware.ai/docs/learn/prompts#negative-prompts) (learn)

### [width](https://runware.ai/docs/models/pixverse-v5#request-width)

- **Type**: `integer`
- **Required**: conditional — Required when inputs.frameImages is not provided
- **Paired with**: height

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/pixverse-v5#request-height)

- **Type**: `integer`
- **Required**: conditional — Required when inputs.frameImages is not provided
- **Paired with**: width

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [resolution](https://runware.ai/docs/models/pixverse-v5#request-resolution)

- **Type**: `string`
- **Default**: `720p`

Resolution preset for the output. When used with input media, automatically matches the aspect ratio from the input.

**Allowed values**: `360p` `540p` `720p` `1080p`

### [duration](https://runware.ai/docs/models/pixverse-v5#request-duration)

- **Type**: `integer`

Length of the generated video in seconds. The total number of frames produced is determined by duration multiplied by the model's frame rate (fps).

**Allowed values**: `5` `8`

### [seed](https://runware.ai/docs/models/pixverse-v5#request-seed)

- **Type**: `integer`
- **Min**: `0`
- **Max**: `2147483647`

Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

**Provider Settings**

Parameters specific to this model provider. These must be nested inside the \`providerSettings.pixverse\` object.

### [effect](https://runware.ai/docs/models/pixverse-v5#request-providersettings-pixverse-effect)

- **Path**: `providerSettings.pixverse.effect`
- **Type**: `string`

Visual effect template.

**Allowed values**:

- `bikini up` Body transformation effect.
- `the tigers touch` Animal-themed transformation.
- `jiggle jiggle` Rhythmic movement effect.
- `hug your love` Romantic interaction template.
- `kiss me ai` Kiss interaction effect.
- `subject 3 fever` Energetic movement template.
- `fin-tastic mermaid` Mermaid transformation.
- `lets ymca` Dance movement template.
- `skeleton dance` Spooky dance effect.
- `kungfu club` Martial arts action template.
- `boom drop` Explosive impact effect.
- `vroom vroom step` Vehicle-themed movement.
- `creepy devil smile` Horror-themed facial effect.
- `pubg winner hit` Gaming victory celebration.
- `360 microwave` Spinning rotation effect.
- `eye zoom challenge` Close-up eye effect.
- `muscle surge` Body enhancement effect.
- `punch face` Impact reaction template.
- `balloon belly` Body inflation effect.
- `kiss kiss` Multiple kiss interaction.

### [style](https://runware.ai/docs/models/pixverse-v5#request-providersettings-pixverse-style)

- **Path**: `providerSettings.pixverse.style`
- **Type**: `string`

Artistic style aesthetic for video generation.

**Allowed values**:

- `anime` Japanese animation aesthetic.
- `3d_animation` Three-dimensional animated style with depth.
- `clay` Stop-motion clay animation appearance.
- `comic` Comic book or graphic novel visual style.
- `cyberpunk` Futuristic, neon-lit dystopian aesthetic.

## Response Parameters

### [taskType](https://runware.ai/docs/models/pixverse-v5#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `videoInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/pixverse-v5#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [videoUUID](https://runware.ai/docs/models/pixverse-v5#response-videouuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output video.

### [videoURL](https://runware.ai/docs/models/pixverse-v5#response-videourl)

- **Type**: `string`
- **Format**: `uri`

URL of the output video.

### [videoBase64Data](https://runware.ai/docs/models/pixverse-v5#response-videobase64data)

- **Type**: `string`

Base64-encoded video data.

### [videoDataURI](https://runware.ai/docs/models/pixverse-v5#response-videodatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output video.

### [seed](https://runware.ai/docs/models/pixverse-v5#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/pixverse-v5#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/pixverse-v5#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### text-to-video (text-to-video)

[Watch video](https://assets.runware.ai/examples/pixverse-v5/7da882e1-c803-4515-8ce0-9a7b6b3ea0df.mp4)

```json
{
  "taskType": "videoInference",
  "taskUUID": "348752f0-8116-4a3d-9144-7c3d9937dfe6",
  "model": "pixverse:1@5",
  "positivePrompt": "Single continuous photorealistic CGI product explainer for a plumbing manufacturer, composed in cinematic 16:9. A brass residential backwater valve sits centered inside a clean transparent cutaway drainpipe on a dark navy studio workbench. Begin with a close three-quarter view as clear water flows normally through the pipe from left to right, carrying a few visible bubbles and harmless debris past the open hinged gate. The camera slowly dollies forward and arcs right. Mid-shot, a turbulent reverse surge rushes back from the right; the rising water force swings the internal stainless-steel gate firmly shut toward camera, compressing the black rubber seal. The surge impacts the closed gate and stops completely while droplets, bubbles, and suspended particles swirl on the blocked side. End on a sharp macro view of the sealed mechanism, with the protected left side remaining dry and calm. Premium industrial visualization, physically accurate water, precise mechanical motion, brushed metal, warm copper highlights, cool navy background, crisp rim lighting, subtle volumetric mist, shallow depth of field, no cuts, no labels, no logo, no interface, no on-screen text.",
  "negativePrompt": "people, hands, tools, exploded parts, disconnected components, leaking seal, water crossing the closed gate, warped pipe, duplicate valve, illegible markings, brand names, captions, diagrams, arrows, interface elements, camera shake, abrupt cuts, cartoon appearance",
  "width": 1920,
  "height": 1080,
  "duration": 5,
  "providerSettings": {
    "pixverse": {
      "style": "cyberpunk"
    }
  }
}
```

---

### first-frame (first-frame)

[Watch video](https://assets.runware.ai/examples/pixverse-v5/8fe7d765-ec8a-4990-942d-401699d786a1.mp4)

```json
{
  "taskType": "videoInference",
  "taskUUID": "7d083c7b-17d1-4ed0-81f0-fc56cdc57ab6",
  "model": "pixverse:1@5",
  "positivePrompt": "Continue directly from the supplied first-frame logo keyframe and animate its existing elements without redesigning them. Preserve the exact owl-shaped transit emblem, centered composition, flat geometry, midnight-indigo background, cream route loops, coral waypoint, mint street grid, and screen-printed texture. Begin with the complete logo resting. A soft reflective highlight travels along both mirrored route loops like two night buses following synchronized routes. The faint street grid gently illuminates outward from the coral waypoint, one intersection at a time. The cream loops then peel a short distance outward in a smooth symmetrical orbit while retaining their precise shapes; the coral waypoint pulses once like a station beacon. The loops glide back and lock perfectly into the owl emblem as the grid illumination recedes. End on the exact original arrangement and brightness for a seamless loop. Polished 2D brand motion, controlled easing, sharp edges, subtle analog grain, steady locked camera, no added objects or text.",
  "negativePrompt": "Extra lettering, captions, new symbols, altered logo geometry, color shifts, camera movement, zoom, perspective distortion, flicker, abrupt cuts, uneven asymmetry, warped lines, photorealism, mockup presentation.",
  "resolution": "720p",
  "duration": 8,
  "inputs": {
    "frameImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/508a95d5-1603-4cf4-aec0-d55497d615bb.jpg",
        "frame": "first"
      }
    ]
  }
}
```

---

### first-last-frame (first-last-frame)

[Watch video](https://assets.runware.ai/examples/pixverse-v5/f3ad5847-cd7b-4f2d-b8c4-95e8d46820f4.mp4)

```json
{
  "taskType": "videoInference",
  "taskUUID": "e7f00641-7d56-456a-923a-67259c24a660",
  "model": "pixverse:1@5",
  "positivePrompt": "Create a single continuous five-second documentary b-roll shot connecting the supplied first and last frames. In a pristine precision-fermentation laboratory, a technician collects an amber microbial culture sample from a bench-top glass bioreactor. Begin with the empty vial already positioned beneath the polished sampling spout and the other gloved hand gripping the lever. The technician smoothly opens the valve; a narrow, physically realistic stream of amber liquid flows into the vial while fine bubbles keep rising through the vessel. The stream stops cleanly as the lever closes, ending with the vial one-third full. Use a restrained slider push-in with a slight move to the right, preserving the same camera axis and subject geometry. Natural hand motion, accurate liquid behavior, subtle reflections on stainless steel, soft mint-white lab illumination, coral tubing accents, shallow depth of field, crisp photorealistic editorial stock-footage quality. Calm, credible, hygienic mood. No cuts, morphing, camera shake, faces, logos, labels, captions, or interface graphics.",
  "negativePrompt": "Unstable equipment, changing vessel design, extra hands, deformed fingers, leaking valve, splashing liquid, smoke, dramatic steam, camera cuts, fast zoom, flicker, warped glass, illegible labels, logos, subtitles, watermark, laboratory interface overlays.",
  "resolution": "540p",
  "duration": 5,
  "inputs": {
    "frameImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/0b9a4e31-aa63-4fe8-8bb8-bbb79357efed.jpg",
        "frame": "first"
      },
      {
        "image": "https://assets.runware.ai/assets/inputs/6f1010e2-6a8f-4854-9686-a49be245988a.jpg",
        "frame": "last"
      }
    ]
  }
}
```

---

### visual-effect (visual-effect)

[Watch video](https://assets.runware.ai/examples/pixverse-v5/f8407f1c-3789-443a-8d19-62f662a4d2b3.mp4)

```json
{
  "taskType": "videoInference",
  "taskUUID": "d94da1ce-2a55-48dc-91e9-555835903e32",
  "model": "pixverse:1@5",
  "positivePrompt": "Premium five-second fashion product showcase for a couture protective beekeeping suit. Keep the full-body model centered, clearly visible, and poised as the presentation reveals the garment from every side. Preserve the exact ivory canvas construction, saffron pockets, oxblood gloves and boots, circular brass-framed mesh veil, realistic adult anatomy, and refined editorial styling from the first frame. Subtle natural fabric settling and delicate veil movement add life without changing the outfit. Warm honey-gold studio illumination glides across canvas, brass, leather, and mesh, revealing stitching and material texture. Symmetrical cream and apricot set, generous negative space, polished luxury campaign finish, crisp subject separation, smooth continuous motion, no cuts, no added props, no lettering, no logos.",
  "negativePrompt": "wardrobe transformation, duplicated person, extra limbs, distorted hands, missing boots, altered veil, swarming insects, aggressive movement, cluttered set, camera shake, jump cuts, text, captions, logos, watermark",
  "resolution": "1080p",
  "duration": 5,
  "providerSettings": {
    "pixverse": {
      "effect": "360 microwave"
    }
  },
  "inputs": {
    "frameImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/ad16cbc1-d0b4-4377-9500-f843ad2b2fc4.jpg",
        "frame": "first"
      }
    ]
  }
}
```