# 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.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Tool id: `fal` / `fal-ai/void-video-inpainting`
- Page: https://spiral.ai/tools/fal/fal-ai/void-video-inpainting

## Pricing

Up to $0.195 per run at the default inputs.

## Limits

- 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 | Allowed | 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` using the SAM-3 video endpoint and convert it to a quadmask automatically. |
| `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 `quad_mask_video_url` is not provided. |
| `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. |

## Example

```bash
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"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fvoid-video-inpainting

## Common questions

### Void Video Inpainting

**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.

