[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Vidu Q3 Mix](https://spiral.ai/integrations/opencode/vidu-q3-mix)

# How to Use Vidu Q3 Mix in opencode

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.

|  |  |
| --- | --- |
| Model | Vidu Q3 Mix |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 360p $0.091, 540p $0.091, 720p (default) $0.2002, 1080p $0.2002 per video. Billed on `duration`, default 5. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Vidu Q3 Mix in opencode

- 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 opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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.

```bash
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.

```bash
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: opencode finds Vidu Q3 Mix on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## Vidu Q3 Mix tools and prices

- [Vidu](https://spiral.ai/tools/fal/fal-ai/vidu/q3/reference-to-video/mix) (fal): `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

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| duration | 1 to 16 | 5 | Duration of the video in seconds (1-16 for Q3 models) |
| seed |  | — | Random seed for reproducibility. If None, a random seed is chosen. |
| aspect_ratio | 16:9, 9:16, 4:3, 3:4, 1:1 | 16:9 | The aspect ratio of the output video |
| resolution | 360p, 540p, 720p, 1080p | 720p | Output video resolution |
| audio |  | true | Whether to use direct audio-video generation. When true, outputs video with sound. |

## What can you do with Vidu Q3 Mix in opencode?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## Vidu Q3 Mix in other agents

- [Amp](https://spiral.ai/integrations/amp/vidu-q3-mix)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/vidu-q3-mix)
- [Claude](https://spiral.ai/integrations/claude-desktop/vidu-q3-mix)
- [Claude Code](https://spiral.ai/integrations/claude-code/vidu-q3-mix)
- [Cline](https://spiral.ai/integrations/cline/vidu-q3-mix)
- [Codex](https://spiral.ai/integrations/codex/vidu-q3-mix)
- [Cursor](https://spiral.ai/integrations/cursor/vidu-q3-mix)
- [Devin](https://spiral.ai/integrations/devin/vidu-q3-mix)
- [dots](https://spiral.ai/integrations/dots/vidu-q3-mix)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/vidu-q3-mix)
- [Gemini](https://spiral.ai/integrations/gemini/vidu-q3-mix)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/vidu-q3-mix)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/vidu-q3-mix)
- [goose](https://spiral.ai/integrations/goose/vidu-q3-mix)
- [Grok](https://spiral.ai/integrations/grok/vidu-q3-mix)
- [Grok Build](https://spiral.ai/integrations/grok-build/vidu-q3-mix)
- [Hermes](https://spiral.ai/integrations/hermes/vidu-q3-mix)
- [Instinct](https://spiral.ai/integrations/instinct/vidu-q3-mix)
- [Manus](https://spiral.ai/integrations/manus/vidu-q3-mix)
- [Muse](https://spiral.ai/integrations/muse/vidu-q3-mix)
- [Muse Code](https://spiral.ai/integrations/muse-code/vidu-q3-mix)
- [n8n](https://spiral.ai/integrations/n8n/vidu-q3-mix)
- [Notion](https://spiral.ai/integrations/notion/vidu-q3-mix)
- [OpenClaw](https://spiral.ai/integrations/openclaw/vidu-q3-mix)
- [Perplexity](https://spiral.ai/integrations/perplexity/vidu-q3-mix)
- [Raycast](https://spiral.ai/integrations/raycast/vidu-q3-mix)
- [VS Code](https://spiral.ai/integrations/vscode/vidu-q3-mix)
- [Windsurf](https://spiral.ai/integrations/windsurf/vidu-q3-mix)
- [Zapier](https://spiral.ai/integrations/zapier/vidu-q3-mix)

## More opencode guides

- [Vidu Q2 Turbo Image to Video](https://spiral.ai/integrations/opencode/vidu-q2-turbo-image-to-video)
- [Vidu Q3 Pro Image to Video](https://spiral.ai/integrations/opencode/vidu-q3-pro-image-to-video)
- [Vidu Q2 Text to Video](https://spiral.ai/integrations/opencode/vidu-q2-text-to-video)
- [Vidu Q3 Pro Text to Video](https://spiral.ai/integrations/opencode/vidu-q3-pro-text-to-video)
- [Vidu Q2 Pro Video Extension](https://spiral.ai/integrations/opencode/vidu-q2-pro-video-extension)
- [Vidu Q3 Turbo Image to Video](https://spiral.ai/integrations/opencode/vidu-q3-turbo-image-to-video)

## Questions about Vidu Q3 Mix in opencode

**Can opencode use Vidu Q3 Mix?**

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

**How much does Vidu Q3 Mix cost in opencode?**

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

**Do I need a fal account to use Vidu Q3 Mix in opencode?**

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 opencode?**

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

**Does opencode wait while Vidu Q3 Mix runs?**

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

