# H3 Max

Three sizes up to 1080p, five to fifteen seconds, and no sound. Start it on a picture, on references, or on words alone.

Model id: `h3-max`
Type: Video
Made by: MiniMax
Inputs: Text, First frame, References, Audio
Length: 5 to 15 s
Resolution: 480P, 768P, 1080P
Aspect ratio: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Updated: Oct 12, 2026

## Pricing

| Setting | MiniAPI | fal | Difference |
| --- | ---: | ---: | ---: |
| 480p | $0.055 / s | $0.05 | +10% |
| 768p | $0.088 / s | $0.08 | +10% |
| 1080p | $0.176 / s | $0.16 | +10% |

You are not charged for a job that fails.

## Parameters

| Name | Required | Values | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` | Yes | text |  | What to make, in plain words. |
| `image_url` | No | https URL |  | A picture to start from. We fetch it and keep a copy for the job. Only with first frame. |
| `end_image_url` | No | https URL |  | A picture for the last frame. Only with first frame. |
| `target_audio_url` | No | https URL |  | The speech the face should say. |
| `reference_audio_urls` | No | https URLs |  | Sound to follow or lip-sync to. Only with references. |
| `reference_image_urls` | No | https URLs |  | Pictures that show a face, an outfit or a product to keep the same. Only with references. |
| `reference_video_urls` | No | https URLs |  | Clips that show a motion or style to follow. Only with references. |
| `duration` | No | 5 to 15 | 5 | Length in seconds. The price changes with it. |
| `resolution` | No | 480P, 768P, 1080P | 768P | Output size. Higher is sharper, slower and costs more. |
| `prompt_expansion_mode` | For first frame | 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. |
| `aspect_ratio` | No | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive | Shape of the result, for example 16:9 or 9:16. |
| `seed` | No | integer |  | The same seed with the same settings gives a similar result. Leave it out for a random one. |

## Quickstart

```bash
curl -X POST "https://api.minicut.ai/v1/queue/h3-max" \
  -H "Authorization: Key $MINIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a red fox runs through snow at dawn","duration":5}'
```

```json
{
  "request_id": "0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "status": "IN_QUEUE",
  "queue_position": 0,
  "status_url": "https://api.minicut.ai/v1/queue/h3-max/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/status",
  "response_url": "https://api.minicut.ai/v1/queue/h3-max/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "cancel_url": "https://api.minicut.ai/v1/queue/h3-max/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/cancel",
  "price": "0.440000",
  "currency": "USD"
}
```

Page: https://api.minicut.ai/models/h3-max
API reference: https://api.minicut.ai/docs/api