Skip to main content

Overview

PixVerse V6 Text to Video is a text-to-video API that generates a video from a text prompt with flexible duration and cinematic aspect ratios. Compared to PixVerse V5.5, version 6 unlocks any integer duration from 1 to 15 seconds (instead of fixed 5, 8, or 10) and adds three aspect ratios: portrait_2_3, landscape_3_2, and cinematic_21_9. Native synchronized audio, multi-clip output, and prompt reasoning are all preserved.

Key capabilities

  • Flexible duration (1-15 seconds): any integer length from 1 to 15, with default 5 (previously fixed to 5, 8, or 10)
  • Extended aspect ratios: widescreen_16_9 (default), classic_4_3, square_1_1, traditional_3_4, social_story_9_16, plus portrait_2_3, landscape_3_2, and cinematic_21_9
  • Native synchronized audio: enable generate_audio_switch to produce music, sound effects, 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
  • Resolutions: 360p, 540p, 720p, 1080p
  • 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: promotional clips in any length that fits the channel, with synchronized audio
  • Cinematic content: widescreen cinematic_21_9 sequences for teasers and film-style shots
  • Social content: vertical social_story_9_16 or portrait_2_3 clips for TikTok, Instagram Reels, and YouTube Shorts
  • Short films: longer 10-15 second sequences with multi-clip camera transitions
  • Stylized shorts: anime, cyberpunk, or clay looks for art and concept work

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

Generate a video from a text prompt with PixVerse V6

GET /v1/ai/text-to-video/pixverse-v6/{task-id}

Get task status and result by ID

GET /v1/ai/text-to-video/pixverse-v6

List all PixVerse V6 text-to-video tasks

Parameters

Frequently Asked Questions

PixVerse V6 introduces flexible duration (any integer from 1 to 15 seconds instead of fixed 5, 8, or 10) and three additional aspect ratios: portrait_2_3, landscape_3_2, and cinematic_21_9. Native synchronized audio, multi-clip output, and prompt reasoning work the same as in V5.5.
PixVerse V6 accepts any integer duration from 1 to 15 seconds, with a default of 5. You are no longer limited to fixed steps, so you can match the exact shot length you need.
On top of widescreen_16_9, classic_4_3, square_1_1, traditional_3_4, and social_story_9_16, PixVerse V6 adds portrait_2_3, landscape_3_2, and cinematic_21_9 for portrait, landscape, and cinematic framing.
Set generate_audio_switch to true and PixVerse V6 produces synchronized audio (background music, sound effects, or dialogue) together with the video in a single request. No separate audio call is required.
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.
Rate limits and pricing depend on your subscription tier. See Rate Limits and the Pricing page for current values.

Best practices

  • Duration selection: pick the shortest duration that conveys your shot to reduce processing time and cost; reserve 10-15s for narrative sequences
  • Aspect ratio: use cinematic_21_9 for film-style shots and social_story_9_16 or portrait_2_3 for vertical social formats
  • Audio: enable generate_audio_switch only when you want the model to author audio; otherwise leave it false and mix your own track externally
  • Prompt reasoning: leave thinking_type as enabled for general prompts; switch to disabled when you need literal prompt adherence
  • Production integration: use webhook_url instead of polling for scalable workflows
  • Error handling: implement retry with exponential backoff for 503 responses