How to Use Vidu Q3 Mix in VS Code
Vidu Q3 Mix turns reference images into short videos with consistent subjects and synchronized sound. Unlike Vidu Q3 Ad, it targets general creation rather than short-ad pacing.
Prompts to try with Vidu Q3 Mix in VS Code
Copy an example into VS Code, or ask in your own words.
Use Vidu Q3 Mix with the bottle references in this project's assets folder. Generate a 5-second 1080p product shot with a slow push toward the bottle and soft window light. Preserve its shape and packaging; save the clip for review.
Use Vidu Q3 Mix with the mascot reference in this repo to create an 8-second 720p scene. The mascot walks to a desk, notices an empty cup, and looks disappointed. Add footsteps and a quiet room tone.
Read the campaign brief in this project and use Vidu Q3 Mix to create a 10-second 1080p concept from the supplied character and product images. Keep one clear action and include the brief's English spoken line.
Use Vidu Q3 Mix with the project's character reference to make two 5-second 720p camera studies. Keep the action and lighting the same; request a slow push in one and a lateral tracking move in the other.
Use Vidu Q3 Mix with the approved reference images in this project to make a 12-second 1080p story concept. Show the character entering a quiet workshop, finding the product, and smiling. Include a door creak and footsteps.
How to set up Vidu Q3 Mix in VS Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to VS Code on the console's Agents & MCP page, or run:
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}' - Sign in
VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.
Use the Spiral skill
- Send VS 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 Q3 Mix
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/q3/reference-to-video/mix", "input": { "prompt": "A character walking through a beach catching an apple.", "reference_image_urls": [ "<reference_image_urls>" ] } }'
Then paste one of the prompts above: VS Code finds Vidu Q3 Mix on Spiral, shows the price and runs it.
Vidu Q3 Mix providers and prices
Spiral runs Vidu Q3 Mix through fal. Open a card for today's price, with every fee included.
resolution: 360p $0.091, 540p $0.091, 720p (default) $0.2002, 1080p $0.2002 per video. Billed on duration, default 5.
Settings you can ask for
Vidu Q3 Mix works from your prompt and reference image URLs. Ask VS Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Duration | 1 to 16 | 5 | Duration of the video in seconds (1-16 for Q3 models) |
| Seed | a whole number | Random seed for reproducibility. If None, a random seed is chosen. | |
| Aspect ratio | 16:9, 9:16, 4:3, 3:4, or 1:1 | 16:9 | The aspect ratio of the output video |
| Resolution | 360p, 540p, 720p, or 1080p | 720p | Output video resolution |
| Audio | on or off | on | Whether to use direct audio-video generation. When true, outputs video with sound. |
Every API field of Vidu is on its tool page: open its card above.
What can you do with Vidu Q3 Mix in VS Code?
Create short product and character videos from reference assets in your project. Use the agent to turn a brief into individual shots and compare revisions that change one visual instruction at a time.
Product page clips
Use product references to stage a short demonstration or camera move. Check the generated packaging, logo, and shape against the originals.
Recurring mascot scenes
Reuse a mascot reference across short scenes for campaign concepts. Keep its appearance consistent while changing the setting and action.
Short drama scenes
Build a brief character moment around a gesture, expression, and spoken line. Generate separate shots for a longer sequence.
Narrative ads
Combine character and product references in a short scene with a clear action and sound cues. Use the result to assess the story before commissioning a larger production.
Camera movement studies
Compare a slow push, lateral tracking shot, and pullback using the same reference subject. Change only the camera instruction between attempts.
Branching story scenes
Create alternative actions for the same referenced character and setting. Use the clips as visual concepts for interactive narrative paths.
Client revision rounds
Generate a revised shot with one requested change, such as lighting or character action. Keep the previous usable clip available for comparison.
More on Vidu Q3 Mix and VS Code
Overview
Vidu Q3 Mix in other agents
Questions about Vidu Q3 Mix in VS Code
Can VS Code use Vidu Q3 Mix?
Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Vidu Q3 Mix like any built-in tool.
How much does Vidu Q3 Mix cost in VS Code?
`resolution`: 360p $0.091, 540p $0.091, 720p (default) $0.2002, 1080p $0.2002 per video. Billed on `duration`, default 5. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.
Do I need a fal account to use Vidu Q3 Mix in VS Code?
No. Spiral runs Vidu Q3 Mix 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 Q3 Mix in VS Code?
About two minutes: add the hosted server, then sign in.
Does VS Code wait while Vidu Q3 Mix runs?
Vidu Q3 Mix runs in the background. VS Code starts the run, checks on it and gives you the video when it's ready.
What is Vidu Q3 Mix best suited for?
Use it for short scenes that need recognizable subjects from reference images, camera movement, and sound generated with the picture. Product clips, character scenes, and narrative ads are practical starting points.
How long can a Vidu Q3 Mix video be?
A single generation can run up to 16 seconds. For a longer piece, plan separate shots and assemble the selected clips afterward.
Can Vidu Q3 Mix generate speech and sound effects?
Yes. It can generate speech, sound effects, and music with the visuals; specify the spoken line and the sounds you want in the scene.
Which languages does Vidu Q3 Mix support?
Vidu lists English, Japanese, and Chinese for Q3 output. Name the intended spoken language when requesting dialogue or narration.
What should I check before using a product video?
Review packaging text, logos, proportions, and materials against the references. Vidu identifies changes in these details as common product-video problems, so inspect the product before judging the background.
Start using Vidu Q3 Mix in VS Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into VS Code:
set up https://spiral.ai/SKILL.md


