> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # PixVerse V6 Max Text to Video > The PixVerse V6 Max Text to Video API generates 1–15 second videos from a prompt at 360p to 1080p, with eight aspect ratios and an optional native audio track. > [!TIP] > > 1. After submission, a `task_id` will be returned. If you provided a `callback_url`, when the task status becomes `finished` or `failed`, a POST request will be sent to the `callback_url`. > 2. Regardless of whether `callback_url` is provided, you can retrieve the result through the unified [Query Task Status](https://docs.vidgo.ai/api-manual/task-management/status.md) endpoint. PixVerse V6 Max Text to Video turns a prompt into a 1–15 second video at 360p to 1080p, with an optional native audio track for dialogue, effects and music. Low resolutions make quick, inexpensive drafts; 1080p with audio suits finished social ads, short-drama scenes and cinematic `21:9` teasers. PixVerse V6 Max is the Max tier of PixVerse V6, added to PixVerse's API for text-to-video and image-to-video in October 2026. Vidgo exposes two model IDs: [Text to Video](https://docs.vidgo.ai/api-manual/video-series/pixverse-v6-max-text-to-video.md) and [Image to Video](https://docs.vidgo.ai/api-manual/video-series/pixverse-v6-max-image-to-video.md). ## Models * **pixverse/v6-max/text-to-video** — Text-to-video with PixVerse V6 Max, 1–15 seconds, 360p to 1080p, optional audio. ## Features * Text-to-video from a single prompt. * Durations from 1 to 15 seconds in one-second steps. * Four resolutions: `360p`, `540p`, `720p` and `1080p`. * Optional native audio track with `audio: true`. * Eight aspect ratios, including `21:9`, `2:3` and `3:2`. ## Required parameters * `prompt` (string): The scene, the action and the camera. With `audio` on, put dialogue in quotes and name the speaker. Must not be blank; up to 5,000 characters. ## Optional parameters * `duration` (integer): Output length, `1`–`15` whole seconds. Default `5`. * `resolution` (string): `360p`, `540p`, `720p` or `1080p`. Default `540p`. * `audio` (boolean): Add a native audio track. Default `false`. * `aspect_ratio` (string): `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `2:3`, `3:2` or `21:9`. When omitted, the upstream default (16:9) applies. ## Output The finished task returns one MP4 video in the `files` array of [Query Task Status](https://docs.vidgo.ai/api-manual/task-management/status.md) and the callback payload. ## Examples * **5-second 540p silent draft**: a quick `16:9` preview at the default resolution, `audio: false`. * **10-second vertical 1080p clip with dialogue**: quoted dialogue plus ambience in the prompt, `9:16`, `audio: true` and a `callback_url`. ## Notes * This ID accepts text only; `image_urls` returns 400. To animate an image, use [PixVerse V6 Max Image to Video](https://docs.vidgo.ai/api-manual/video-series/pixverse-v6-max-image-to-video.md). * PixVerse V6 Max on Vidgo takes text or exactly one image. First/last frame, video input, extend, reference-to-video and `seed` are not available. * A `null` value for `duration`, `resolution` or `audio` counts as the default. * `model` and `callback_url` belong at the request root, not inside `input`. * Credits are reserved at submission and depend on `resolution`, `audio` and `duration` (per output second); turning on `audio` raises the rate. A failed task is refunded in full. See the [pricing page](https://vidgo.ai/apis/api-pricing) for current rates. ## OpenAPI ````yaml api-manual/video-series/pixverse-v6-max-text-to-video.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - PixVerse V6 Max Text to Video description: >- The PixVerse V6 Max Text to Video API generates 1–15 second videos from a prompt at 360p to 1080p, with eight aspect ratios and an optional native audio track. version: 1.0.0 servers: - url: https://api.vidgo.ai description: Production server security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Video Series summary: PixVerse V6 Max Text to Video description: >- Send only the `input` fields listed for this model. Any other field, including `image_urls`, returns 400. operationId: submit_pixverse_v6_max_text_to_video requestBody: required: true content: application/json: schema: type: object required: - model - input properties: model: type: string description: Model ID. Use `pixverse/v6-max/text-to-video`. example: pixverse/v6-max/text-to-video callback_url: type: string format: uri nullable: true description: >- Optional public HTTP(S) endpoint that receives a POST when the task becomes `finished` or `failed`. HTTPS is recommended. Omit it, or send `null` or an empty string, to disable callbacks. example: https://your-domain.com/callback input: type: object required: - prompt properties: prompt: type: string minLength: 1 maxLength: 5000 example: >- A street dancer spins under a flickering neon sign in the rain, low-angle tracking shot description: >- Describe the scene, the action and the camera. With `audio` on, put dialogue in quotes and name the speaker, and describe ambience or music. Must not be blank; up to 5,000 characters. duration: type: integer minimum: 1 maximum: 15 default: 5 description: >- Output length in whole seconds. `null` counts as the default. resolution: type: string enum: - 360p - 540p - 720p - 1080p default: 540p description: >- Output resolution. It sets the billing rate. `null` counts as the default. aspect_ratio: type: string enum: - '16:9' - '9:16' - '4:3' - '3:4' - '1:1' - '2:3' - '3:2' - '21:9' description: >- Output aspect ratio. When omitted, the upstream default (16:9) applies. audio: type: boolean default: false description: >- Add a native audio track (dialogue, effects, music). It changes the billing rate. `null` counts as the default. additionalProperties: false description: Generation parameters. examples: draft: summary: 5-second 540p silent draft value: model: pixverse/v6-max/text-to-video input: prompt: >- A street dancer spins under a flickering neon sign in the rain, low-angle tracking shot duration: 5 resolution: 540p aspect_ratio: '16:9' audio: false dialogue: summary: 10-second vertical 1080p clip with dialogue value: model: pixverse/v6-max/text-to-video callback_url: https://your-domain.com/callback input: prompt: >- Two friends share an umbrella at a bus stop at night. The woman laughs and says: "You forgot yours again?" Rain patters on the umbrella, distant traffic. duration: 10 resolution: 1080p aspect_ratio: '9:16' audio: true responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 description: HTTP status code. data: type: object required: - task_id - status - created_time properties: task_id: type: string description: >- Task ID. Use it with [Query Task Status](/api-manual/task-management/status). status: type: string enum: - not_started description: Initial task status. created_time: type: string format: date-time description: Time the task was created (ISO 8601). example: code: 200 data: task_id: task-unified-1762160000-abc123 status: not_started created_time: '2026-11-03T10:30:00' '400': description: >- Invalid input, unsupported field, inaccessible media, or insufficient credits content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '401': description: Invalid credentials content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '429': description: Rate or API key credit limit exceeded content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '500': description: Internal error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '502': description: Unable to create the upstream generation task content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '503': description: The requested model is temporarily unavailable content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- All API endpoints require Bearer Token authentication Get your API Key: Go to **Dashboard → API Key** ([API Key Management Page](https://vidgo.ai/apis/dashboard/api-key)) to get your API Key Add it to the request header: ``` Authorization: Bearer VIDGO_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.