[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Vidu Q4 Image to Video](https://spiral.ai/integrations/opencode/vidu-q4-image-to-video)

# How to Use Vidu Q4 Image to Video in opencode

Turn a finished still into a short product shot or character scene with directed motion. Unlike Reference to Video, this version uses your image as the opening frame, making it a useful choice when the starting composition matters.

|  |  |
| --- | --- |
| Model | Vidu Q4 Image to Video |
| Available through | fal |
| Category | Video |
| Price | $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`. |
| Returns | video, image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Vidu Q4 Image to Video in opencode

- Use Vidu Q4 Image to Video with public/images/hero-product.png as the opening frame. Make a 5-second 1080p shot: the camera slowly pushes toward the bottle while side lighting reveals the glass texture. Save the selected clip with the project's media assets.
- Use Vidu Q4 Image to Video to animate assets/storyboards/arrival.png for 6 seconds at 720p. The traveler takes one step toward the door as the camera tracks gently right. Compare the result with the storyboard's intended composition.
- Use Vidu Q4 Image to Video with assets/product/still.png to make two 5-second 720p camera studies. Keep the product action the same; request a slow push-in for one and a lateral track for the other. Place both clips beside the shot notes for review.
- Animate the image I attach with Vidu Q4 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 Q4 Image to Video.

## How to set up Vidu Q4 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 Q4 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/q4/image-to-video",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/web-examples/vidu/stylish_woman.webp"
    }
  }'
```

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

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

## Vidu Q4 Image to Video tools and prices

- [Vidu Q4 · Image to Video](https://spiral.ai/tools/fal/fal-ai/vidu/q4/image-to-video) (fal): $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. Per unit of `duration`: 540p $0.04095, 720p (default) $0.08645, 1080p $0.1092, 2K $0.1729, 4K $0.3549.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prompt |  |  | Text prompt for video generation, max 5000 characters |
| duration | 3 to 16 | 5 | Duration of the video in seconds (3-16) |
| seed |  | — | Random seed for reproducibility. If None, a random seed is chosen. |
| resolution | 540p, 720p, 1080p, 2K, 4K | 720p | Output video resolution |

## What can you do with Vidu Q4 Image to Video in opencode?

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.

### Animate a campaign still

Use the approved campaign image as the opening frame and specify the movement that follows, such as a head turn, drifting steam, or a slow camera push.

### 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.

## Overview

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

## Vidu Q4 Image to Video in other agents

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

## More opencode guides

- [Vidu Q3 Turbo Text to Video](https://spiral.ai/integrations/opencode/vidu-q3-turbo-text-to-video)
- [Vidu Q4 Reference to Video](https://spiral.ai/integrations/opencode/vidu-q4-reference-to-video)
- [Vidu Q3 Turbo Image to Video](https://spiral.ai/integrations/opencode/vidu-q3-turbo-image-to-video)
- [Vidu Reference to Video](https://spiral.ai/integrations/opencode/vidu-reference-to-video)
- [Vidu Q3 Pro Text to Video](https://spiral.ai/integrations/opencode/vidu-q3-pro-text-to-video)
- [Vidu Start-End to Video](https://spiral.ai/integrations/opencode/vidu-start-end-to-video)

## Questions about Vidu Q4 Image to Video in opencode

**Can opencode use Vidu Q4 Image to Video?**

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

**How much does Vidu Q4 Image to Video cost in opencode?**

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

**Do I need a fal account to use Vidu Q4 Image to Video in opencode?**

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

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

**Does opencode wait while Vidu Q4 Image to Video runs?**

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

