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

Claude Code · Video

How to Use VOID Video Inpainting in Claude Code

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 Claude Code

Copy an example into Claude Code, or ask in your own words.

Use VOID Video Inpainting on the short product clip in this project to remove the spare cup. Describe the finished scene as a product standing alone on the table, and save a comparison for review.

VOID Video InpaintingClaude Code
Try asking
  • Use VOID Video Inpainting on the project's obstacle clip to remove the block in the ball's path. Check the affected region along the ball's expected route and save the result separately.

  • Use VOID Video Inpainting on the project's prop-handling clip to remove the performer. Review how the prop moves after losing support and flag frames where its shape changes.

  • Use VOID Video Inpainting to compare the first pass with second-pass refinement on our existing removal test. Keep the source and mask the same, then show where object shape differs.

  • Use VOID Video Inpainting on the project's 85-frame cleanup clip. Check the removal mask and affected region before rendering, then add the original and edited clips to the review page.

How to set up VOID Video Inpainting in Claude Code

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

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

  1. Create an API key

    In the console, under API keys.

  2. 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: Claude Code 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.

falVideo
Void Video Inpainting
fal-ai/void-video-inpainting

Settings you can ask for

VOID Video Inpainting works from your video URL and prompt. Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Enable pass2 refinementon or offoff

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

Negative promptwhat to leave out, in wordsThe 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 steps1 to 5030

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

Guidance scale0 to 201

Classifier-free guidance scale.

Strength0 to 11

Denoising strength. 1.0 means full denoising.

Seeda whole number

Random seed for reproducibility.

Number of frames1 to 19785

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 Claude Code?

Turn project footage into removal drafts for an editor or review tool. A coding agent can organize source clips, masks, and comparisons while checking reconstructed motion and object shape.

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.

Questions about VOID Video Inpainting in Claude Code

Can Claude Code use VOID Video Inpainting?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run VOID Video Inpainting like any built-in tool.

How much does VOID Video Inpainting cost in Claude Code?

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 Claude Code plan is separate.

Do I need a fal account to use VOID Video Inpainting in Claude Code?

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 Claude Code?

About two minutes: add the hosted server, then sign in.

Does Claude Code wait while VOID Video Inpainting runs?

VOID Video Inpainting runs in the background. Claude Code 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.

Get started

Start using VOID Video Inpainting in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options