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

# MiniMax H3

> Use MiniMax H3 with the Mynth SDK or REST API. Capabilities, inputs, auto size, and magic prompt.

```text Model ID theme={"theme":"kanagawa-dragon"}
minimax/h3
```

See pricing & more on [mynth.io](https://mynth.io/models/minimax%2Fh3).

## Capabilities

|                      |                                 |
| -------------------- | ------------------------------- |
| **Modes**            | Text-to-image · Image-to-image  |
| **Inputs**           | Up to 9 images (image-to-image) |
| **Native auto size** | Image-to-image only             |
| **Magic prompt**     | Supported                       |

MiniMax H3 is a cinema-grade still-image model. Text-to-image produces photorealistic 2K frames from a prompt. Image-to-image re-renders a subject from up to nine references into a new scene, outfit, or style while keeping identity.

## Generate

<CodeGroup>
  ```ts Mynth SDK theme={"theme":"kanagawa-dragon"}
  import Mynth from "@mynthio/sdk";

  const mynth = new Mynth();

  const task = await mynth.image.generate({
    prompt:
      "Cinematic portrait of a young man in a navy wool coat at a foggy Lisbon tram stop at dawn, 50mm lens, shallow depth of field",
    model: "minimax/h3",
    size: "portrait",
    count: 1,
  });

  console.log(task.urls);
  ```

  ```bash REST API theme={"theme":"kanagawa-dragon"}
  curl https://api.mynth.io/image/generate \
    -X POST \
    -H "Authorization: Bearer $MYNTH_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "prompt": "Cinematic portrait of a young man in a navy wool coat at a foggy Lisbon tram stop at dawn, 50mm lens, shallow depth of field",
      "model": "minimax/h3",
      "size": "portrait",
      "count": 1
    }'
  ```
</CodeGroup>

## Use inputs

Pass up to **9** input images for image-to-image. URLs or uploaded files both work. See [Upload input images](/guides/upload-input-images).

<CodeGroup>
  ```ts Mynth SDK theme={"theme":"kanagawa-dragon"}
  const task = await mynth.image.generate({
    prompt: "The same person from the first image, now wearing a red leather jacket in a neon-lit Tokyo alley at night",
    model: "minimax/h3",
    inputs: ["https://example.com/input-image.jpg"],
    size: "auto",
  });
  ```

  ```bash REST API theme={"theme":"kanagawa-dragon"}
  curl https://api.mynth.io/image/generate \
    -X POST \
    -H "Authorization: Bearer $MYNTH_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "prompt": "The same person from the first image, now wearing a red leather jacket in a neon-lit Tokyo alley at night",
      "model": "minimax/h3",
      "inputs": [
        {
          "type": "image",
          "source": { "type": "url", "url": "https://example.com/input-image.jpg" }
        }
      ],
      "size": "auto"
    }'
  ```
</CodeGroup>

## Auto size

Image-to-image supports **native auto size**. Left unset, output keeps the first reference image's ratio.

```ts theme={"theme":"kanagawa-dragon"}
size: "auto";
```

See [Control size](/guides/control-size).
