[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [H3 Max Camera Controls](https://spiral.ai/integrations/cursor/h3-max-camera-controls)

# How to Use H3 Max Camera Controls in Cursor

H3 Max Camera Controls turns one still image into a video with a planned orbit, rise, or approach. Use it for shots where the viewpoint moves while the subject stays frozen, with camera keyframes controlling angle and distance.

|  |  |
| --- | --- |
| Model | H3 Max Camera Controls |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 480P (default) $0.065, 768P $0.104, 1080P $0.208, 2K $0.416 per second. Billed on `duration`, default 5. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with H3 Max Camera Controls in Cursor

- Use H3 Max Camera Controls with the product hero image in this project to create a 5-second, 768p shot with a gentle 20-degree orbit. Keep the product, background, and lighting frozen.
- Use H3 Max Camera Controls with our architectural concept render to create a 6-second, 768p shot that gradually raises the viewpoint. Preserve the building and surrounding scene, then flag visible changes from the source.
- Use H3 Max Camera Controls with the game's environment still to make two 5-second camera studies: a small orbit and a slow approach. Keep all scene elements stationary and save both for comparison.
- Use H3 Max Camera Controls with the storyboard image in the project to create a 10-second shot that approaches the subject without changing its pose. Check the returned clip's actual duration.
- Use H3 Max Camera Controls with our sculpture photograph to create a 5-second, 1080p clip with a small rising orbit. Keep the sculpture and lighting fixed, then inspect the newly revealed surfaces.

## How to set up H3 Max Camera Controls 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 H3 Max Camera Controls**: 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-max/camera-controls",
    "input": {
      "prompt_expansion_mode": "balanced",
      "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg"
    }
  }'
```

Then paste one of the prompts above: Cursor finds H3 Max Camera Controls on Spiral, shows the price and runs it.

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

## H3 Max Camera Controls tools and prices

- [H3 Max Camera Controls](https://spiral.ai/tools/fal/minimax/h3-max/camera-controls) (fal): `resolution`: 480P (default) $0.065, 768P $0.104, 1080P $0.208 per second. Billed on `duration`, default 5.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prompt |  | The same elements in the reference are rigid. Preserve every element exactly. The entire scene is frozen. Only the camera moves. no scene motion only camera motion | Text prompt for video generation. When omitted or blank, defaults to preserving the frozen reference scene while only the camera moves. |
| duration | 0.92 to 15 | 5 | Video length in seconds. The output can run up to about 0.7 s longer than requested. |
| resolution | 480P, 768P, 1080P | 480P | The native generation resolution, or 1080P latent refinement from a native 768P source. |
| seed |  | — | Random seed. A random seed is selected when omitted. |
| camera_trajectory |  | — | Ordered camera keyframes. The first pose is held before its time and the final pose is held for the remainder of the video. Signed full turns are preserved, with at most 32 turns of total azimuth travel. |

## What can you do with H3 Max Camera Controls in Cursor?

Turn project artwork into camera-movement studies and short presentation clips. A coding agent can use repository images as references and help review generated viewpoints against the original assets.

### Product listing clips

Turn a product photograph into a short orbit for a listing. Start with a modest angle and check newly revealed product details before publishing.

### Architectural concept reveals

Add a gentle rise or approach to an architectural rendering for a design presentation. Review generated details against the original design.

### Frozen sports moments

Move the viewpoint around a photographed jump or balanced pose while asking the athlete and background to remain motionless.

### Film shot planning

Use a storyboard image to compare an orbit, an approach, and a rising viewpoint before choosing a camera move for production.

### Game environment previews

Give an environment still a short camera move for a pitch or development update. Inspect any scenery revealed beyond the original viewpoint.

### Artwork presentation videos

Add a restrained viewpoint shift to a staged sculpture or installation photograph, keeping the artwork and setting frozen.

## Overview

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

## H3 Max Camera Controls in other agents

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

## More Cursor guides

- [H3 Max 3D to Video](https://spiral.ai/integrations/cursor/h3-max-3d-to-video)
- [H3 Max Extend Video](https://spiral.ai/integrations/cursor/h3-max-extend-video)
- [Grok Imagine Video 1.5 Text to Video](https://spiral.ai/integrations/cursor/grok-imagine-video-1-5-text-to-video)
- [H3 Max Image to Video](https://spiral.ai/integrations/cursor/h3-max-image-to-video)
- [Grok Imagine Video 1.5 Reference to Video](https://spiral.ai/integrations/cursor/grok-imagine-video-1-5-reference-to-video)
- [H3 Max Lip Sync](https://spiral.ai/integrations/cursor/h3-max-lip-sync)

## Questions about H3 Max Camera Controls in Cursor

**Can Cursor use H3 Max Camera Controls?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run H3 Max Camera Controls like any built-in tool.

**How much does H3 Max Camera Controls cost in Cursor?**

`resolution`: 480P (default) $0.065, 768P $0.104, 1080P $0.208, 2K $0.416 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 H3 Max Camera Controls in Cursor?**

No. Spiral runs H3 Max Camera Controls on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up H3 Max Camera Controls in Cursor?**

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

**Does Cursor wait while H3 Max Camera Controls runs?**

H3 Max Camera Controls runs in the background. Cursor starts the run, checks on it and gives you the video when it's ready.

**What is H3 Max Camera Controls good for?**

Use it to add a planned viewpoint change to a still composition: a product orbit, an architectural reveal, or a frozen-action shot. Its defining use is moving the camera while holding the scene still.

**How should I prompt H3 Max Camera Controls?**

Keep an explicit instruction that the scene is frozen and only the camera moves. Add the objects, poses, and lighting you want preserved rather than replacing that instruction with a general scene description.

**Can I trust details revealed behind the subject?**

Treat newly revealed surfaces as generated interpretations. Wider camera moves require more invention, so start with a short arc and inspect the result against the source image.

**Does H3 Max Camera Controls generate native 1080p?**

The 1080p output refines a native 768p source. Review the camera move and subject consistency before choosing the higher-resolution output.

**How long can a shot be?**

The guide documents shots up to 15 seconds. The returned video can run about 0.7 seconds beyond the requested length, so check its actual duration before editing it into a timed sequence.

