How to Use VOID Video Inpainting in Gemini
VOID Video Inpainting removes objects from footage and rebuilds the physical interactions affected by their absence. Use it for edits where deleting a person or prop also needs to change what falls, collides, or keeps moving.
Prompts to try with VOID Video Inpainting in Gemini
Copy an example into Gemini, or ask in your own words.
Use VOID Video Inpainting on this clip to remove the cup at the back of the table. Describe the finished scene as a clear tabletop behind the main product, then show me the edit.
Use VOID Video Inpainting to remove the obstacle in this ball clip. Check whether the ball's new path makes sense after the obstacle is gone.
Use VOID Video Inpainting to remove the person holding the prop in this short clip. Show me the result and point out any odd changes in the falling prop's shape.
Use VOID Video Inpainting to retry this edit with the second refinement pass enabled. Compare the moving object's shape with the earlier result.
Use VOID Video Inpainting to remove the background object in this clip. Review the area it covered, its shadow, and its reflection, and identify anything that needs another attempt.
How to set up VOID Video Inpainting in Gemini
Pick the way that suits you. Each takes about two minutes.
Use the Gemini connector
- Open Connected Apps
On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.
- Add Spiral as a custom app
Under Custom apps, click Add a custom app and paste this MCP server URL:
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.
Use the Spiral skill
- Send Gemini this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run VOID Video Inpainting
One request; the result comes back by polling or a webhook.
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" } }'
Then paste one of the prompts above: Gemini finds VOID Video Inpainting on Spiral, shows the price and runs it.
VOID Video Inpainting providers and prices
Spiral runs VOID Video Inpainting through fal. Open a card for today's price, with every fee included.
Settings you can ask for
VOID Video Inpainting works from your video URL and prompt. Ask Gemini for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Enable pass2 refinement | on or off | off | Run VOID Pass 2 warped-noise refinement after Pass 1. This is slower but can improve temporal consistency on longer clips. |
| Negative prompt | what to leave out, in words | 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. |
| Number of inference steps | 1 to 50 | 30 | Number of denoising steps. Higher values improve quality but increase latency. |
| Guidance scale | 0 to 20 | 1 | Classifier-free guidance scale. |
| Strength | 0 to 1 | 1 | Denoising strength. 1.0 means full denoising. |
| Seed | a whole number | Random seed for reproducibility. | |
| Number of frames | 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. |
Every API field of Void Video Inpainting is on its tool page: open its card above.
What can you do with VOID Video Inpainting in Gemini?
Create an edited take of a video with an unwanted object removed. A chat app can help describe the finished scene and guide review of the motion and appearance affected by the edit.
Clean up a filmed shot
Remove an unwanted prop from a short shot, then inspect its former location, shadow, and reflection before using the edit.
Prepare an advertising edit
Create a draft with a distracting background object removed. Compare the reconstructed area with the original footage during review.
Preview a scene without its performer
Explore how a shot could look after removing the person handling a prop, including any resulting change in the prop's motion.
Explore a collision without an obstacle
Remove an obstacle from a filmed interaction and review the newly generated trajectory as a visual effects concept.
Visualize loss of support
Remove a supporting object and generate a draft showing the supported object falling. Inspect the contact point and object shape throughout the motion.
Build a cause-and-effect comparison
Pair an original interaction clip with an edited version that omits one object. Use the pair to illustrate a proposed alternative outcome for a lesson or presentation.
More on VOID Video Inpainting and Gemini
Overview
VOID Video Inpainting in other agents
Questions about VOID Video Inpainting in Gemini
Can Gemini use VOID Video Inpainting?
Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run VOID Video Inpainting like any built-in tool.
How much does VOID Video Inpainting cost in Gemini?
Up to $0.195 per run at the default inputs. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini plan is separate.
Do I need a fal account to use VOID Video Inpainting in Gemini?
No. Spiral runs VOID Video Inpainting on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up VOID Video Inpainting in Gemini?
About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.
Does Gemini wait while VOID Video Inpainting runs?
VOID Video Inpainting runs in the background. Gemini starts the run, checks on it and gives you the video when it's ready.
What is VOID Video Inpainting good at?
Removing an object when its absence should change the action around it. That includes reconstructing falling objects, collisions, and motion paths, alongside effects such as shadows and reflections.
Does VOID edit existing footage?
Yes. VOID removes selected objects from an existing video and generates the scene that could remain without them.
What should I write in the scene prompt?
Describe the visible scene after the edit, such as "A ball rolls across the table." Keep the removal target separate from that description.
When should I use the second refinement pass?
Try it when a moving object changes shape in the first result. The second pass uses the generated motion to help stabilize object shape across frames.
What resolution and length does the maker document?
The published model card lists a default output of 672 pixels wide by 384 pixels high and a maximum of 197 frames. These are the maker's documented model specifications.
Start using VOID Video Inpainting in Gemini
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini:
set up https://spiral.ai/SKILL.md


