PixVerse V6 Max Text to Video API

pixverse/v6-max/text-to-video

360p–1080p · 1–15 sec

PixVerse V6 Max Text to Video turns a prompt into 1–15 second videos at 360p to 1080p, with eight aspect ratios and an optional native audio track for dialogue, effects and music. Describe subjects, actions and sound in one prompt, then pick the length and format for each placement.

Input

Prompt310/5000

Duration

Resolution

Aspect Ratio

Audio

OutputExample

Continue with

PixVerse V6 Max Image to Video MiniMax H3 Max Text to Video Seedance 2.5 Text to Video

REST API

Quick Start

Make your first PixVerse V6 Max text-to-video request in three steps; the example returns a task_id for result retrieval.

Connect to the Vidgo API

Create an API key, keep it on your server, and send it in the Authorization header as a Bearer token.

Endpoint: POSThttps://api.vidgo.ai/api/generate/submit
Authentication: Authorization: Bearer VIDGO_API_KEY

Submit one generation task

Run the short example with a prompt; audio is turned on so the dialogue line is spoken.

Submit request

curl --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "pixverse/v6-max/text-to-video",
  "input": {
    "prompt": "A late-night ramen stall in a narrow alley. The cook lifts noodles from the steaming pot, shakes them twice and lays them into a bowl as a customer at the counter says, \"That smells perfect.\" Neon reflections on wet pavement, sizzling broth and distant traffic. Handheld medium shot, slow push toward the bowl.",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": true
  }
}'

Wait for the result

Use the returned task_id to check the same task until it reaches finished or failed. On success, read data.files[].file_url.

Track status

GET https://api.vidgo.ai/api/generate/status/{task_id}

Poll about every 2 seconds while the status is not_started or running. Stop on finished or failed; on success, read data.files[].file_url. For long-running jobs, increase the interval gradually, or add callback_url to the submit request to receive the final result asynchronously.

not_startedrunningfinishedfailed

Submit response

{
  "code": 200,
  "data": {
    "task_id": "GDQ2FNCL1HB9O7TU",
    "status": "not_started",
    "created_time": "2026-11-05T07:08:09"
  }
}

Finished response

{
  "code": 200,
  "data": {
    "task_id": "GDQ2FNCL1HB9O7TU",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/pixverse/v6-max/text-to-video/v2/01/output-01.mp4",
        "file_type": "video"
      }
    ],
    "created_time": "2026-11-05T07:08:09",
    "error_message": null,
    "progress": 100
  }
}

Complete runnable example

Open this after the three-step flow is clear. It combines submission, polling, terminal-state handling, and result extraction in one script.

