> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PixVerse V6 Text to Video API

> Generate videos from text prompts with PixVerse V6. Flexible 1-15 second durations, native audio, multi-clip output, and cinematic 21:9 aspect ratios.

## Overview

PixVerse V6 Text to Video is a text-to-video API that generates a video from a text prompt with flexible duration and cinematic aspect ratios. Compared to PixVerse V5.5, version 6 unlocks any integer duration from `1` to `15` seconds (instead of fixed `5`, `8`, or `10`) and adds three aspect ratios: `portrait_2_3`, `landscape_3_2`, and `cinematic_21_9`. Native synchronized audio, multi-clip output, and prompt reasoning are all preserved.

### Key capabilities

* **Flexible duration (1-15 seconds)**: any integer length from `1` to `15`, with default `5` (previously fixed to `5`, `8`, or `10`)
* **Extended aspect ratios**: `widescreen_16_9` (default), `classic_4_3`, `square_1_1`, `traditional_3_4`, `social_story_9_16`, plus `portrait_2_3`, `landscape_3_2`, and `cinematic_21_9`
* **Native synchronized audio**: enable `generate_audio_switch` to produce music, sound effects, or dialogue together with the video
* **Multi-clip with dynamic cameras**: enable `generate_multi_clip_switch` for multi-clip output with camera changes in a single generation
* **Prompt reasoning (`thinking_type`)**: choose `enabled` (default), `disabled`, or `auto` to control whether the model rewrites the prompt before rendering
* **Resolutions**: `360p`, `540p`, `720p`, `1080p`
* **Visual styles**: `anime`, `3d_animation`, `clay`, `cyberpunk`, `comic`
* **Async processing**: poll the task endpoint or receive a webhook notification on completion

### Use cases

* **Marketing and ads**: promotional clips in any length that fits the channel, with synchronized audio
* **Cinematic content**: widescreen `cinematic_21_9` sequences for teasers and film-style shots
* **Social content**: vertical `social_story_9_16` or `portrait_2_3` clips for TikTok, Instagram Reels, and YouTube Shorts
* **Short films**: longer 10-15 second sequences with multi-clip camera transitions
* **Stylized shorts**: `anime`, `cyberpunk`, or `clay` looks for art and concept work

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/text-to-video/pixverse-v6" icon="video" href="/api-reference/text-to-video/pixverse-v6/create">
      Generate a video from a text prompt with PixVerse V6
    </Card>

    <Card title="GET /v1/ai/text-to-video/pixverse-v6/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-video/pixverse-v6/task-by-id">
      Get task status and result by ID
    </Card>

    <Card title="GET /v1/ai/text-to-video/pixverse-v6" icon="list" href="/api-reference/text-to-video/pixverse-v6/pixverse-v6-tasks">
      List all PixVerse V6 text-to-video tasks
    </Card>
  </Columns>
</div>

### Parameters

| Parameter                    | Type           | Required | Default           | Description                                                                                                                               |
| ---------------------------- | -------------- | -------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`                     | `string`       | Yes      | -                 | Text prompt describing the video to generate                                                                                              |
| `aspect_ratio`               | `string`       | No       | `widescreen_16_9` | `widescreen_16_9`, `classic_4_3`, `square_1_1`, `traditional_3_4`, `social_story_9_16`, `portrait_2_3`, `landscape_3_2`, `cinematic_21_9` |
| `resolution`                 | `string`       | No       | -                 | Output resolution: `360p`, `540p`, `720p`, `1080p`                                                                                        |
| `duration`                   | `integer`      | No       | `5`               | Video length in seconds. Any integer from `1` to `15`                                                                                     |
| `negative_prompt`            | `string`       | No       | `""`              | Negative prompt for the generation                                                                                                        |
| `style`                      | `string`       | No       | -                 | Visual style: `anime`, `3d_animation`, `clay`, `cyberpunk`, `comic`                                                                       |
| `seed`                       | `integer`      | No       | -                 | Reproducibility seed; same seed + same prompt yields the same video                                                                       |
| `generate_audio_switch`      | `boolean`      | No       | `false`           | When `true`, generates synchronized audio (music, SFX, or dialogue) with the video                                                        |
| `generate_multi_clip_switch` | `boolean`      | No       | `false`           | When `true`, produces multi-clip output with dynamic camera changes in a single generation                                                |
| `thinking_type`              | `string`       | No       | `enabled`         | Prompt reasoning mode: `enabled`, `disabled`, or `auto`                                                                                   |
| `webhook_url`                | `string` (uri) | No       | -                 | Optional callback URL that receives task status notifications                                                                             |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is the difference between PixVerse V6 and PixVerse V5.5 for text to video?">
    PixVerse V6 introduces flexible duration (any integer from `1` to `15` seconds instead of fixed `5`, `8`, or `10`) and three additional aspect ratios: `portrait_2_3`, `landscape_3_2`, and `cinematic_21_9`. Native synchronized audio, multi-clip output, and prompt reasoning work the same as in V5.5.
  </Accordion>

  <Accordion title="Which durations are supported?">
    PixVerse V6 accepts any integer duration from `1` to `15` seconds, with a default of `5`. You are no longer limited to fixed steps, so you can match the exact shot length you need.
  </Accordion>

  <Accordion title="What aspect ratios does PixVerse V6 add?">
    On top of `widescreen_16_9`, `classic_4_3`, `square_1_1`, `traditional_3_4`, and `social_story_9_16`, PixVerse V6 adds `portrait_2_3`, `landscape_3_2`, and `cinematic_21_9` for portrait, landscape, and cinematic framing.
  </Accordion>

  <Accordion title="How does native audio generation work?">
    Set `generate_audio_switch` to `true` and PixVerse V6 produces synchronized audio (background music, sound effects, or dialogue) together with the video in a single request. No separate audio call is required.
  </Accordion>

  <Accordion title="What does thinking_type control?">
    `thinking_type` controls prompt reasoning. `enabled` (default) rewrites the prompt automatically for better results, `disabled` uses the prompt exactly as written, and `auto` lets the model decide based on the input.
  </Accordion>

  <Accordion title="What are the rate limits and pricing?">
    Rate limits and pricing depend on your subscription tier. See [Rate Limits](/ratelimits) and the [Pricing page](/pricing) for current values.
  </Accordion>
</AccordionGroup>

## Best practices

* **Duration selection**: pick the shortest duration that conveys your shot to reduce processing time and cost; reserve 10-15s for narrative sequences
* **Aspect ratio**: use `cinematic_21_9` for film-style shots and `social_story_9_16` or `portrait_2_3` for vertical social formats
* **Audio**: enable `generate_audio_switch` only when you want the model to author audio; otherwise leave it `false` and mix your own track externally
* **Prompt reasoning**: leave `thinking_type` as `enabled` for general prompts; switch to `disabled` when you need literal prompt adherence
* **Production integration**: use `webhook_url` instead of polling for scalable workflows
* **Error handling**: implement retry with exponential backoff for 503 responses

## Related APIs

* **PixVerse V5.5 Text to Video**: prior version with fixed `5`/`8`/`10` second durations and five aspect ratios. See the [PixVerse V5.5 Text to Video overview](/api-reference/text-to-video/pixverse-v5-5/overview).
* **PixVerse V5 Text to Video**: earlier version without audio, multi-clip, or 10-second support. See the [PixVerse V5 Text to Video overview](/api-reference/text-to-video/pixverse-v5/overview).
* **PixVerse V6 (image-to-video)**: animate an existing image or interpolate a first/last frame transition. See the [PixVerse V6 overview](/api-reference/image-to-video/pixverse-v6/overview).