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

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

Pricing

Output	Price per 5 s	Max Length
Video Outpainting	$0.15	60 s

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.

Video Outpainter API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/video-outpainter with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Video Outpainter below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/video-outpainter" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "video": "https://example.com/your-input.mp4",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "auto",
    "seed": -1
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("wavespeed-ai/video-outpainter", {
        "video": "https://example.com/your-input.mp4",
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "auto",
        "seed": -1
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "wavespeed-ai/video-outpainter",
    {
    "video": "https://example.com/your-input.mp4",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "auto",
    "seed": -1
}
)

print(output["outputs"][0])  # → URL of the generated output

Video Outpainter API — Frequently asked questions

What is the Video Outpainter API?

Video Outpainter is a WaveSpeedAI model for video editing, exposed as a REST API on WaveSpeedAI. 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. You can call it programmatically or try it from the playground above.

How do I call the Video Outpainter API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/video-outpainter.

How much does Video Outpainter cost per run?

Video Outpainter starts at $0.20 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Video Outpainter accept?

Key inputs: `prompt`, `video`, `aspect_ratio`, `seed`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/video-outpainter.

How long does Video Outpainter take to generate?

Average end-to-end generation time on WaveSpeedAI is around 205 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Video Outpainter outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

ExamplesView all

Related Models

README