WaveSpeedAI APIPixversePixverse Pixverse V5.5 Text To Video

Pixverse Pixverse V5.5 Text To Video

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

  1. 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.”
  2. 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.
  3. Choose duration

    • 5s for quick previews or punchy hooks.
    • 8s for more developed mini-scenes.
  4. (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.
  5. Set seed

    • Keep a seed fixed while you tweak the prompt.
    • Change it when you’re happy with the setup but want new takes.
  6. 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

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
resolutionstringNo540p360p, 540p, 720p, 1080pVideo quality
durationintegerNo55, 8, 10Video duration in seconds.
resolution_ratiostringNo1:116:9, 4:3, 1:1, 3:4, 9:16The aspect ratio of the generated video
generate_audio_switchbooleanNofalse-Enable audio generation for the video.
generate_multi_clip_switchbooleanNofalse-Enable multi-clip generation with dynamic camera changes.
thinking_typestringNoautoenabled, disabled, auto Controls whether the system should enhance your prompt with internal reasoning and optimization.
negative_promptstringNo-The negative prompt for the generation.
seedintegerNo--1 ~ 2147483647The random seed to use for the generation.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

© 2025 WaveSpeedAI. All rights reserved.