Video Outpainter

Video Outpainter

Playground

WaveSpeedAI Video Outpainter expands any video beyond its original boundaries while preserving motion, identity, and scene coherence. Perfect for aspect-ratio changes, reframing, adding safe margins, or generating new visual context without cropping or losing content.

Features

Video Outpainter

What is Video Outpainter?

Video Outpainter expands your video outward in any direction, synthesizing new, coherent surroundings while preserving the original motion, characters, and scene continuity. It is ideal for reframing shots, adding safe margins, and converting aspect ratios (for example, 9:16 → 16:9) without cropping or losing key content.

Input Parameters

video (required)

The source video you want to expand. This defines all core motion, composition, and subject identity that the model will preserve.

prompt (optional)

A positive text description of how the newly generated surroundings should look. Examples:

• Extend skyline with modern city buildings
• Add a dense forest around the subject
• Fill the sides with a matching indoor studio background

If left empty, the model automatically generates a visually coherent extension based on the original footage.

aspect_ratio

Controls the aspect ratio of the outpainted output.

Available options:

• auto (default)
• 1:1, 4:3, 3:4
• 16:9, 9:16
• 3:2, 2:3
• 21:9, 9:21

Use this to widen or heighten shots, convert between social and cinematic formats, or create ultra-wide canvases.

seed

Controls randomness and reproducibility.

• −1 → a random seed is used for each run
• Any integer → repeatable results for the same inputs

Designed For

• Social teams – Export one master shot into multiple formats (TikTok, Shorts, Reels, YouTube, ads) without cropping faces or key actions.
• Editors and studios – Deliver different aspect ratios for clients, broadcast, or film-safe reframing from a single source clip.
• Marketing and ads – Repurpose existing assets for new placements by adding context and safe margins around the subject.
• Creators – Add cinematic space, environmental detail, or breathing room around shots while keeping the original take.

How to Use

1. Upload the video you want to outpaint.
2. Choose an aspect_ratio (auto or any supported cinematic/social ratio).
3. Optionally add a prompt to guide how the extended environment should look.
4. Set the seed (or leave it at −1 for variation).
5. Run the model, preview the result, and iterate until the framing and environment feel right.

Pricing

Key Capabilities

• Expands video content in any direction (top, bottom, left, right).
• Converts aspect ratios without cropping the original frame.
• Preserves identity, motion, and temporal consistency across all frames.
• Generates natural, coherent backgrounds and surroundings that blend with the source video.
• Perfect for reframing, platform adaptation, and turning standard shots into more cinematic compositions.

# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/video-outpainter" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "aspect_ratio": "auto",
    "seed": -1
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"