# H3 Max Camera Controls

Turn images into video with H3 Max Camera Controls from fal through one Spiral API key. H3 Max Multi Angle turns a single image into a video with precise, keyframe-based control over the camera's orbit, elevation, and distance in 3D space. It runs in the background and returns video. Pay as you go, with no subscription.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Released: 2026-09-11
- Tool id: `fal` / `minimax/h3-max/camera-controls`
- Page: https://spiral.ai/tools/fal/minimax/h3-max/camera-controls

## Pricing

`resolution`: 480P (default) $0.065, 768P $0.104, 1080P $0.208 per second. Billed on `duration`, default 5.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 1 hour
- Longest run, end to end: 930 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` | text |  | 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` | number | 0.92 to 15 | 5 | Video length in seconds. The output can run up to about 0.7 s longer than requested. |
| `resolution` | one of | 480P, 768P, 1080P | 480P | The native generation resolution, or 1080P latent refinement from a native 768P source. |
| `seed` | number (whole) |  | — | Random seed. A random seed is selected when omitted. |
| `prompt_expansion_mode` (required) | text |  | balanced | How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt. |
| `image_url` (required) | URL or file |  | — | URL of the image to use as the first frame. |
| `camera_trajectory` | JSON |  | — | 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. |

## Example

```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"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=minimax%2Fh3-max%2Fcamera-controls

## Common questions

### H3 Max Camera Controls

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

`resolution`: 480P (default) $0.065, 768P $0.104, 1080P $0.208 per second. Billed on `duration`, default 5. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use H3 Max Camera Controls through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "minimax/h3-max/camera-controls"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use H3 Max Camera Controls?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use H3 Max Camera Controls?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

