How to Use Vidu Q4 Reference to Video in Codex
Build short scenes around supplied characters, products, settings, and voices. Unlike Image to Video, this version uses references to guide subject consistency across camera positions rather than fixing one image as the opening frame.
Prompts to try with Vidu Q4 Reference to Video in Codex
Copy an example into Codex, or ask in your own words.
Use Vidu Q4 Reference to Video with the mascot and workshop images in assets/references. Make an 8-second 1080p scene: the mascot sets a small box on the workbench, looks up, and smiles. Identify each image's role in the generation prompt.
Use Vidu Q4 Reference to Video with assets/characters/guide.png and assets/voices/guide.mp3. Create an 8-second 1080p scene with generated sound: the guide turns toward the camera and says, 'Your next chapter starts here.' Bind the voice reference to that speaker.
Estimate, then generate a 5-second 9:16 clip with Vidu Q4 Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
Make a 10-second product teaser with Vidu Q4 Reference to Video for a smartwatch, slow orbit shot, studio lighting.
Generate three 5-second b-roll clips of a busy coffee shop with Vidu Q4 Reference to Video and list what each cost.
How to set up Vidu Q4 Reference to Video in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Vidu Q4 Reference 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/q4/reference-to-video", "input": { "prompt": "[@reference_image_1] walks along the beach at sunset holding [@reference_image_2], then turns to the camera and speaks in the voice of [reference_audio_1]." } }'
Then paste one of the prompts above: Codex finds Vidu Q4 Reference to Video on Spiral, shows the price and runs it.
Vidu Q4 Reference to Video providers and prices
Spiral runs Vidu Q4 Reference to Video through fal. Open a card for today's price, with every fee included.
$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
Vidu Q4 Reference to Video works from your prompt, reference image URLs, and reference audio URLs. Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Duration | 3 to 16 | 5 | Duration of the video in seconds (3-16) |
| Seed | a whole number | Random seed for reproducibility. If None, a random seed is chosen. | |
| Aspect ratio | 16:9, 9:16, 4:3, 3:4, or 1:1 | 16:9 | The aspect ratio of the output video |
| Resolution | 540p, 720p, 1080p, 2K, or 4K | 720p | Output video resolution |
| Audio | on or off | off | Whether to generate audio (dialogue and sound effects) with the video. When false, the output video is silent. |
Every API field of Vidu Q4 · Reference to Video is on its tool page: open its card above.
What can you do with Vidu Q4 Reference to Video in Codex?
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.
Recurring character scenes
Reuse character and setting references to develop separate short scenes. Review identity and appearance across the selected clips before assembling a sequence.
Dialogue with a reference voice
Pair a character reference with a voice sample and a brief line of dialogue. Specify the speaker's action and emotional delivery.
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.
More on Vidu Q4 Reference to Video and Codex
Overview
Vidu Q4 Reference to Video in other agents
Questions about Vidu Q4 Reference to Video in Codex
Can Codex use Vidu Q4 Reference to Video?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Vidu Q4 Reference to Video like any built-in tool.
How much does Vidu Q4 Reference to Video cost in Codex?
$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 Codex plan is separate.
Do I need a fal account to use Vidu Q4 Reference to Video in Codex?
No. Spiral runs Vidu Q4 Reference 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 Reference to Video in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Vidu Q4 Reference to Video runs?
Vidu Q4 Reference to Video runs in the background. Codex 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.
Start using Vidu Q4 Reference to Video in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


