[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Vidu Q3 Pro Text to Video](https://spiral.ai/integrations/opencode/vidu-q3-pro-text-to-video)

# How to Use Vidu Q3 Pro Text to Video in opencode

Vidu Q3 Pro Text to Video creates short scenes from written descriptions, including camera direction and optional sound. Unlike Vidu Q3 Pro Image to Video, it builds the opening scene without a starting image.

|  |  |
| --- | --- |
| Model | Vidu Q3 Pro Text to Video |
| 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 Pro Text to Video in opencode

- Read the landing page copy in this project and use Vidu Q3 Pro Text to Video to create an 8-second, 1080p scene illustrating its main benefit. Use one visible action, a slow camera push, and no speech.
- Read the trailer brief and use Vidu Q3 Pro Text to Video to create a 10-second, 1080p opening shot. Show a courier approaching a closed door, end on the door handle, and include footsteps and one knock.
- Estimate, then generate a 5-second 9:16 clip with Vidu Q3 Pro Text to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with Vidu Q3 Pro Text to Video for a smartwatch, slow orbit shot, studio lighting.
- Generate three 5-second b-roll clips of a busy coffee shop with Vidu Q3 Pro Text to Video and list what each cost.

## How to set up Vidu Q3 Pro Text to Video 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 Pro Text to Video**: 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/text-to-video",
    "input": {
      "prompt": "In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog."
    }
  }'
```

Then paste one of the prompts above: opencode finds Vidu Q3 Pro Text to Video on Spiral, shows the price and runs it.

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

## Vidu Q3 Pro Text to Video tools and prices

- [Vidu · Text to Video ](https://spiral.ai/tools/fal/fal-ai/vidu/q3/text-to-video) (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 |
| 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 Pro Text to Video in opencode?

Turn a project's creative brief into short video assets with directed motion and sound. A coding agent can read the project's files, prepare shot prompts, and place reviewed clips into the site or app.

### Short narrative ads

Build a brief scene around one product benefit, with a visible action and a short spoken payoff. Use a written scene or a prepared opening image.

### Drama scene previews

Test a reveal, reaction, or line of dialogue before committing to a longer sequence. Keep each generated scene within 16 seconds.

### Animated story beats

Create a short animated action with a beginning and payoff, such as a robot discovering a flower. Direct the movement, camera, and accompanying sounds.

### Atmospheric cutaways

Generate rain against a window, a quiet workshop, or a station at dusk. Pair a restrained camera move with specific environmental sounds.

### Localized spoken clips

Produce separate English, Japanese, or Chinese takes of a short scene. Review each generated line before using it in a finished edit.

## Overview

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

## Vidu Q3 Pro Text to Video in other agents

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

## More opencode guides

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

## Questions about Vidu Q3 Pro Text to Video in opencode

**Can opencode use Vidu Q3 Pro Text to Video?**

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

**How much does Vidu Q3 Pro Text to Video 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 Pro Text to Video in opencode?**

No. Spiral runs Vidu Q3 Pro Text 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 Q3 Pro Text to Video in opencode?**

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

**Does opencode wait while Vidu Q3 Pro Text to Video runs?**

Vidu Q3 Pro Text to Video runs in the background. opencode starts the run, checks on it and gives you the video when it's ready.

**What is Vidu Q3 useful for?**

Use Vidu Q3 for short narrative scenes where camera movement, dialogue, and sound need to work together. Practical starting points include animated shorts, drama previews, and brief narrative ads.

**Can Vidu Q3 make a full-length video or native 4K footage?**

A single generation stops at 16 seconds, and the documented Q3 output ceiling is 1080p. Plan longer videos as separate clips assembled in an editor.

**Can Vidu Q3 generate speech and sound effects?**

Yes. Vidu Q3 can generate dialogue, voiceover, effects, and music alongside the visuals, so describe the sounds you want as part of the scene.

**Which languages does Vidu Q3 support?**

Vidu lists English, Japanese, and Chinese for video output. Those are the documented choices for planning spoken scenes.

**How should I prompt camera movement and scene timing?**

Write concrete directions: what the subject does, how the camera moves, and where the shot ends. For a first test, try one action and one camera move, such as a slow push toward a person who turns to speak.

