How to Use Vidu Q3 Mix in Windsurf
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 Windsurf
Copy an example into Windsurf, 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 Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf 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: Windsurf 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 Windsurf 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 Windsurf?
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 Windsurf
Overview
Vidu Q3 Mix in other agents
Questions about Vidu Q3 Mix in Windsurf
Can Windsurf use Vidu Q3 Mix?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Vidu Q3 Mix like any built-in tool.
How much does Vidu Q3 Mix cost in Windsurf?
`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 Windsurf plan is separate.
Do I need a fal account to use Vidu Q3 Mix in Windsurf?
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 Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Vidu Q3 Mix runs?
Vidu Q3 Mix runs in the background. Windsurf 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 Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


