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

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

Vidu Q3 Pro Image to Video turns a still into a short scene with motion and optional sound. Unlike Vidu Q3 Pro Text to Video, it anchors the opening to your image and can work toward a supplied ending frame.

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

- Find the product hero image in this project and use Vidu Q3 Pro Image to Video to animate it for 6 seconds at 1080p. Start from that image, move the camera slowly closer, and request a silent clip.
- Animate the image I attach with Vidu Q3 Pro Image to Video: slow push-in, leaves moving in the wind. Save the result in ./assets.
- Turn this product photo into a 5-second rotating shot with Vidu Q3 Pro Image to Video.
- Bring this portrait to life with Vidu Q3 Pro Image to Video: a subtle smile and a blink.
- Animate this illustration with Vidu Q3 Pro Image to Video: clouds drifting, a slow camera pan to the right.

## How to set up Vidu Q3 Pro Image 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 Image 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/image-to-video",
    "input": {
      "image_url": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
    }
  }'
```

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

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

## Vidu Q3 Pro Image to Video tools and prices

- [Vidu · Image To Video](https://spiral.ai/tools/fal/fal-ai/vidu/q3/image-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 |
| --- | --- | --- | --- |
| prompt |  |  | Text prompt for video generation, max 2000 characters |
| end_image_url |  | — | URL of the image to use as the ending frame. When provided, generates a transition video between start and end frames. |
| 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. |
| resolution | 360p, 540p, 720p, 1080p | 720p | Output video resolution. Note: 360p is not available when end_image_url is provided. |
| audio |  | true | Whether to use direct audio-video generation. When true, outputs video with sound (including dialogue and sound effects). |

## What can you do with Vidu Q3 Pro Image 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.

### Product photo animation

Start with a product photograph and request a small movement, changing reflection, or camera push. Review the result against the original product details.

### Illustrated panel animation

Turn a finished illustration into a short moving scene. Use the artwork as the opening frame and describe the character action and sound.

## Overview

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

## Vidu Q3 Pro Image to Video in other agents

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

## More opencode guides

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

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

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

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

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

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

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

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

Vidu Q3 Pro Image 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.