Complete runnable example

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "pixverse/v6-max/text-to-video",
  "input": {
    "prompt": "A late-night ramen stall in a narrow alley. The cook lifts noodles from the steaming pot, shakes them twice and lays them into a bowl as a customer at the counter says, \"That smells perfect.\" Neon reflections on wet pavement, sizzling broth and distant traffic. Handheld medium shot, slow push toward the bowl.",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": true
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

while true; do
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep 2
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done

Request Parameters

model and callback_url belong at the request root; generation parameters belong inside input.

Field	Type	Required	Default	Description
model	string	Yes	—	Fixed to pixverse/v6-max/text-to-video.
callback_url	string (URL)	No	—	A public HTTP(S) URL for receiving task completion notifications.
input	object	Yes	—	Generation parameters: a required prompt plus optional duration, resolution, aspect ratio and audio.
input.prompt	string	Yes	—	Scene, action and sound description, up to 5,000 characters, not blank.
input.duration	integer	No	5	Output length in whole seconds, 1–15.
input.resolution	string	No	540p	360p, 540p, 720p or 1080p. The rate per second follows this value and audio.
input.aspect_ratio	string	No	—	16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 or 21:9.
input.audio	boolean	No	false	Set true to add a native audio track with dialogue, effects and music described in the prompt.

Response Fields

Submission returns the task identity immediately. Status responses add progress, output files, or a failure message as the task advances.

Field	Type	Description
code	integer	Application result code. Successful responses use 0 or 200.
message	string	Human-readable response or error message when present.
data.task_id	string	Task identifier used in the status endpoint path.
data.status	string	Current state: not_started, running, finished, or failed.
data.created_time	string	Task creation time in date-time format.
data.progress	number	Completion percentage when the provider reports progress.
data.files[]	array	Generated output files returned after a successful task.
data.files[].file_url	string	Public URL of the generated video.
data.files[].file_type	string	Generated file type, such as video.
data.files[].watermark_url	string \| null	Watermarked output URL when one is available.
data.error_message	string \| null	Failure detail when status is failed.

Task Lifecycle

Treat not_started and running as non-terminal states. finished and failed are terminal alternatives; stop polling when either is returned.

not_started
The task has been accepted and is queued to start.
running
The video is being generated. Continue polling the status endpoint.
finished
The task is complete. Read the video URL from data.files[].file_url.
failed
Generation failed. Read data.error_message for details and stop polling.

Polling and Errors

Authentication401 indicates a missing or invalid Bearer API Key. Check your key in the dashboard before retrying.
Validation400 indicates invalid parameters. Check that the prompt is present and within 5,000 characters and that image_urls is not sent.
Polling intervalPoll the status every 2 seconds. For longer tasks, use exponential backoff to gradually increase the interval to 5 seconds.
Terminal statesPoll only while the status is not_started or running. Stop immediately on finished or failed.
Callback optionProvide callback_url to receive an automatic notification when generation finishes, without continuous polling.

Model Specifications

Specification	Value	Description
Model	pixverse/v6-max/text-to-video	Model identifier for asynchronous PixVerse V6 Max text-to-video generation.
Aspect ratio	16:9 \| 9:16 \| 4:3 \| 3:4 \| 1:1 \| 2:3 \| 3:2 \| 21:9	Optional.
Duration	1–15	Whole seconds; defaults to 5.
Resolution	360p \| 540p \| 720p \| 1080p	Defaults to 540p.
Audio	audio: true \| false	Defaults to false; true adds a native audio track.
Pricing	4.8–22.4 credits/s	By resolution and audio, multiplied by duration.

View the PixVerse V6 Max Text to Video API documentation

PixVerse V6 Max Text to Video

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. The text endpoint builds a scene from your prompt alone and lets you choose from 16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 and 21:9. Low-cost 360p and 540p tiers suit drafts, while 720p and 1080p serve publishing, with or without sound.

Why choose the PixVerse V6 Max Text to Video API?

Eight aspect ratiosFrom 21:9 cinematic to 9:16 vertical and 2:3 portrait, pick the format per placement.
Optional native audioSet audio to true for dialogue, sound effects and music described in the same prompt.
1 to 15 secondsChoose any whole length, from a one-second loop to a 15-second scene.
Low-cost draft tiers360p starts at 4.8 credits per second, so prompt iterations stay cheap before a 1080p final.

Parameters

Parameter	Requirement	Description
prompt	Required	Scene, action and sound description, up to 5,000 characters, not blank. Default`—`
duration	Optional	Output length in whole seconds, 1–15. Default`5`
resolution	Optional	360p, 540p, 720p or 1080p. The rate per second follows this value and audio. Default`540p`
aspect_ratio	Optional	16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 or 21:9. Default`—`
audio	Optional	Set true to add a native audio track with dialogue, effects and music described in the prompt. Default`false`

How to Use

Write the sceneDescribe the subject, setting, action and camera in one prompt of up to 5,000 characters.
Add sound if neededSet audio to true and put dialogue in quotes with the speaker, plus ambience or music.
Pick format and lengthChoose an aspect ratio, 1–15 seconds and 360p to 1080p; the price updates on the Run button.
Submit and collect the videoSend the request to receive a task_id, then poll the status endpoint or use callback_url.

Usage and billing

PixVerse V6 Max Text to Video is billed per output second; the rate depends on resolution and whether audio is on.

Usage	Rate	Details
360p	4.8 / 7.2 credits / second	Silent / with audio: $0.024 / $0.036 per second, for quick drafts.
540p	7.2 / 8.8 credits / second	Silent / with audio: $0.036 / $0.044 per second. The default; 5 silent seconds cost 36 credits.
720p	8.8 / 12 credits / second	Silent / with audio: $0.044 / $0.060 per second.
1080p	17.6 / 22.4 credits / second	Silent / with audio: $0.088 / $0.112 per second. 15 seconds with audio cost 336 credits.

Best Use Cases

Dialogue scenes with soundWrite short-drama beats with spoken lines and ambience in one request.
Vertical social adsRender 9:16 at 540p or 720p for feeds and stories.
Cinematic teasersUse 21:9 for trailers and banner placements.
Cheap concept previewsExplore ideas at 360p, then re-render the chosen prompt at 1080p.

Pro Tips

Put spoken lines in quotes and name the speaker, for example: the barista says, "Your order is ready."
Describe one main action and one camera move per clip for clearer motion.
Match the aspect ratio to the placement before generating rather than cropping afterwards.
Leave audio off while iterating on visuals; turn it on for the final pass.

Notes

prompt is required for this endpoint and accepts up to 5,000 characters.
To start from an image, use PixVerse V6 Max Image to Video.
Tasks run asynchronously: a successful submission returns a task_id for polling or callback delivery.

Related Models

PixVerse V6 Max Image to VideoPixVerse V6 Max Image to Video animates one JPEG, PNG or WebP image into a 1–15 second video at 360p to 1080p, with an optional native audio track. The image sets the subject and framing, and a prompt of up to 2,048 characters directs motion, camera and sound.

OmniHuman 2.0 Audio to VideoOmniHuman 2.0 Audio to Video turns one character image and 4–300 seconds of speech or music into a 720p video, with lips, expression and gestures following the audio. The image keeps the character's look and framing, while an optional prompt adds camera moves and actions.

FLUX 3 Max Text to VideoFLUX 3 Max Text to Video turns a written shot into a 5–20 second 720p or 1080p video with native audio and eight aspect ratios. It follows the camera moves, lighting and sound cues you describe, so one prompt returns picture and audio together.

FLUX 3 Max Image to VideoFLUX 3 Max Image to Video animates a start image into a 5–20 second 720p or 1080p clip with native audio, optionally landing on an end frame you supply. It keeps the composition, subject and palette of your images while adding the motion and sound in the prompt.

FLUX 3 Max Keyframes to VideoFLUX 3 Max Keyframes to Video turns 1–10 images pinned to exact frames into a single 5–20 second 720p or 1080p clip with native audio. Each image appears at the frame_index you set on a 24 fps timeline, so the story beats land where you planned them.

Kling 4.0 Text to VideoKling 4.0 Text to Video turns a prompt or multi-shot script into one 3–30 second 720p or 1080p video with stereo audio and five aspect ratios. It keeps scenes coherent across long takes and shot changes while following your camera, dialogue and sound directions.

Kling 4.0 Image to VideoKling 4.0 Image to Video animates a start image into a 3–30 second 720p or 1080p video with stereo audio, optionally finishing on an end frame you choose. It keeps the subject, framing and look of your image while adding the motion, camera work and sound in your prompt.

Kling 4.0 Reference to VideoKling 4.0 Reference to Video turns reference images, videos and reusable elements into a 3–30 second 720p or 1080p video with stereo audio, cited as @Image1, @Video1 or @Element1. It keeps characters, products and settings consistent with your references inside the new scene you describe.

Kling 4.0 Video EditKling 4.0 Video Edit transforms an existing 3–30 second video from a written instruction, restyling scenes, swapping objects or adding elements at 720p or 1080p. It keeps the original timing, people and camera path that you ask to preserve while applying the change across every frame.

Vidu Q4 Image to VideoVidu Q4 Image to Video turns one start image and an optional motion prompt into a 3–16 second clip at 540p up to 4K. Your image sets the opening frame, so subject, setting and aspect ratio carry through while the prompt directs movement and camera.

Vidu Q4 Reference to VideoVidu Q4 Reference to Video combines a prompt with up to 12 reference images and 3 voice clips into 3–16 second videos at up to 4K. Tag each reference in the prompt to keep characters, products and places recognisable, with optional generated audio at no extra cost.

Gemini Omni 1.1 Flash Text-to-Video preview

Gemini Omni 1.1 Flash Text-to-VideoGemini Omni 1.1 Flash Text-to-Video. Create 4–10 second videos with native audio from text, directing camera, lighting, and sound.

Gemini Omni 1.1 Flash Image-to-Video preview

Gemini Omni 1.1 Flash Image-to-VideoGemini Omni 1.1 Flash Image-to-Video. Animate a start image with native audio and add an optional end frame to guide the closing shot.

Gemini Omni 1.1 Flash Reference-to-Video preview

Gemini Omni 1.1 Flash Reference-to-VideoGemini Omni 1.1 Flash Reference-to-Video. Use 1–7 images to guide characters, products, and style in new video scenes with sound.

Gemini Omni 1.1 Flash Video Edit preview

Gemini Omni 1.1 Flash Video EditGemini Omni 1.1 Flash Video Edit. Edit 3–10 second videos through natural language with up to 5 reference images for visual guidance.

MiniMax H3 Max Turbo Text to Video preview

MiniMax H3 Max Turbo Text to VideoMiniMax H3 Max Turbo Text to Video turns text into coherent 5–15 second videos with synchronized native stereo audio and fast generation. It follows physical motion while rendering subtle changes in light and shadow.

PixVerse V6 Max Text to Video API FAQ

What is the PixVerse V6 Max Text to Video API?

PixVerse V6 Max Text to Video is a PixVerse model for generating video from text prompts. It creates 1–15 second clips at 360p to 1080p in eight aspect ratios, with an optional native audio track for dialogue, effects and music. Everything in the shot, from characters and setting to camera and sound, comes from the prompt you write. You can call it programmatically or try it from the playground above.

How do I add dialogue to PixVerse V6 Max Text to Video?

Set audio to true and write the line in quotes with the speaker, plus any ambience or music. With audio on, 540p costs 8.8 credits per second instead of 7.2.

Which aspect ratios does PixVerse V6 Max Text to Video support?

16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 and 21:9 through aspect_ratio.

How long can a PixVerse V6 Max Text to Video clip be?

1 to 15 whole seconds, 5 by default. A 15-second 1080p clip with audio costs 336 credits.

What does 1080p cost on PixVerse V6 Max Text to Video?

17.6 credits per second silent or 22.4 with audio, multiplied by duration; 5 silent seconds come to 88 credits.

Is 360p useful on PixVerse V6 Max Text to Video?

Use it for fast, low-cost prompt tests at 4.8 credits per second, then re-run the chosen prompt at 720p or 1080p.

How long can a PixVerse V6 Max Text to Video prompt be?

Up to 5,000 characters. Both endpoints need a prompt: up to 5,000 characters here, and up to 2,048 characters in Image to Video.

When should I use PixVerse V6 Max Image to Video instead?

When the first frame must match an existing image such as a packshot or artwork. The image endpoint keeps the image's framing and uses the same rates.