Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.magnific.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

PixVerse V5.5 is an image-to-video API that generates cinematic videos from a single image with smooth, expressive motion and stable style across frames. Compared to PixVerse V5, version 5.5 adds native synchronized audio, multi-clip output with dynamic camera changes, an extended 10-second duration option, and a prompt reasoning mode that automatically optimizes inputs before generation.

​
Key capabilities

  • Durations of 5, 8, or 10 seconds: 10-second outputs are available up to 720p; 1080p videos are capped at 5 or 8 seconds
  • Native synchronized audio: enable generate_audio_switch to produce background music, sound effects, or dialogue together with the video
  • Multi-clip with dynamic cameras: enable generate_multi_clip_switch to produce multi-clip output with camera changes inside a single generation
  • Prompt reasoning (thinking_type): choose enabled, disabled, or auto to control whether the model rewrites the prompt before rendering
  • Resolutions: 360p, 540p, 720p, 1080p
  • Aspect ratios: widescreen_16_9, classic_4_3, square_1_1, traditional_3_4, social_story_9_16
  • Camera movement presets: 20 options including zoom_in, zoom_out, pan_left, pan_right, crane_up, hitchcock, whip_pan, camera_rotation
  • Style controls: anime, 3d_animation, clay, cyberpunk, comic
  • Async processing: poll the task endpoint or receive a webhook notification on completion

​
Use cases

  • Marketing and ads: short product videos with synchronized audio and dynamic camera work
  • Social content: vertical clips for TikTok, Instagram Reels, and YouTube Shorts in 9:16 at up to 1080p
  • Short films and teasers: 10-second 720p shots with multi-clip camera transitions
  • Brand storytelling: consistent style and color across cinematic sequences
  • Creative experimentation: stylized output (anime, cyberpunk, clay) for art and concept work

POST /v1/ai/image-to-video/pixverse-v5-5

Generate a video from an image with PixVerse V5.5

GET /v1/ai/image-to-video/pixverse-v5-5/{task-id}

Get task status and result by ID

GET /v1/ai/image-to-video/pixverse-v5-5

List all PixVerse V5.5 tasks

​
Parameters

ParameterTypeRequiredDefaultDescription
image_urlstring (uri)Yes-URL of the image to use as the first frame
promptstringYes-Prompt describing the video to generate
durationintegerNo5Video length in seconds: 5, 8, or 10. 10s only up to 720p; 1080p limited to 5 or 8 seconds
resolutionstringNo-Output resolution: 360p, 540p, 720p, 1080p
aspect_ratiostringNowidescreen_16_9widescreen_16_9, classic_4_3, square_1_1, traditional_3_4, social_story_9_16
stylestringNo-Visual style: anime, 3d_animation, clay, cyberpunk, comic
camera_movementstringNo-Camera preset (e.g., zoom_in, pan_left, crane_up, hitchcock)
negative_promptstringNo""Negative prompt for the generation
seedintegerNo-Reproducibility seed; same seed + same prompt yields the same video
generate_audio_switchbooleanNofalseWhen true, generates synchronized audio (music, SFX, or dialogue) with the video
generate_multi_clip_switchbooleanNofalseWhen true, produces multi-clip output with dynamic camera changes in a single generation
thinking_typestringNoenabledPrompt reasoning mode: enabled, disabled, or auto
webhook_urlstring (uri)No-Optional callback URL that receives task status notifications

​
Frequently Asked Questions

PixVerse V5.5 adds four capabilities on top of V5: a 10-second duration option (up to 720p), native synchronized audio via generate_audio_switch, multi-clip output with dynamic camera changes via generate_multi_clip_switch, and a prompt reasoning mode (thinking_type) that can rewrite the prompt before generation. Resolutions, aspect ratios, and camera presets are the same as V5.
PixVerse V5.5 supports 5, 8, and 10 second durations. The 10-second option is only available up to 720p. At 1080p, durations are limited to 5 or 8 seconds. Supported resolutions are 360p, 540p, 720p, and 1080p.
Set generate_audio_switch to true and PixVerse V5.5 produces synchronized audio (background music, sound effects, or dialogue) together with the video in a single request. No separate audio call is required.
When set to true, PixVerse V5.5 produces multi-clip output with dynamic camera changes inside a single generation, simulating cuts and camera moves without stitching multiple requests.
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 whether to rewrite the prompt based on the input.
Use a high-resolution image with clear subjects and balanced lighting. Avoid heavy compression and cluttered backgrounds to maximize motion quality and subject consistency.
Rate limits and pricing depend on your subscription tier. See Rate Limits and the Pricing page for current values.

​
Best practices

  • Input quality: provide a sharp, well-lit image with a clear subject for the strongest motion and style stability
  • Duration vs resolution: pick 10 seconds for 720p storytelling shots, and 5/8 seconds for 1080p hero shots
  • Audio: enable generate_audio_switch only when you want the model to author audio; if you have your own track, leave it false and mix 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
  • PixVerse V5: prior version without audio, multi-clip, or 10-second support. See the PixVerse V5 overview.
  • PixVerse V5 Transition: image-to-image transition variant for first/last frame interpolation.