[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [MiniMax H3 Reference to Video](https://spiral.ai/integrations/cursor/minimax-h3-reference-to-video)

# How to Use MiniMax H3 Reference to Video in Cursor

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.

|  |  |
| --- | --- |
| Model | MiniMax H3 Reference to Video |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 480P $0.065, 768P $0.078, 2K (default) $0.169, 4K $0.208 per second. Billed on `duration`, default 5. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with MiniMax H3 Reference to Video in Cursor

- 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 Cursor

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor 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 MiniMax H3 Reference 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": "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: Cursor finds MiniMax H3 Reference to Video on Spiral, shows the price and runs it.

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

## MiniMax H3 Reference to Video tools and prices

- [MiniMax H3 Reference to Video](https://spiral.ai/tools/fal/minimax/h3/reference-to-video) (fal): `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

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| duration | 5 to 15 | 5 | The duration of the video in seconds. |
| resolution | 480P, 768P, 2K, 4K | 2K | The resolution of the generated video. 480P and 768P are native generation modes; 2K and 4K upscale a 768P base result. |
| seed |  | — | Random seed. A random seed is selected when omitted. |
| prompt_expansion_mode |  | balanced | How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion. 'fast' returns in about a second. 'balanced' picks per request. 'quality' spends up to ~30s on a richer prompt. |
| aspect_ratio | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive | The aspect ratio of the generated video. |
| reference_image_urls |  | — | URLs of subject/style reference images, referenced in the prompt as Image 1, Image 2, and so on. Reference images, videos, and audio clips must add up to at most 12 files. |

## What can you do with MiniMax H3 Reference to Video in Cursor?

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.

## Overview

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

## MiniMax H3 Reference to Video in other agents

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

## More Cursor guides

- [MiniMax H3 Max Recast](https://spiral.ai/integrations/cursor/minimax-h3-max-recast)
- [MiniMax H3 Reference to Video LoRA](https://spiral.ai/integrations/cursor/minimax-h3-reference-to-video-lora)
- [MiniMax H3 Image to Video LoRA](https://spiral.ai/integrations/cursor/minimax-h3-image-to-video-lora)
- [MiniMax H3 Text to Video](https://spiral.ai/integrations/cursor/minimax-h3-text-to-video)
- [MiniMax H3 Image to Video](https://spiral.ai/integrations/cursor/minimax-h3-image-to-video)
- [MiniMax H3 Text to Video LoRA](https://spiral.ai/integrations/cursor/minimax-h3-text-to-video-lora)

## Questions about MiniMax H3 Reference to Video in Cursor

**Can Cursor use MiniMax H3 Reference to Video?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run MiniMax H3 Reference to Video like any built-in tool.

**How much does MiniMax H3 Reference to Video cost in Cursor?**

`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 Cursor plan is separate.

**Do I need a fal account to use MiniMax H3 Reference to Video in Cursor?**

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 Cursor?**

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

**Does Cursor wait while MiniMax H3 Reference to Video runs?**

MiniMax H3 Reference to Video runs in the background. Cursor 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.

