# MiniMax H3

Everything in one prompt: pictures, clips and sound, with sound on every generation. The first five references are free.

Model id: `minimax-h3`
Type: Video
Made by: MiniMax
Inputs: Text, First frame, References, Audio
Length: 5 to 15 s
Resolution: 480P, 768P, 2K, 4K
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.066 / s | $0.06 | +10% |
| 2K | $0.143 / s | $0.13 | +10% |
| 4K | $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, 2K, 4K | 2K | Output size. Higher is sharper, slower and costs more. |
| `prompt_expansion_mode` | No | text | 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` | 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/minimax-h3" \
  -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/minimax-h3/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/status",
  "response_url": "https://api.minicut.ai/v1/queue/minimax-h3/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "cancel_url": "https://api.minicut.ai/v1/queue/minimax-h3/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/cancel",
  "price": "0.715000",
  "currency": "USD"
}
```

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