---
title: "PixVerse V6 - Create video from text"
method: POST
path: "/v1/ai/text-to-video/pixverse-v6"
tags: ["text-to-video"]
---

# PixVerse V6 - Create video from text

`POST /v1/ai/text-to-video/pixverse-v6`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/text-to-video/pixverse-v6`
- Auth: API key in header `x-magnific-api-key`

Generate a video from a text prompt using the PixVerse-V6 text-to-video model.

Compared to PixVerse-V5.5, version 6 adds:
- Flexible duration: any integer from `1` to `15` seconds (previously fixed to `5`, `8` or `10`).
- Extended aspect ratios: `2:3`, `3:2` and `21:9` in addition to `16:9`, `4:3`, `1:1`, `3:4` and `9:16`.

Existing PixVerse-V5.5 features are kept: native audio (`generate_audio_switch`), multi-clip output (`generate_multi_clip_switch`) and prompt reasoning enhancement (`thinking_type`).

## Request body

- Request10
  - `prompt` string, required: Text prompt describing the video to generate.
  - `aspect_ratio` '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': The aspect ratio of the generated video
  - `resolution` '360p' | '540p' | '720p' | '1080p': The resolution of the generated video
  - `duration` integer: Duration of the generated video in seconds. PixVerse-V6 accepts any integer value from `1` to `15` (PixVerse-V5.5 only accepted `5`, `8` or `10`).
  - `negative_prompt` string: Negative prompt to be used for the generation.
  - `style` 'anime' | '3d_animation' | 'clay' | 'cyberpunk' | 'comic': The style of the generated video
  - `seed` integer: The same seed and the same prompt given to the same version of the model will output the same video every time.
  - `generate_audio_switch` boolean: When set to `true`, PixVerse-V6 generates synchronized audio (background music, sound effects, or dialogue) together with the video.
  - `generate_multi_clip_switch` boolean: When set to `true`, PixVerse-V6 produces multi-clip output with dynamic camera changes within a single generation.
  - `thinking_type` 'enabled' | 'disabled' | 'auto': Prompt reasoning enhancement mode. Controls how PixVerse-V5.5 optimizes the input prompt before generation. * `enabled` - The model rewrites the prompt automatically for better results. * `disabled` - The prompt is used exactly as written, with no rewriting. * `auto` - The model decides whether to rewrite the prompt based on the input.
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

## Response `200`

OK

- GetStyleTransferTaskStatus200Response
  - `data` TaskDetail, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)
