# MiniMax H3

ID: minimax/h3
Type: image generation
Vendor: MiniMax
Released: 2026-08-02 (H3)
Description: MiniMax H3 is an open-weights cinema-grade image model for photoreal text-to-image and identity-preserving edits from up to 9 references, at native 1K or 2K.

## Modes and inputs
- Text → Image (`txt->img`)
  - Prompt only, no input images
- Image → Image (`img->img`)
  - any image: 1 to 9 (required)

## Output
- Aspect ratios: 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9. Other ratios snap to the closest one. Without `size` (or with `"auto"`), Mynth picks a ratio for the prompt.
- 4K: no
- Negative prompt: not supported (dropped, no error)

## Pricing (USD)
- Per image: $0.060
- Per input image: $0.030, charged once for each image it goes into
- Only successful results are charged.

## Usage
Set the request's `model` field to `minimax/h3`. Always pass it explicitly.

TypeScript SDK, Text → Image:

```ts
import Mynth from "@mynthio/sdk";

const mynth = new Mynth();

const task = await mynth.image.generate({
  model: "minimax/h3",
  prompt: "A lighthouse at dusk, 35mm film",
  size: "16:9",
});

console.log(task.urls[0]);
```

REST (cURL), Text → Image:

```bash
curl https://api.mynth.io/image/generate \
  -H "Authorization: Bearer $MYNTH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/h3",
    "prompt": "A lighthouse at dusk, 35mm film",
    "size": "16:9"
  }'
```

CLI, Text → Image:

```bash
npx @mynthio/cli image generate \
  -m minimax/h3 \
  -p "A lighthouse at dusk, 35mm film" \
  -s 16:9
```

TypeScript SDK, Image → Image:

```ts
import Mynth from "@mynthio/sdk";

const mynth = new Mynth();

const task = await mynth.image.generate({
  model: "minimax/h3",
  prompt: "The same lighthouse, now in heavy fog",
  inputs: ["https://cdn.example.com/lighthouse.png"],
});

console.log(task.urls[0]);
```

REST (cURL), Image → Image:

```bash
curl https://api.mynth.io/image/generate \
  -H "Authorization: Bearer $MYNTH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/h3",
    "prompt": "The same lighthouse, now in heavy fog",
    "inputs": ["https://cdn.example.com/lighthouse.png"]
  }'
```

CLI, Image → Image:

```bash
npx @mynthio/cli image generate \
  -m minimax/h3 \
  -p "The same lighthouse, now in heavy fog" \
  -i https://cdn.example.com/lighthouse.png
```

## Links
- Model page: https://mynth.io/models/minimax%2Fh3
- Playground: https://mynth.io/playground?_m=minimax%2Fh3
- Vendor page: https://www.minimax.io/blog/minimax-h3
- License: https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/LICENSE
- API docs (image generation request): https://mynth.io/docs/api-reference/endpoints/image/generate.md
- Quickstart: https://mynth.io/docs/getting-started.md
- SDK (JS/TS): https://mynth.io/docs/sdks/typescript.md
- This page as JSON: https://mynth.io/models/minimax%2Fh3.json

## Similar models
- FLUX.2 Flex [black-forest-labs/flux.2-flex]: https://mynth.io/models/black-forest-labs%2Fflux.2-flex.md
- Ideogram 4.5 [ideogram/ideogram-4.5]: https://mynth.io/models/ideogram%2Fideogram-4.5.md
- Grok Imagine Image 2.0 [xai/grok-imagine-image-2.0]: https://mynth.io/models/xai%2Fgrok-imagine-image-2.0.md
- Qwen Image 2.0 Pro [alibaba/qwen-image-2.0-pro]: https://mynth.io/models/alibaba%2Fqwen-image-2.0-pro.md
- FLUX.2 Max [black-forest-labs/flux.2-max]: https://mynth.io/models/black-forest-labs%2Fflux.2-max.md