Pixverse Pixverse V5.6 Text To Video
Playground
Try it on WavespeedAI!PixVerse V5.5 transforms text prompts into realistic videos with smooth motion and natural detail in seconds—ideal for stories, ads, and social clips. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
PixVerse v5.6 — Text-to-Video
PixVerse v5.6 Text-to-Video turns a written scene description into a short animated clip. You control resolution (360p–1080p), duration (5s / 8s / 10s) and aspect ratio (16:9, 4:3, 1:1, 3:4, 9:16), while the model handles camera motion, lighting and transitions for you.
Highlights
- Multiple resolutions – 360p, 540p, 720p, 1080p for previews through to final export.
- Flexible aspect ratios – 16:9, 4:3, 1:1, 3:4, 9:16 to match feeds, stories and banners.
- Variable duration – 5, 8 or 10 seconds per clip.
- Audio co-generation – Optionally generate synchronized audio alongside your video.
- Prompt reasoning (thinking_type) – optional system-side enhancement that can refine and structure your prompt.
- Negative prompt support – steer the model away from artefacts such as “watermark”, “text”, “distortion”.
- Seed control – fix a seed for reproducible generations, or vary it for multiple takes.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Up to 2048 characters describing the scene, pacing and camera moves |
| resolution | No | 360p, 540p, 720p, 1080p (default: 540p) |
| duration | No | 5, 8, or 10 seconds (default: 5). 10s not available for 1080p |
| resolution_ratio | No | 16:9, 4:3, 1:1, 3:4, 9:16 (default: 1:1) |
| generate_audio_switch | No | Enable audio generation for the video |
| thinking_type | No | auto (default), enabled, or disabled |
| negative_prompt | No | Terms to avoid (e.g., watermark, text, logo, glitch) |
| seed | No | Integer for reproducibility |
How to Use
-
Write the prompt — Describe key shots, mood and motion, e.g. “Anime rooftop at sunset, slow dolly-in toward the character, hair and clothes moving in the wind, cinematic lighting.”
-
Set resolution & aspect ratio
- 9:16 for TikTok, Reels
- 16:9 for YouTube videos
- 1:1 for Instagram
- 4:3 for feed posts and thumbnails
-
Choose duration — 5s for quick previews or punchy hooks; 8s for more developed mini-scenes.
-
Enable audio (optional) — Check generate_audio_switch for synchronized sound.
-
Adjust thinking & negative_prompt (optional) — Set thinking_type to “enabled” if you want the system to help structure a complex prompt. Add negative prompt to suppress unwanted elements.
-
Set seed — Keep a seed fixed while you tweak the prompt; change it when you want new takes.
-
Run and download — Generate the clip, review, then iterate as needed.
Pricing
Base Price (Video Only)
| Resolution | 5s | 8s | 10s |
|---|---|---|---|
| 360p | $0.35 | $0.70 | $0.77 |
| 540p | $0.35 | $0.70 | $0.77 |
| 720p | $0.45 | $0.90 | $0.99 |
| 1080p | $0.75 | $1.50 | — |
Audio Add-on (when generate_audio_switch is enabled)
| Resolution | 5s | 8s | 10s |
|---|---|---|---|
| 360p/540p | +$0.45 | +$0.45 | +$0.45 |
| 720p | +$0.35 | +$0.45 | +$0.45 |
| 1080p | +$0.75 | +$0.45 | — |
Billing Rules
- 1080p does not support 10-second duration.
- Audio generation is billed as an add-on to the base video price.
- Total cost = Base Price + Audio Add-on (if enabled)
Best Use Cases
- Social Media Content — Create engaging short-form videos for TikTok, Instagram Reels, and YouTube Shorts.
- Marketing & Ads — Generate eye-catching promotional clips without filming.
- Concept Visualization — Bring creative ideas to life for pitches and presentations.
- Music Videos — Produce visual content with synchronized audio.
- Storytelling — Create narrative scenes for creative projects.
Pro Tips
- Write shot-by-shot for best results (wide → medium → close-up, etc.).
- Keep the number of major events small; let the model focus on a few strong beats.
- Higher resolutions (720p / 1080p) are better for export and editing; use 360p / 540p for fast iteration.
- For vertical platforms, set resolution_ratio to 9:16 or 3:4 from the start to avoid awkward cropping.
- Use negative_prompt to avoid common issues like “blurry, distorted, watermark, text overlay”.
Notes
- 1080p resolution does not support 10-second duration.
- Audio generation adds processing time but creates fully finished videos.
- For best results, be specific about lighting, mood, and movement in your prompt.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/pixverse/pixverse-v5.6/text-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"resolution": "540p",
"duration": 5,
"resolution_ratio": "1:1",
"generate_audio_switch": false,
"thinking_type": "auto"
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The positive prompt for the generation. | |
| resolution | string | No | 540p | 360p, 540p, 720p, 1080p | Video quality |
| duration | integer | No | 5 | 5, 8, 10 | Video duration in seconds. |
| resolution_ratio | string | No | 1:1 | 16:9, 4:3, 1:1, 3:4, 9:16 | The aspect ratio of the generated video |
| generate_audio_switch | boolean | No | false | - | Enable audio generation for the video. |
| thinking_type | string | No | auto | enabled, disabled, auto | Controls whether the system should enhance your prompt with internal reasoning and optimization. |
| negative_prompt | string | No | - | The negative prompt for the generation. | |
| seed | integer | No | - | -1 ~ 2147483647 | The random seed to use for the generation. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |