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

Windsurf · VideoReleased 2026-10-07

How to Use Vidu Q4 Reference to Video in Windsurf

Build short scenes around supplied characters, products, settings, and voices. Unlike Image to Video, this version uses references to guide subject consistency across camera positions rather than fixing one image as the opening frame.

Prompts to try with Vidu Q4 Reference to Video in Windsurf

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

Use Vidu Q4 Reference to Video with the mascot and workshop images in assets/references. Make an 8-second 1080p scene: the mascot sets a small box on the workbench, looks up, and smiles. Identify each image's role in the generation prompt.

Vidu Q4 Reference to VideoWindsurf
Try asking
  • Use Vidu Q4 Reference to Video with assets/characters/guide.png and assets/voices/guide.mp3. Create an 8-second 1080p scene with generated sound: the guide turns toward the camera and says, 'Your next chapter starts here.' Bind the voice reference to that speaker.

  • Estimate, then generate a 5-second 9:16 clip with Vidu Q4 Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.

  • Make a 10-second product teaser with Vidu Q4 Reference to Video for a smartwatch, slow orbit shot, studio lighting.

  • Generate three 5-second b-roll clips of a busy coffee shop with Vidu Q4 Reference to Video and list what each cost.

How to set up Vidu Q4 Reference to Video in Windsurf

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

Use Spiral's MCP server

  1. 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"
        }
      }
    }
  2. 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
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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 Vidu Q4 Reference 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/reference-to-video",
        "input": {
          "prompt": "[@reference_image_1] walks along the beach at sunset holding [@reference_image_2], then turns to the camera and speaks in the voice of [reference_audio_1]."
        }
      }'

Then paste one of the prompts above: Windsurf finds Vidu Q4 Reference to Video on Spiral, shows the price and runs it.

Vidu Q4 Reference to Video providers and prices

Spiral runs Vidu Q4 Reference to Video through fal. Open a card for today's price, with every fee included.

falVideo
Vidu Q4 · Reference to Video
fal-ai/vidu/q4/reference-to-video

Settings you can ask for

Vidu Q4 Reference to Video works from your prompt, reference image URLs, and reference audio URLs. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Duration3 to 165

Duration of the video in seconds (3-16)

Seeda whole number

Random seed for reproducibility. If None, a random seed is chosen.

Aspect ratio16:9, 9:16, 4:3, 3:4, or 1:116:9

The aspect ratio of the output video

Resolution540p, 720p, 1080p, 2K, or 4K720p

Output video resolution

Audioon or offoff

Whether to generate audio (dialogue and sound effects) with the video. When false, the output video is silent.

Every API field of Vidu Q4 · Reference to Video is on its tool page: open its card above.

What can you do with Vidu Q4 Reference to Video in Windsurf?

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.

Recurring character scenes

Reuse character and setting references to develop separate short scenes. Review identity and appearance across the selected clips before assembling a sequence.

Dialogue with a reference voice

Pair a character reference with a voice sample and a brief line of dialogue. Specify the speaker's action and emotional delivery.

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.

Questions about Vidu Q4 Reference to Video in Windsurf

Can Windsurf use Vidu Q4 Reference to Video?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Vidu Q4 Reference to Video like any built-in tool.

How much does Vidu Q4 Reference to Video cost in Windsurf?

$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 Windsurf plan is separate.

Do I need a fal account to use Vidu Q4 Reference to Video in Windsurf?

No. Spiral runs Vidu Q4 Reference 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 Reference to Video in Windsurf?

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

Does Windsurf wait while Vidu Q4 Reference to Video runs?

Vidu Q4 Reference to Video runs in the background. Windsurf 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.

Get started

Start using Vidu Q4 Reference to Video in Windsurf

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

Paste this into Windsurf:

Set up Windsurf

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