# PixVerse V6 - Core.Today AI API

> PixVerse's flagship video generation model. Generates cinematic videos with synchronized audio, multi-shot sequences with scene transitions, astonishing physics, and precise camera control at up to 1080p.

- **Provider**: PixVerse
- **Model ID**: pixverse/pixverse-v6
- **Category**: Video Generation
- **Credits**: 810 per 5s 540p video, no audio (default) — billed per second by quality x audio: 360p 116/162, 540p 162/209, 720p 209/278, 1080p 417/533 (no-audio/with-audio)
- **Speed**: Medium
- **Quality**: High

## Features
- Synchronized AI audio: BGM, sound effects, and character dialogue
- Multi-shot generation with scene transitions via generate_multi_clip_switch
- Astonishingly realistic physics and precise camera control
- Four resolution tiers from 360p to 1080p
- Image-to-video and first-to-last-frame transitions

## Use Cases
- E-commerce and brand films with storyboarded multi-shot sequences
- Cinematic clips with fully synced BGM, SFX, and dialogue
- Cheap 360p/540p drafts before committing to 1080p finals
- Image-to-video animation of product or key art frames
- Smooth transition videos between a first and last frame

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - Text prompt for video generation

### Optional
- **image**: string - Image to use for the first frame of the video
- **last_frame_image**: string - Generate a video that transitions from the first image to this last image. Must be used with image
- **quality**: string (default: 540p) - Resolution of the video. Higher resolutions cost more per second
  Options: 360p, 540p, 720p, 1080p
- **duration**: integer (default: 5) - Duration of the video in seconds. Billing is per second
  Options: 5, 8, 10, 15
- **aspect_ratio**: string (default: 16:9) - Aspect ratio. Only used for text-to-video; ignored when image or last_frame_image is provided
  Options: 16:9, 9:16, 1:1
- **generate_audio_switch**: boolean (default: false) - Enable AI-generated audio including BGM, SFX, and character dialogues
- **generate_multi_clip_switch**: boolean (default: false) - Enable multi-shot generation for cinematic sequences with scene transitions. Text-to-video and image-to-video only (not transitions)
- **negative_prompt**: string - Negative prompt to avoid certain elements in the video
- **seed**: integer - Random seed. Set for reproducible generation

## Examples

### Storyboarded Brand Film (1080p, Audio, Multi-Clip)
A 15-second multi-shot brand film at the top tier with synced audio
```json
{
  "model": "pixverse/pixverse-v6",
  "input": {
    "prompt": "E-commerce brand film for natural pure cotton loungewear, Japanese minimalist lifestyle aesthetic. Shot 1 (0-4s): warm morning sunlight through floor-to-ceiling windows, a woman in off-white loungewear holds a mug by the window, slow push-in. Shot 2 (4-8s): close-up of fabric texture as a breeze sways the hem, sunlight through the cotton. Shot 3 (8-12s): wide tracking shot as she walks toward a raw wood shelf, soft light and shadow. Shot 4 (12-15s): she sits gazing out the window, negative-space composition, slow pull out and fade. Sound: distant birdsong, fabric rustle, soothing acoustic guitar",
    "quality": "1080p",
    "duration": 15,
    "aspect_ratio": "16:9",
    "generate_audio_switch": true,
    "generate_multi_clip_switch": true
  }
}
```

### Cheap 540p Draft (Silent)
The default tier for fast, low-cost prompt iteration
```json
{
  "model": "pixverse/pixverse-v6",
  "input": {
    "prompt": "A glass of iced tea on a wooden café table, condensation dripping, soft afternoon light, gentle camera orbit",
    "quality": "540p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "generate_audio_switch": false
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- 1080p with audio is the most expensive combination (345/s — over 3x the default rate); iterate at 540p and upgrade only for finals
- Audio adds roughly 30-40% per second at 360p-540p but only 28% at 1080p — check the per-tier table before enabling it
- 360p without audio (75/s) is the cheapest way to test motion and composition
- generate_multi_clip_switch works for text-to-video and image-to-video, but not for first-to-last-frame transitions
- Write storyboard-style prompts (shot-by-shot with timings and camera moves) to get the most out of multi-clip mode

## Documentation
https://replicate.com/pixverse/pixverse-v6