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

opencode · VideoReleased 2026-01-27

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.

Prompts to try with Vidu Q3 Pro Image to Video in opencode

Copy an example into opencode, or ask in your own words.

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.

Vidu Q3 Pro Image to Videoopencode
Try asking
  • 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.

    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.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    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.

    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.

    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.

Vidu Q3 Pro Image to Video providers and prices

Spiral runs Vidu Q3 Pro Image to Video through fal. Open a card for today's price, with every fee included.

falVideo
Vidu · Image To Video
fal-ai/vidu/q3/image-to-video

Settings you can ask for

Vidu Q3 Pro Image to Video works from your prompt, image URL, and end image URL. Ask opencode 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.

Resolution360p, 540p, 720p, or 1080p720p

Output video resolution. Note: 360p is not available when end_image_url is provided.

Audioon or offon

Whether to use direct audio-video generation. When true, outputs video with sound (including dialogue and sound effects).

Every API field of Vidu · Image To Video is on its tool page: open its card above.

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.

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.

Get started

Start using Vidu Q3 Pro Image to Video in opencode

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

Paste this into opencode:

Set up opencode

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