Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable now

Void Video Inpainting

fal-ai/void-video-inpainting

Edit and transform video with Void Video Inpainting from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.

Pricing

Up to $0.195 per run at the default inputs.

Limits

Runs
In the background
Returns
video
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
930 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
video_url requiredURL or file—

URL of the input video containing the object to remove.

quad_mask_video_urltext

URL of a mask video for the removal target. For best results this should be a VOID-style quadmask video with 4 grayscale values: 0=object to remove, 63=overlap, 127=affected region, 255=background to keep. A simple binary mask (0=remove, 255=keep) also works. If omitted, the app will generate a temporary mask video from mask_prompt using the SAM-3 video endpoint and convert it to a quadmask automatically.

mask_prompttext—

Text description of what should be masked in the input video, such as the object or person to remove. Used to generate a temporary mask video with SAM-3 when quad_mask_video_url is not provided.

prompt requiredtext—

Text description of the desired background after object removal.

enable_pass2_refinementtrue or falsefalse

Run VOID Pass 2 warped-noise refinement after Pass 1. This is slower but can improve temporal consistency on longer clips.

negative_prompttextThe video is not of a high quality, it has a low resolution. Watermark present in each frame. The background is solid. Strange body and strange trajectory. Distortion.

Negative prompt to guide generation away from undesired outputs.

num_inference_stepsnumber (whole)
1 to 50
30

Number of denoising steps. Higher values improve quality but increase latency.

guidance_scalenumber
0 to 20
1

Classifier-free guidance scale.

strengthnumber
0 to 1
1

Denoising strength. 1.0 means full denoising.

seednumber (whole)—

Random seed for reproducibility.

num_framesnumber (whole)
1 to 197
85

Temporal window size for inference. The backend snaps this to the nearest CogVideoX-safe value that works with temporal compression and patching. Valid outputs are 69, 77, 85, ..., 197.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/void-video-inpainting",
    "input": {
      "video_url": "https://storage.googleapis.com/falserverless/kontext-blog/input_video.mp4",
      "prompt": "a video of buildings reflecting on a calm river"
    }
  }'

Frequently asked questions

How much does Void Video Inpainting cost?

Up to $0.195 per run at the default inputs. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Void Video Inpainting through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/void-video-inpainting"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Void Video Inpainting?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Void Video Inpainting?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.