[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [MiniMax H3 Reference to Video LoRA](https://spiral.ai/integrations/codex/minimax-h3-reference-to-video-lora)

# How to Use MiniMax H3 Reference to Video LoRA in Codex

MiniMax H3 Reference to Video LoRA makes reference-guided clips with trained customization. Compared with MiniMax H3 Reference to Video, it adds LoRA support alongside image, motion, and sound references.

|  |  |
| --- | --- |
| Model | MiniMax H3 Reference to Video LoRA |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 480P $0.08125, 768P $0.0975, 2K (default) $0.21125, 4K $0.26 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 LoRA in Codex

- Estimate, then generate a 5-second 9:16 clip with MiniMax H3 Reference to Video LoRA: 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 LoRA 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 LoRA 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 LoRA.
- Write three video ideas for our launch, then make the best one with MiniMax H3 Reference to Video LoRA and show me the cost first.

## How to set up MiniMax H3 Reference to Video LoRA in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 LoRA**: 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/lora",
    "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…",
      "loras": [
        {
          "path": "https://huggingface.co/owner/repo/resolve/main/lora.safetensors"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Codex finds MiniMax H3 Reference to Video LoRA on Spiral, shows the price and runs it.

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

## MiniMax H3 Reference to Video LoRA tools and prices

- [MiniMax H3 Reference to Video LoRA](https://spiral.ai/tools/fal/minimax/h3/reference-to-video/lora) (fal): `resolution`: 480P $0.08125, 768P $0.0975, 2K (default) $0.21125, 4K $0.26 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 LoRA in Codex?

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.

### Character and style experiments

Apply a trained LoRA to explore a recurring character or visual treatment across short scenes. Review the results for consistency before assembling a sequence.

## Overview

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

## MiniMax H3 Reference to Video LoRA in other agents

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

## More Codex guides

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

## Questions about MiniMax H3 Reference to Video LoRA in Codex

**Can Codex use MiniMax H3 Reference to Video LoRA?**

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

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

`resolution`: 480P $0.08125, 768P $0.0975, 2K (default) $0.21125, 4K $0.26 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 Codex plan is separate.

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

No. Spiral runs MiniMax H3 Reference to Video LoRA 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 LoRA in Codex?**

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

**Does Codex wait while MiniMax H3 Reference to Video LoRA runs?**

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

