How to Use Depth Anything Video in Claude Code
Depth Anything Video turns existing footage into depth maps that stay consistent between frames, useful for compositing and 3D conversion experiments. It estimates relative depth, so its values should not be treated as measured distances.
Prompts to try with Depth Anything Video in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Depth Anything Video on a 10-second sample from this project's footage. Save a grayscale depth preview and add a synchronized source-and-depth viewer.
Process the project's opening shot with Depth Anything Video at 720p. Add controls to scrub the source and depth preview together.
Use Depth Anything Video on a 15-second project clip and request raw depth arrays. Build a prototype that uses them to control background blur.
Prepare depth passes with Depth Anything Video for this project's haze experiment. Limit each request to 2,400 frames and retain each shot's source timestamps.
Use Depth Anything Video on a short moving shot in this project. Prepare its depth output for our 3D conversion experiment and add a review checklist.
How to set up Depth Anything Video in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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
- 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
- Send Claude Code 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 Depth Anything Video
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/depth-anything-video", "input": { "video_url": "https://v3b.fal.media/files/b/0a8fb1c1/xNTrr7wtczzLBkJdyE5_f_7JTYCmQe.mp4" } }'
Then paste one of the prompts above: Claude Code finds Depth Anything Video on Spiral, shows the price and runs it.
Depth Anything Video providers and prices
Spiral runs Depth Anything Video through fal. Open a card for today's price, with every fee included.
resolution: 360p $0.052, 480p $0.052, 720p $0.052, auto (default) $0.052, 1080p $0.052 per second.
Settings you can ask for
Depth Anything Video works from your video URL. Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Model | VDA-Small, VDA-Base, or VDA-Large | VDA-Large | Depth estimation model size. VDA-Large = best quality, VDA-Small = fastest. |
| Colormap | grayscale, turbo, inferno, magma, or viridis | grayscale | Colormap for depth visualization. 'turbo' (recommended) shows near=warm, far=cool. 'grayscale' for raw normalized depth. 'inferno'/'magma' for perceptually uniform. 'viridis' for colorblind-friendly. |
| Resolution | auto, 360p, 480p, 720p, or 1080p | auto | Output resolution. 'auto' preserves input (max 1080p). Options: 'auto', '360p', '480p', '720p', '1080p'. |
| Max frames | a whole number | Max frames to process (max 2400). None = up to 2400. | |
| Output FPS | a number | Output video FPS. None = same as input. | |
| Side by side | on or off | off | Output original | depth comparison video. |
| Include raw depths | on or off | off | Export raw float32 depths as .npz file with: 'depths' [N,H,W], 'min_depth', 'max_depth', 'fps', 'model', 'shape'. |
Every API field of Depth Anything Video is on its tool page: open its card above.
What can you do with Depth Anything Video in Claude Code?
Build depth previews and effect experiments around footage already in your project. Have the agent preserve source references and add review tools for checking depth across frames.
Depth passes for compositing
Generate a depth pass from an existing shot, then use it as a starting point for effects controlled by foreground and background distance.
Background blur experiments
Use estimated depth to prototype background blur on filmed footage. Review subject boundaries and motion before accepting the composite.
Fog and haze previews
Try stronger haze in distant parts of a shot using its depth pass. Compare the result with the source throughout the camera movement.
Depth-based color treatments
Prototype different color treatments for near and distant regions. Use the depth estimate as a starting mask and refine the transition in your editor.
3D video conversion tests
Prepare depth estimates for a separate 2D-to-3D conversion workflow. Start with a short shot and review the converted sequence before processing more footage.
Depth consistency reviews
Inspect depth predictions across a moving shot before using them in an effect. Compare the beginning, middle, and end, then watch the complete sequence.
More on Depth Anything Video and Claude Code
Overview
Depth Anything Video in other agents
Questions about Depth Anything Video in Claude Code
Can Claude Code use Depth Anything Video?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Depth Anything Video like any built-in tool.
How much does Depth Anything Video cost in Claude Code?
Up to $3.12 per run at the default inputs for 60 seconds of input. 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 Depth Anything Video in Claude Code?
No. Spiral runs Depth Anything Video on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Depth Anything Video in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Depth Anything Video runs?
Depth Anything Video runs in the background. Claude Code starts the run, checks on it and gives you the video when it's ready.
What is Depth Anything Video useful for?
It produces depth estimates from existing footage, with an emphasis on consistency between frames. Use those estimates as starting material for depth effects, compositing, or 3D video conversion.
Does Depth Anything Video measure distances in meters?
Treat its relative depth estimates as scene structure rather than measured distances. The original model shares a scale and shift across the video, but that does not establish an absolute distance scale.
How much footage can Depth Anything Video process?
The served endpoint caps processing at 2,400 frames: 80 seconds at 30 frames per second or 100 seconds at 24 frames per second. Split longer footage into shots for processing and review.
What is the maximum output resolution?
The served endpoint supports output up to 1080p. Preserving the input resolution automatically still applies that ceiling.
Should I use a grayscale preview or raw depth arrays?
Use a grayscale preview for visual inspection. Request raw depth arrays when your next step needs numerical processing, and keep the original footage alongside them for comparison.
Start using Depth Anything Video 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 https://spiral.ai/SKILL.md


