> ## 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 V5.5 Text to Video API

> Generate videos from text prompts with PixVerse V5.5. Native synchronized audio, multi-clip output, prompt reasoning, and 5, 8, or 10 second durations.

## Overview

PixVerse V5.5 Text to Video is a text-to-video API that generates a video from a text prompt with native synchronized audio and multi-clip output. Compared to PixVerse V5, version 5.5 adds `generate_audio_switch` for background music, sound effects, or dialogue, `generate_multi_clip_switch` for dynamic camera changes within one generation, `thinking_type` prompt reasoning, and a 10-second duration option.

### Key capabilities

* **Native synchronized audio**: enable `generate_audio_switch` to produce audio (music, SFX, 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
* **Duration (5, 8, or 10 seconds)**: `5` (default), `8`, or `10`; 8s costs double, 10s is available up to 720p, and 1080p is limited to 5 or 8 seconds
* **Resolutions**: `360p`, `540p`, `720p`, `1080p`
* **Aspect ratios**: `widescreen_16_9` (default), `classic_4_3`, `square_1_1`, `traditional_3_4`, `social_story_9_16`
* **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**: short promotional clips with synchronized audio generated from a brief
* **Social content**: vertical `social_story_9_16` clips with sound for TikTok, Instagram Reels, and YouTube Shorts
* **Story sequences**: multi-clip output with camera changes for teasers and narrative shorts
* **Stylized shorts**: `anime`, `cyberpunk`, or `clay` looks for art and concept work
* **Prototyping**: iterate on prompt and audio variations before production

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

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

    <Card title="GET /v1/ai/text-to-video/pixverse-v5-5" icon="list" href="/api-reference/text-to-video/pixverse-v5-5/pixverse-v5-5-tasks">
      List all PixVerse V5.5 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`                |
| `resolution`                 | `string`       | No       | -                 | Output resolution: `360p`, `540p`, `720p`, `1080p`                                                    |
| `duration`                   | `integer`      | No       | `5`               | Video length in seconds: `5`, `8`, or `10`. 8s costs double; 10s up to 720p; 1080p limited to 5 or 8s |
| `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 V5.5 and PixVerse V5 for text to video?">
    PixVerse V5.5 adds native synchronized audio (`generate_audio_switch`), multi-clip output (`generate_multi_clip_switch`), prompt reasoning (`thinking_type`), and a 10-second duration option. PixVerse V5 supports only 5 or 8 second durations with no audio or multi-clip.
  </Accordion>

  <Accordion title="How does native audio generation work?">
    Set `generate_audio_switch` to `true` and PixVerse V5.5 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 generate_multi_clip_switch do?">
    When set to `true`, PixVerse V5.5 produces multi-clip output with dynamic camera changes inside a single generation, simulating cuts and camera moves without stitching multiple requests.
  </Accordion>

  <Accordion title="Which durations and resolutions are supported?">
    PixVerse V5.5 supports `5` (default), `8`, or `10` second durations and resolutions of `360p`, `540p`, `720p`, and `1080p`. 8-second videos cost double, 10-second videos are available up to 720p, and 1080p is limited to 5 or 8 seconds.
  </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

* **Audio**: enable `generate_audio_switch` only when you want the model to author audio; if you have your own track, leave it `false` and mix externally
* **Duration selection**: use `5` seconds for most shots to reduce cost; request 10s only at 720p or lower
* **Prompt reasoning**: leave `thinking_type` as `enabled` for general prompts; switch to `disabled` when you need literal prompt adherence
* **Multi-clip**: enable `generate_multi_clip_switch` for narrative sequences that benefit from camera changes
* **Production integration**: use `webhook_url` instead of polling for scalable workflows
* **Error handling**: implement retry with exponential backoff for 503 responses

## Related APIs

* **PixVerse V6 Text to Video**: adds flexible 1-15 second durations and extra aspect ratios (`portrait_2_3`, `landscape_3_2`, `cinematic_21_9`). See the [PixVerse V6 Text to Video overview](/api-reference/text-to-video/pixverse-v6/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 V5.5 (image-to-video)**: animate an existing image instead of generating from text. See the [PixVerse V5.5 overview](/api-reference/image-to-video/pixverse-v5-5/overview).