WaveSpeedAI APIPixversePixverse Pixverse V5 I2V

Pixverse Pixverse V5 I2V

Pixverse Pixverse V5 I2V

Playground

Try it on WavespeedAI!

PixVerse V5 converts images to short, smooth, natural-looking videos. 5s video: $0.15 (360p/540p), $0.20 (720p), $0.40 (1080p). Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

PixVerse V5 Image-to-Video

Transform your images into cinematic videos with PixVerse V5 — the latest generation image-to-video model. With multiple resolution options from 360p to 1080p and flexible duration settings, create stunning motion content with ultra-realistic details and smooth, natural movement.

Why It Looks Great

  • V5 generation quality: Latest model delivers improved motion coherence and visual fidelity.
  • Multiple resolutions: Choose from 360p, 540p, 720p, or 1080p based on your needs.
  • Flexible duration: Generate 5-second or 8-second videos.
  • Negative prompt support: Exclude unwanted elements for more precise control.
  • Prompt Enhancer: Built-in tool to refine and expand your motion descriptions.
  • Safety Checker: Optional content filtering for appropriate output.
  • Reproducible results: Use the seed parameter to recreate exact outputs.

Parameters

ParameterRequiredDescription
promptYesText description of the motion, action, and cinematography you want.
imageYesSource image to animate (upload or public URL).
resolutionNoOutput quality: 360p, 540p, 720p, or 1080p. Default: 540p.
durationNoVideo length: 5 or 8 seconds. Default: 5.
negative_promptNoElements to avoid in the generated video.
seedNoRandom seed for reproducibility. Leave empty for random.
Enable Safety CheckerNoToggle content safety filtering.

How to Use

  1. Write your prompt — describe the motion, atmosphere, and cinematic details you want.
  2. Use Prompt Enhancer (optional) — click to automatically enrich your description.
  3. Upload your image — drag and drop or paste a public URL.
  4. Choose resolution — select quality level based on your use case and budget.
  5. Set duration — choose 5 or 8 seconds.
  6. Add negative prompt (optional) — specify elements to exclude.
  7. Set seed (optional) — for reproducible results.
  8. Run — click the button to generate.
  9. Download — preview and save your video.

Pricing

Pricing varies by resolution and duration.

5-Second Videos

ResolutionCost
360p$0.15
540p$0.15
720p$0.20
1080p$0.40

8-Second Videos

ResolutionCost
360p$0.30
540p$0.30
720p$0.40
1080p$0.80

Quick Reference

Duration360p540p720p1080p
5s$0.15$0.15$0.20$0.40
8s$0.30$0.30$0.40$0.80

Best Use Cases

  • Social Media Content — Create engaging video content from photos for TikTok, Reels, and Stories.
  • Music & Mood Videos — Animate artistic images with cinematic motion for visual accompaniment.
  • Portrait Animation — Bring portrait photos to life with natural movement and expression.
  • Product Showcases — Add dynamic motion to product images for marketing content.
  • Creative Exploration — Transform artwork and photography into moving visual pieces.

Example Prompts

  • “A teenage girl sitting on a rooftop at sunset, holding a guitar on her lap, golden light reflecting on her face, cinematic medium shot, soft wind moving her hair, ultra realistic details, atmosphere of youth, creativity, and inspiration”
  • “Gentle camera push in, subject’s hair moving softly in the breeze, warm golden hour lighting”
  • “Ocean waves in the background slowly rolling, ambient coastal atmosphere, peaceful motion”
  • “Portrait subject slowly turns head toward camera, subtle smile, soft bokeh background”
  • “Leaves gently falling around the subject, autumn atmosphere, slow cinematic motion”

Resolution Guide

ResolutionBest For
360pQuick previews, testing concepts, budget-conscious projects
540pSocial media, general use, good quality/cost balance
720pHigher quality social content, presentations
1080pProfessional content, large displays, final deliverables

Pro Tips for Best Results

  • Start with 540p to test your concept before generating at higher resolutions.
  • Use negative prompts to avoid common issues like “blur”, “distortion”, “static”.
  • Include cinematic language: “golden light”, “soft wind”, “ultra realistic”, “cinematic shot”.
  • Describe both subject motion and environmental elements for richer videos.
  • The Prompt Enhancer excels at adding professional cinematography details.
  • Keep the same seed when upgrading resolution to get a higher-quality version of the same video.

Notes

  • If using a URL for the image, ensure it is publicly accessible. A preview thumbnail confirms successful loading.
  • Processing time varies based on resolution and duration — higher settings take longer.
  • Enable Safety Checker for content that will be publicly shared or used commercially.
  • Best results come from images with clear subjects and room for natural motion.

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-i2v" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "resolution": "540p",
    "duration": 5,
    "sound_effect_switch": false
}'

# 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.
imagestringYes-First frame of the video; Supported image formats include.jpg/.jpeg/.png; The image file size cannot exceed 10MB, and the image resolution should not be less than 300*300px, and the aspect ratio of the image should be between 1:2.5 ~ 2.5:1.
resolutionstringNo540p360p, 540p, 720p, 1080pVideo quality (360p/540p/720p/1080p).
durationintegerNo55, 8Video duration in seconds.
sound_effect_switchbooleanNofalse-Set to true if you want to enable this feature.
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

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray 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.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
© 2025 WaveSpeedAI. All rights reserved.