How to Use Vidu Q4 Image to Video in Claude Code
Turn a finished still into a short product shot or character scene with directed motion. Unlike Reference to Video, this version uses your image as the opening frame, making it a useful choice when the starting composition matters.
Prompts to try with Vidu Q4 Image to Video in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Vidu Q4 Image to Video with public/images/hero-product.png as the opening frame. Make a 5-second 1080p shot: the camera slowly pushes toward the bottle while side lighting reveals the glass texture. Save the selected clip with the project's media assets.
Use Vidu Q4 Image to Video to animate assets/storyboards/arrival.png for 6 seconds at 720p. The traveler takes one step toward the door as the camera tracks gently right. Compare the result with the storyboard's intended composition.
Use Vidu Q4 Image to Video with assets/product/still.png to make two 5-second 720p camera studies. Keep the product action the same; request a slow push-in for one and a lateral track for the other. Place both clips beside the shot notes for review.
Animate the image I attach with Vidu Q4 Image to Video: slow push-in, leaves moving in the wind. Save the result in ./assets.
Turn this product photo into a 5-second rotating shot with Vidu Q4 Image to Video.
How to set up Vidu Q4 Image to 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 Vidu Q4 Image to 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/vidu/q4/image-to-video", "input": { "image_url": "https://storage.googleapis.com/falserverless/web-examples/vidu/stylish_woman.webp" } }'
Then paste one of the prompts above: Claude Code finds Vidu Q4 Image to Video on Spiral, shows the price and runs it.
Vidu Q4 Image to Video providers and prices
Spiral runs Vidu Q4 Image to Video through fal. Open a card for today's price, with every fee included.
$0.43225 per run at the default inputs. resolution: 540p $0.20475, 720p (default) $0.43225, 1080p $0.546, 2K $0.8645, 4K $1.7745. Per unit of duration: 540p $0.04095, 720p (default) $0.08645, 1080p $0.1092, 2K $0.1729, 4K $0.3549.
Settings you can ask for
Vidu Q4 Image to Video works from your prompt and image URL. Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Duration | 3 to 16 | 5 | Duration of the video in seconds (3-16) |
| Seed | a whole number | Random seed for reproducibility. If None, a random seed is chosen. | |
| Resolution | 540p, 720p, 1080p, 2K, or 4K | 720p | Output video resolution |
Every API field of Vidu Q4 · Image to Video is on its tool page: open its card above.
What can you do with Vidu Q4 Image to Video in Claude Code?
Turn project artwork into short product shots, character scenes, and video assets for a site or app. Use an existing frame when composition is settled, or combine references when a scene needs several visual elements.
Product reveal
Start with a product photograph or product references. Direct a short camera move and a lighting change that reveal the material, then check the product's appearance before using the shot.
Animate a campaign still
Use the approved campaign image as the opening frame and specify the movement that follows, such as a head turn, drifting steam, or a slow camera push.
Film shot planning
Explore how a planned scene plays with a camera move or a change of shot. Use a storyboard frame for a fixed opening, or character and environment references for a newly composed scene.
Short social scenes
Build a self-contained visual moment within 16 seconds: a character notices something, reacts, and delivers a short line. Keep each clip focused on a clear sequence.
Camera direction comparisons
Try the same subject and action with a slow push-in, a lateral track, and a static camera. Compare the selected shots before committing to the sequence.
More on Vidu Q4 Image to Video and Claude Code
Overview
Vidu Q4 Image to Video in other agents
Questions about Vidu Q4 Image to Video in Claude Code
Can Claude Code use Vidu Q4 Image to Video?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Vidu Q4 Image to Video like any built-in tool.
How much does Vidu Q4 Image to Video cost in Claude Code?
$0.43225 per run at the default inputs. `resolution`: 540p $0.20475, 720p (default) $0.43225, 1080p $0.546, 2K $0.8645, 4K $1.7745. $0.08645 per unit of `duration`. 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 Vidu Q4 Image to Video in Claude Code?
No. Spiral runs Vidu Q4 Image to 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 Vidu Q4 Image to Video in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Vidu Q4 Image to Video runs?
Vidu Q4 Image to Video runs in the background. Claude Code starts the run, checks on it and gives you the video, image when it's ready.
When should I choose Image to Video over Reference to Video?
Choose Image to Video when you already have the exact opening frame. Choose Reference to Video when you want to build a scene around supplied characters, objects, settings, or voices.
How long can a Vidu Q4 clip be, and how large can it be?
Plan for a maximum of 16 seconds per generated clip, with output reaching 4K. For a longer piece, write separate shots and assemble the selected clips afterward.
Does Image to Video keep my picture's shape?
Yes. Vidu says the output keeps the original image's aspect ratio, so prepare the opening image in the framing you want.
Can I guide a character's voice?
Reference to Video supports reference sound alongside the visuals. Identify the intended speaker and voice reference in the prompt, then give the exact dialogue and delivery you want.
What should I put in a Q4 prompt?
Describe what happens, in what order, how the camera moves, and how the scene is lit. For references, state what each image or voice contributes instead of leaving the model to infer those relationships.
Start using Vidu Q4 Image to 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


