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

> Generate videos from text prompts with PixVerse V5. Control aspect ratio, resolution, duration, and visual style. 5 or 8 second output for social and marketing.

## Overview

PixVerse V5 Text to Video is a text-to-video API that generates a video directly from a text prompt, with no input image required. Describe the scene in `prompt` and control the output with aspect ratio, resolution, duration, and visual style. It produces 5 or 8 second clips at up to 1080p, making it a fast option for social content, ads, and concept work.

### Key capabilities

* **Text-only generation**: create a video from a `prompt` alone, no source image needed
* **Duration (5 or 8 seconds)**: `5` (default) or `8`; 8-second videos cost double, and 1080p output is limited to 5 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`
* **Negative prompt and seed**: refine output with `negative_prompt` and reproduce results with `seed`
* **Async processing**: poll the task endpoint or receive a webhook notification on completion

### Use cases

* **Marketing and ads**: short promotional clips generated straight from a copy line or brief
* **Social content**: vertical `social_story_9_16` clips for TikTok, Instagram Reels, and YouTube Shorts
* **Concept and pitching**: quick visual drafts from a written idea before committing to production
* **Stylized shorts**: `anime`, `cyberpunk`, or `clay` looks for art and design work
* **Prototyping**: fast iteration on prompt and style variations with a fixed `seed`

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

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

    <Card title="GET /v1/ai/text-to-video/pixverse-v5" icon="list" href="/api-reference/text-to-video/pixverse-v5/pixverse-v5-tasks">
      List all PixVerse V5 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` or `8`. 8s costs double; 1080p is limited to 5s           |
| `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                    |
| `webhook_url`     | `string` (uri) | No       | -                 | Optional callback URL that receives task status notifications                          |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is PixVerse V5 Text to Video and how does it work?">
    PixVerse V5 Text to Video generates a video from a text `prompt` without any input image. You submit the prompt and optional controls, receive a task ID immediately, then poll the task endpoint or receive a webhook notification when the video is ready.
  </Accordion>

  <Accordion title="Do I need an input image?">
    No. This is a text-only endpoint: the video is generated entirely from your `prompt`. To animate from an existing image, use an image-to-video PixVerse endpoint instead.
  </Accordion>

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

  <Accordion title="What aspect ratios are available?">
    Five ratios: `widescreen_16_9` (default), `classic_4_3`, `square_1_1`, `traditional_3_4`, and `social_story_9_16`. Use `social_story_9_16` for vertical social formats.
  </Accordion>

  <Accordion title="How do I reproduce the same video?">
    Pass the same `seed` together with the same `prompt` and model version. Identical inputs produce the same video every time, which is useful for controlled iteration.
  </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

* **Prompt detail**: describe subject, setting, motion, and mood explicitly for stronger, more controllable results
* **Duration selection**: use `5` seconds for most shots to reduce cost; reserve `8` seconds when the extra length is needed
* **Resolution vs duration**: request 1080p only for 5-second clips; use 720p or lower for 8-second output
* **Style consistency**: set a single `style` per project and keep `seed` fixed to compare prompt variations
* **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**: adds native audio, multi-clip output, prompt reasoning, and 10-second duration. See the [PixVerse V5.5 Text to Video overview](/api-reference/text-to-video/pixverse-v5-5/overview).
* **PixVerse V6 Text to Video**: adds flexible 1-15 second durations and extra aspect ratios. See the [PixVerse V6 Text to Video overview](/api-reference/text-to-video/pixverse-v6/overview).
* **PixVerse V5 (image-to-video)**: animate an existing image instead of generating from text. See the [PixVerse V5 overview](/api-reference/image-to-video/pixverse/overview).