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

Factory Droid · VideoReleased 2026-04-13

How to Use Vidu Q3 Mix in Factory Droid

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 Factory Droid

Copy an example into Factory Droid, 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.

Vidu Q3 MixFactory Droid
Try asking
  • 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 Factory Droid

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

Use Spiral's MCP server

  1. Add the server

    Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.

    droid mcp add spiral https://api.spiral.ai/mcp --type http
  2. Sign in

    Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

  3. Check it

    Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.

    droid mcp list

Use the Spiral skill

  1. Send Factory Droid 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 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: Factory Droid 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.

falVideo
Vidu
fal-ai/vidu/q3/reference-to-video/mix

Settings you can ask for

Vidu Q3 Mix works from your prompt and reference image URLs. Ask Factory Droid for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Duration1 to 165

Duration of the video in seconds (1-16 for Q3 models)

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

Resolution360p, 540p, 720p, or 1080p720p

Output video resolution

Audioon or offon

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 Factory Droid?

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.

Questions about Vidu Q3 Mix in Factory Droid

Can Factory Droid use Vidu Q3 Mix?

Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run Vidu Q3 Mix like any built-in tool.

How much does Vidu Q3 Mix cost in Factory Droid?

`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 Factory Droid plan is separate.

Do I need a fal account to use Vidu Q3 Mix in Factory Droid?

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 Factory Droid?

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

Does Factory Droid wait while Vidu Q3 Mix runs?

Vidu Q3 Mix runs in the background. Factory Droid 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.

Get started

Start using Vidu Q3 Mix in Factory Droid

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

Paste this into Factory Droid:

Set up Factory Droid

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