Name: PixVerse V6 API: Text and Image to Video with Audio
Brand: magicapi
SKU: api-magicapi-cinematic-video-generation-api-pixverse-pixverse-v6
Availability: InStock
Author: API Market

Shashank Agarwal

# 🎥 Cinematic Video Generation API (PixVerse V6)

## Overview
PixVerse V6 is PixVerse's flagship video generation model. It makes a video from a text prompt, from a first-frame image, or as a transition from a first-frame image to a last-frame image. Optional switches add generated audio (background music, sound effects and character dialogue) and multi-shot sequences with scene transitions. Describe shots and camera moves in the prompt; there is no separate camera parameter.

## Features
- Text-to-video from `prompt`.
- Image-to-video with `image` as the first frame.
- First-to-last-frame transitions with `last_frame_image`, which must be used together with `image`.
- Resolution with `quality`: `360p`, `540p` (default), `720p` or `1080p`.
- Duration of 5 (default), 8, 10 or 15 seconds.
- Aspect ratio `16:9` (default), `9:16` or `1:1` for text-to-video. It is ignored when `image` or `last_frame_image` is provided.
- `generate_audio_switch`: AI-generated audio including background music, sound effects and character dialogue (default off).
- `generate_multi_clip_switch`: multi-shot generation with scene transitions, for text-to-video and image-to-video only, not transitions (default off).
- `negative_prompt` to avoid elements and `seed` for reproducible generation.

## Use Cases
- **Product and brand videos**: short clips for product pages and ads, with or without generated audio.
- **Animating an existing image**: start the video from a product photo or artwork with `image`.
- **Transitions**: move from one image to another with `image` and `last_frame_image`.
- **Social media clips**: vertical `9:16` or square `1:1` text-to-video.
- **Multi-shot sequences**: several shots with scene transitions in one request using `generate_multi_clip_switch`.

## Visual Examples
Prompt: "A hot air balloon rises slowly over a misty green valley at sunrise"

Settings: `quality` `540p`, `duration` 5, all other fields at their defaults (16:9, no audio, single shot).

[Watch the example video](https://blog.api.market/wp-content/uploads/2026/10/pixverse-v6-output-api-market.mp4)

## Pricing
- Pay As You Go (PAYG) pricing: you only pay for what you use.
- Price: $0.063 per API unit.
- 1 API unit = 1 second of output video at `360p` without audio. The seconds are the `duration` you request.
- Higher resolutions and generated audio count more units per second. Units per request = seconds times the factor below, rounded up to a whole unit per request.
- `generate_multi_clip_switch` does not change the price.
- A request that leaves out `quality` and `generate_audio_switch` uses the defaults (`540p`, no audio) and counts 1.4 units per second.

| `quality` | `generate_audio_switch` | Units per second | 5 s | 8 s | 10 s | 15 s |
|---|---|---|---|---|---|---|
| `360p` | No | 1 | 5 units ($0.315) | 8 units ($0.504) | 10 units ($0.630) | 15 units ($0.945) |
| `360p` | Yes | 1.4 | 7 units ($0.441) | 12 units ($0.756) | 14 units ($0.882) | 21 units ($1.323) |
| `540p` | No | 1.4 | 7 units ($0.441) | 12 units ($0.756) | 14 units ($0.882) | 21 units ($1.323) |
| `540p` | Yes | 1.8 | 9 units ($0.567) | 15 units ($0.945) | 18 units ($1.134) | 27 units ($1.701) |
| `720p` | No | 1.8 | 9 units ($0.567) | 15 units ($0.945) | 18 units ($1.134) | 27 units ($1.701) |
| `720p` | Yes | 2.4 | 12 units ($0.756) | 20 units ($1.260) | 24 units ($1.512) | 36 units ($2.268) |
| `1080p` | No | 3.6 | 18 units ($1.134) | 29 units ($1.827) | 36 units ($2.268) | 54 units ($3.402) |
| `1080p` | Yes | 4.6 | 23 units ($1.449) | 37 units ($2.331) | 46 units ($2.898) | 69 units ($4.347) |

- Worked example: the request above (5 seconds, `540p`, no audio) counts 5 x 1.4 = 7 units = $0.441.
- Worked example: 8 seconds at `1080p` with audio counts 8 x 4.6 = 36.8, rounded up to 37 units = $2.331.
- Failed or cancelled predictions are not billed.
- GET requests to check prediction status (`GET /api/v1/magicapi/cinematic-video-generation-api-pixverse-pixverse-v6/predictions/{id}`) are free and do not count toward API unit usage.
- No monthly subscription fee.

## API Documentation

### Base URL
All API requests go to:
```
https://prod.api.market/api/v1/magicapi/cinematic-video-generation-api-pixverse-pixverse-v6
```

### Authentication
Send your api.market API key in the `x-api-market-key` header on every request:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing
This API is asynchronous:
1. Send a POST request to `/predictions`. A successful request returns **201 Created** with a prediction `id` and a `status` of `starting` or `processing`.
2. Poll `GET /predictions/{id}` (for example once per second).
3. Stop when `status` is `succeeded` (the result is in `output`), `failed` (the reason is in `error`) or `canceled`.

### Endpoints

#### Create Prediction
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/cinematic-video-generation-api-pixverse-pixverse-v6/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "1f6e2dbe1aec42acbb902f4c51785a57d4e0c0bb5e9fb3b430cedddd4a2cbc11",
    "input": {
      "prompt": "A hot air balloon rises slowly over a misty green valley at sunrise",
      "quality": "540p",
      "duration": 5
    }
  }'
```

Response (201 Created):
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "version": "1f6e2dbe1aec42acbb902f4c51785a57d4e0c0bb5e9fb3b430cedddd4a2cbc11",
  "status": "starting",
  "created_at": "2026-10-13T10:31:09.134Z"
}
```

#### Check Prediction Status
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/cinematic-video-generation-api-pixverse-pixverse-v6/predictions/{id}" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

Response when the prediction has finished (200 OK):
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "status": "succeeded",
  "output": "https://blog.api.market/wp-content/uploads/2026/10/pixverse-v6-output-api-market.mp4",
  "error": null,
  "created_at": "2026-10-13T10:31:09.134Z",
  "started_at": "2026-10-13T10:31:10.002Z",
  "completed_at": "2026-10-13T10:31:40.517Z"
}
```

### Input Parameters
| Parameter | Type | Default | Required | Description |
|---|---|---|---|---|
| `prompt` | string | none | Yes | Text prompt for video generation. |
| `image` | string (URI) | none | No | Image to use for the first frame of the video. Optional, can be left out. |
| `last_frame_image` | string (URI) | none | No | Use to generate a video that transitions from the first image to the last image. Must be used with image. Optional, can be left out. |
| `quality` | string | "540p" | No | Resolution of the video. Higher resolutions cost more. See pricing for details. Allowed values: `360p`, `540p`, `720p`, `1080p`. |
| `aspect_ratio` | string | "16:9" | No | Aspect ratio of the video. Only used for text-to-video. Ignored when image or last_frame_image is provided. Allowed values: `16:9`, `9:16`, `1:1`. |
| `duration` | integer | 5 | No | Duration of the video in seconds. Billing is per second. Allowed values: `5`, `8`, `10`, `15`. |
| `negative_prompt` | string | "" | No | Negative prompt to avoid certain elements in the video. |
| `seed` | integer | none | No | Random seed. Set for reproducible generation. Optional, can be left out. |
| `generate_audio_switch` | boolean | false | No | Enable AI-generated audio including BGM, SFX, and character dialogues. |
| `generate_multi_clip_switch` | boolean | false | No | Enable multi-shot generation for cinematic sequences with scene transitions. Only available for text-to-video and image-to-video (not transitions). |

## Status Codes
| Status Code | Meaning |
|---|---|
| 200 OK | Prediction status returned (GET). |
| 201 Created | Prediction created (POST). This is the normal success response; poll the GET endpoint for the result. |
| 400 Bad Request | The input failed validation, for example a missing required field or a value outside the allowed range. |
| 401 Unauthorized | Missing or invalid `x-api-market-key`. |
| 403 Forbidden | The key is valid but has no access to this API. |
| 404 Not Found | No prediction with that ID. |
| 429 Too Many Requests | Rate limit exceeded. |
| 500 Internal Server Error | Server-side error. |
| 503 Service Unavailable | The service is temporarily unavailable. |

## Rate Limits

All plans allow 10 requests per second. Requests above that return `429 Too Many Requests`; back off before retrying and honour any `Retry-After` header. Polling a prediction with GET is free but still counts toward the per-second limit, so poll every 1 to 5 seconds rather than in a tight loop.

## Error Handling
- A non-2xx HTTP status on the POST means the prediction was not created. Read the response body for the reason, fix the input and retry.
- A prediction that was created but could not finish ends with `status: "failed"` and a message in the `error` field. Failed predictions are not billed.
- Retry 429, 500 and 503 responses with exponential backoff.

## Implementation Guide

### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/cinematic-video-generation-api-pixverse-pixverse-v6";

async function run(input) {
  const res = await fetch(`${baseUrl}/predictions`, {
    method: "POST",
    headers: { "Content-Type": "application/json", "x-api-market-key": apiKey },
    body: JSON.stringify({ version: "1f6e2dbe1aec42acbb902f4c51785a57d4e0c0bb5e9fb3b430cedddd4a2cbc11", input }),
  });
  if (res.status !== 201 && res.status !== 200) {
    throw new Error(`API error: ${res.status} ${await res.text()}`);
  }
  const { id } = await res.json();

  const deadline = Date.now() + 10 * 60 * 1000;
  while (Date.now() < deadline) {
    const poll = await fetch(`${baseUrl}/predictions/${id}`, {
      headers: { "x-api-market-key": apiKey },
    });
    const prediction = await poll.json();
    if (prediction.status === "succeeded") return prediction.output;
    if (prediction.status === "failed" || prediction.status === "canceled") {
      throw new Error(`Prediction ${prediction.status}: ${prediction.error || "unknown error"}`);
    }
    await new Promise((r) => setTimeout(r, 1000));
  }
  throw new Error("Timed out after 10 minutes");
}

run({
    "prompt": "A hot air balloon rises slowly over a misty green valley at sunrise",
    "quality": "540p",
    "duration": 5
  }).then(console.log);
```

