How to Use MiniMax H3 Reference to Video in VS Code
MiniMax H3 Reference to Video combines subject, style, motion, and audio references into a new shot. Unlike MiniMax H3 Image to Video, references can guide the result without becoming its opening frame.
Prompts to try with MiniMax H3 Reference to Video in VS Code
Copy an example into VS Code, or ask in your own words.
Use MiniMax H3 Reference to Video with the character sheet and motion study in the project. Create an 8-second, 768p scene using the sheet for appearance and the study for walking motion, with matching footsteps.
Estimate, then generate a 5-second 9:16 clip with MiniMax H3 Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
Make a 10-second product teaser with MiniMax H3 Reference to Video for a smartwatch, slow orbit shot, studio lighting.
Generate three 5-second b-roll clips of a busy coffee shop with MiniMax H3 Reference to Video and list what each cost.
Make a 6-second 16:9 drone shot over a misty pine forest at sunrise with MiniMax H3 Reference to Video.
How to set up MiniMax H3 Reference to Video in VS Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to VS Code on the console's Agents & MCP page, or run:
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}' - Sign in
VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.
Use the Spiral skill
- Send VS Code 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 MiniMax H3 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": "minimax/h3/reference-to-video", "input": { "prompt": "Image 1 is the female protagonist. Image 2 is her small dog. Keep the woman and dog consistent with their respective reference images while they walk together…" } }'
Then paste one of the prompts above: VS Code finds MiniMax H3 Reference to Video on Spiral, shows the price and runs it.
MiniMax H3 Reference to Video providers and prices
Spiral runs MiniMax H3 Reference to Video through fal. Open a card for today's price, with every fee included.
resolution: 480P $0.065, 768P $0.078, 2K (default) $0.169, 4K $0.208 per second. Billed on duration, default 5.
Settings you can ask for
MiniMax H3 Reference to Video works from your prompt, reference image URLs, reference video URLs, and reference audio URLs. Ask VS Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Duration | 5 to 15 | 5 | The duration of the video in seconds. |
| Resolution | 480P, 768P, 2K, or 4K | 2K | The resolution of the generated video. 480P and 768P are native generation modes; 2K and 4K upscale a 768P base result. |
| Seed | a whole number | Random seed. A random seed is selected when omitted. | |
| Aspect ratio | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16 | adaptive | The aspect ratio of the generated video. |
Every API field of MiniMax H3 Reference to Video is on its tool page: open its card above.
What can you do with MiniMax H3 Reference to Video in VS Code?
Turn a project's creative brief into short audiovisual assets for a website, game, or demo. Have the agent translate the brief into concrete compositions, actions, and sounds, then review fine details before adding the clips to the project.
Short product promos
Build a brief product scene around one visible action, such as pouring a drink or opening a case, with matching sound. Choose text-led creation or supply product imagery where supported.
Atmospheric footage
Create a short rainy street, windblown landscape, or quiet workshop shot. Specify the visible movement and environmental sounds as one scene.
Animated explainer scenes
Illustrate one simple idea per clip, such as water filling a reservoir or a parcel moving along a conveyor. Use a concrete action that fits within 15 seconds.
Storyboard motion tests
Test a short story beat before committing to a longer edit. Describe the opening composition, what changes, and the sound accompanying the action.
Still artwork brought into motion
Use supplied artwork to guide a short animated scene. Describe how its subject moves and which visual features should remain consistent.
Motion reference studies
Use a supplied video to guide movement while image references define the subject or look. State exactly which motion to borrow and which appearance to preserve.
More on MiniMax H3 Reference to Video and VS Code
Overview
MiniMax H3 Reference to Video in other agents
Questions about MiniMax H3 Reference to Video in VS Code
Can VS Code use MiniMax H3 Reference to Video?
Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run MiniMax H3 Reference to Video like any built-in tool.
How much does MiniMax H3 Reference to Video cost in VS Code?
`resolution`: 480P $0.065, 768P $0.078, 2K (default) $0.169, 4K $0.208 per second. 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 VS Code plan is separate.
Do I need a fal account to use MiniMax H3 Reference to Video in VS Code?
No. Spiral runs MiniMax H3 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 MiniMax H3 Reference to Video in VS Code?
About two minutes: add the hosted server, then sign in.
Does VS Code wait while MiniMax H3 Reference to Video runs?
MiniMax H3 Reference to Video runs in the background. VS Code starts the run, checks on it and gives you the video when it's ready.
What is MiniMax H3 useful for?
Use MiniMax H3 for short scenes where picture and sound need to work together, such as product promos, atmospheric footage, and animated story beats. Describe the visible action and audible events together.
Does MiniMax H3 generate sound?
Yes. MiniMax H3 generates synchronized stereo audio with its video, so include the sounds the scene needs in your brief.
Which spoken languages does MiniMax H3 support?
MiniMax documents stable dialogue support for Arabic, Chinese, English, French, German, Italian, Japanese, Korean, Portuguese, Russian, and Spanish. Write the surrounding description in English and keep dialogue in its intended language.
Can MiniMax H3 make a one-minute video?
A single generation lasts at most 15 seconds. Plan a minute-long piece as several short shots and assemble them afterward.
How should I write a MiniMax H3 prompt?
Specify the visual style, opening composition, subject, action, and sounds. Use observable details such as a hand placing a cup on a counter instead of abstract instructions such as making the scene feel meaningful.
Start using MiniMax H3 Reference to Video in VS Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into VS Code:
set up https://spiral.ai/SKILL.md


