> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snapgen.org/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax H3

> MiniMax H3 video API via SnapGen: MiniMax H3 video model at 768P, billed from prepaid balance.

`minimax-h3` is the MiniMax H3 video model at 768P: text, image, or video input and 4 to 15 second output.

| Property | Value                                        |
| -------- | -------------------------------------------- |
| Model ID | `minimax-h3`                                 |
| Input    | prompt + images + video                      |
| Output   | 768P video                                   |
| Duration | 4 to 15 seconds                              |
| Price    | \$0.105 per second (10.5 credits per second) |

Confirm live rates on the [models page](https://snapgen.org/models/minimax-h3).

<ParamField body="model" type="string" required>
  Set to `minimax-h3`.
</ParamField>

<ParamField body="prompt" type="string" required>
  Describe the subject, action, camera movement, lighting, and audio intent.
</ParamField>

<ParamField body="seconds" type="string" default="10">
  Output length: 4 to 15 seconds.
</ParamField>

<ParamField body="aspect_ratio" type="string">
  One of `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. Send it explicitly; do not send a pixel `size`.
</ParamField>

<ParamField body="image_urls" type="string[]">
  Up to 9 public `http`/`https` image URLs, each up to 30 MB (JPEG, PNG, WEBP).
</ParamField>

<ParamField body="video_url" type="string">
  One public source video URL, up to 200 MB (MP4, MOV). Send a string, not an array.
</ParamField>

## Request

```bash theme={null}
curl https://api.snapgen.org/v1/videos \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "A red kite climbs over a windy beach, handheld camera",
    "seconds": "5",
    "aspect_ratio": "21:9"
  }'
```

The response returns a queued task `id`. Poll and download with the same `model`:

```bash theme={null}
curl "https://api.snapgen.org/v1/videos/$VIDEO_ID?model=minimax-h3" \
  -H "Authorization: Bearer $SNAPGEN_API_KEY"

curl -L "https://api.snapgen.org/v1/videos/$VIDEO_ID/content?model=minimax-h3" \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  --output video.mp4
```

See the [Video API workflow](/api-reference/video-generation) for polling intervals, webhooks, and failure handling.

<Note>
  Media inputs must be public `http` or `https` URLs. Private network addresses and
  local files are rejected. Failed generations are not charged.
</Note>