Pixverse Pixverse V5.5 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.5 — Text-to-Video
PixVerse v5.5 Text-to-Video turns a written scene description into a short animated clip. You control resolution (360p–1080p), duration (5s / 8s / 10s) and resolution_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.
- 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
-
prompt* (string) : Up to 2048 characters describing the scene, pacing and camera moves.
-
resolution : One of 360p, 540p, 720p, 1080p.
-
duration : 5, 8 or 10 seconds. (10s is not available for 1080p)
-
resolution_ratio : 16:9, 4:3, 1:1, 3:4, 9:16.
-
thinking_type :
- Enabled: Turn on system-level reasoning/optimisation of your prompt.
- Disabled: Use your prompt as-is.
- Auto (default): Let the system decide whether to enable it.
-
negative_prompt (optional) : Terms you don’t want to see in the video (e.g. watermark, text, logo, glitch).
-
seed : Integer for reproducibility. Use a fixed value to re-run the same idea; change it to get new variations.
🚀 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 & resolution_ratio
- Select resolution from 360p,540p,720p and 1080p.
- 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.
-
(Optional) Adjust thinking & negative_prompt
- Set thinking_type=“enabled” if you want the system to help structure a complex prompt.
- Add a short negative prompt to suppress text, artefacts or unwanted objects.
-
Set seed
- Keep a seed fixed while you tweak the prompt.
- Change it when you’re happy with the setup but want new takes.
-
Run and download
- Generate the clip, review, then iterate on prompt, duration or aspect ratio as needed.
💡 Prompt & Quality 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 generation.
- For vertical platforms, set **resolution_ratio = 9:16 or 3:4 ** from the start to avoid awkward cropping.
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.5/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,
"generate_multi_clip_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. |
| generate_multi_clip_switch | boolean | No | false | - | Enable multi-clip generation with dynamic camera changes. |
| 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 |