### Python
```python
import time
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/cinematic-video-generation-api-pixverse-pixverse-v6"

def run(input_data):
    headers = {"Content-Type": "application/json", "x-api-market-key": API_KEY}
    res = requests.post(
        f"{BASE_URL}/predictions",
        headers=headers,
        json={"version": "1f6e2dbe1aec42acbb902f4c51785a57d4e0c0bb5e9fb3b430cedddd4a2cbc11", "input": input_data},
    )
    if res.status_code not in (200, 201):
        raise Exception(f"API error: {res.status_code} {res.text}")
    prediction_id = res.json()["id"]

    deadline = time.time() + 600
    while time.time() < deadline:
        prediction = requests.get(
            f"{BASE_URL}/predictions/{prediction_id}",
            headers={"x-api-market-key": API_KEY},
        ).json()
        if prediction["status"] == "succeeded":
            return prediction["output"]
        if prediction["status"] in ("failed", "canceled"):
            raise Exception(f"Prediction {prediction['status']}: {prediction.get('error')}")
        time.sleep(1)
    raise Exception("Timed out after 10 minutes")

print(run({
    "prompt": "A hot air balloon rises slowly over a misty green valley at sunrise",
    "quality": "540p",
    "duration": 5
}))
```

## Tips
- Start with `360p` or `540p` and 5 seconds while you test prompts, then raise `quality` and `duration` for the final render.
- `aspect_ratio` only applies to text-to-video. With `image`, the output follows the image.
- Turn on `generate_audio_switch` only when you need sound, since it raises the price per second.

## FAQ
1. **Can I combine a last frame with multi-shot?**
   No. `generate_multi_clip_switch` is only available for text-to-video and image-to-video, not for transitions.

2. **Does `last_frame_image` work on its own?**
   No. It must be used with `image`.

3. **How do I get the same result again?**
   Send the same input with the same `seed`.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Generate 360p to 1080p videos of 5 to 15 seconds from text or images with PixVerse V6. Optional generated audio and multi-shot sequences, billed per second.

PixVerse V6 API: Text and Image to Video with Audio

🎥 Cinematic Video Generation API (PixVerse V6)

PAYG

MagicAPI

Create 5 to 15 second videos from text, a first-frame image, or a first and last frame with PixVerse V6, with optional generated audio and multi-shot sequences.