Void Video Inpainting
fal-ai/void-video-inpaintingEdit 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
| Field | Kind | Default | Description |
|---|---|---|---|
video_url required | URL or file | — | URL of the input video containing the object to remove. |
quad_mask_video_url | text | 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 | text | — | 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 |
prompt required | text | — | Text description of the desired background after object removal. |
enable_pass2_refinement | true or false | false | Run VOID Pass 2 warped-noise refinement after Pass 1. This is slower but can improve temporal consistency on longer clips. |
negative_prompt | text | The 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_steps | number (whole) 1 to 50 | 30 | Number of denoising steps. Higher values improve quality but increase latency. |
guidance_scale | number 0 to 20 | 1 | Classifier-free guidance scale. |
strength | number 0 to 1 | 1 | Denoising strength. 1.0 means full denoising. |
seed | number (whole) | — | Random seed for reproducibility. |
num_frames | number (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.