# PixVerse V6 API

> PixVerse's latest video model — stylized, high-motion text- and image-to-video.

- **Provider**: PixVerse
- **Model id**: `pixverse-v6`
- **Modality**: video
- **Price**: 2.32–8.35 credits /sec

## Overview

PixVerse V6 is called in two steps: create a generation task, then poll the task until the result is ready.

## Authentication

All requests require a Bearer Token in the request header:

```
Authorization: Bearer YOUR_API_KEY
```

## Create Task

`POST https://you.bot/api/v1/generate`

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| modelId | string | Yes | Model id: `pixverse-v6` |
| input | object | Yes | Input parameters object (see below) |
| callbackUrl | string | No | https URL we POST the finished task to. Signed with `X-Webhook-Signature` once you create a webhook signing key in Dashboard → Settings |

### input object parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| prompt | string | Yes | Text value (example: Create a **15-second photorealistic cinematic jazz performance**, 16:9, 1080p, with synchronized audio. Inside a dark upscale underground jazz club, a… — full value in the request example) |
| quality | string | Yes | Options: 360p \| 540p \| 720p \| 1080p (default: 720p) |
| duration | number | Yes | Range 1-15 (default: 5) |
| aspect_ratio | string | Yes | Options: 16:9 \| 4:3 \| 1:1 \| 3:4 \| 9:16 \| 21:9 (default: 16:9) |
| generate_audio_switch | boolean | No | True/false (default: false) |
| seed | number | No | Text value |
| generate_multi_clip_switch | boolean | No | True/false (default: false) |

### Request example

```json
{
  "modelId": "pixverse-v6",
  "input": {
    "prompt": "Create a **15-second photorealistic cinematic jazz performance**, 16:9, 1080p, with synchronized audio.\n\nInside a dark upscale underground jazz club, a charismatic drummer in a black shirt performs an intense drum solo under warm amber spotlights.\n\nThe audience surrounds the small stage in soft darkness. Atmospheric haze, polished wood, brass instruments and warm table lamps create a sophisticated late-night mood.\n\nKeep the same drummer, drum kit, clothing and club environment consistent across all shots.\n\n**0–4s — BUILDUP**\nWide audience-level shot.\n\nThe drummer begins a controlled groove on snare, hi-hat and kick drum.\n\nCamera slowly pushes toward the stage.\n\nHis shoulders, arms and head move naturally with the rhythm.\n\nAudio: live acoustic drums, subtle crowd ambience and room reverb.\n\n**4–8s — PERFORMANCE**\nClean cut to a close side angle.\n\nThe drummer accelerates into a powerful solo.\n\nDrumsticks visibly strike the snare and toms; each hit creates natural stick rebound and drum-head vibration.\n\nCamera tracks smoothly around the drum kit.\n\nCymbals physically vibrate after each strike.\n\nEvery visible impact should synchronize with the drum sound.\n\n**8–12s — CLIMAX**\nClean cut to a dramatic low angle near the floor tom.\n\nFast tom fills build toward the climax.\n\nThe drummer leans into the performance with intense concentration, sweat visible under the warm light.\n\nCamera performs a controlled arc around him while the audience and stage lights move naturally in the background.\n\n**12–15s — FINALE**\nCut to a frontal medium-wide shot.\n\nThe drummer performs one final rapid fill and strikes the crash cymbal with a powerful final hit.\n\nThe cymbal flexes and vibrates naturally.\n\nCamera rapidly pushes toward his face as the final sound rings through the club.\n\nThe audience erupts into applause.\n\nHe exhales, lowers the sticks and gives a subtle satisfied smile.\n\nCut to black.\n\n**STYLE**\nPhotorealistic live action, premium music-film cinematography, expressive performance, realistic skin and sweat, warm amber lighting, deep shadows, atmospheric haze, shallow depth of field, natural motion blur.\n\n**PRIORITY**\nRealistic drumstick contact, believable body rhythm, synchronized impact audio, expressive character performance and cinematic camera movement.\n\nNo extra limbs, warped drumsticks, floating objects, broken instruments, random cuts, subtitles, text, logos or watermark.",
    "quality": "720p",
    "duration": 4,
    "aspect_ratio": "16:9",
    "generate_audio_switch": false,
    "seed": 1,
    "generate_multi_clip_switch": false
  }
}
```

### Response example

```json
{
  "taskId": "281e5b0…f39b9",
  "creditsCharged": 20.88
}
```

## Query Task

`GET https://you.bot/api/v1/task/{taskId}?model=pixverse-v6`

When `state` is `success`, the output is in `resultUrls`: `{ "state": "success", "resultUrls": [ ... ] }`. (Text models return inline in the create response.)

## Error Codes

| Code | Description |
|------|-------------|
| 200 | Request successful |
| 400 | Invalid request parameters |
| 401 | Authentication failed — check API Key |
| 402 | Insufficient account balance |
| 403 | IP not allowed for this key, or the key is restricted to other models |
| 404 | Task not found, or it has expired |
| 409 | Duplicate request — an identical submit arrived moments ago. Nothing was charged; retry is safe |
| 413 | Payload too large — see the character and file-size limits for this model |
| 429 | Rate limit exceeded — retry after the Retry-After header |
| 500 | Internal server error |
| 504 | Upstream timed out — nothing was delivered; retry is safe |