> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/de/modelle/minimax-h3-image.md).

# MiniMax-H3-Image: Lokal ausführen

MiniMax-H3-Image lokal mit Unsloth-FP8- und GGUF-Quantisierungen für Text-zu-Bild-Generierung und Bildbearbeitung in 6 Schritten ausführen.

**MiniMax-H3-Image** ist MiniMax’ offenes 33B-Modell für Text-zu-Bild-Generierung und Bildbearbeitung mit bis zu 16 Referenzbildern. Es funktioniert am besten mit langen, vollständigen Prompts. Es wurde destilliert auf **6 Schritte, kein CFG**, auf einer **2048 × 2048** Leinwand: etwa **5 s** pro Bild mit dem FP8-Repository und **18 s** mit UD-Q4\_K\_XL auf einer 40-GB-A100.

{% columns %}
{% column width="50%" %}
Die quantisierten Modelle verwenden [Unsloth Dynamic](https://unsloth.ai/docs/basics/dynamic-3.0-ggufs), wodurch wichtige Schichten mit höherer Präzision erhalten bleiben. Führe sie mit [Unsloth](https://unsloth.ai/docs/de/desktop.md), stable-diffusion.cpp und weiteren Tools aus.

* MiniMax-H3-Image: [GGUF](https://huggingface.co/unsloth/MiniMax-H3-Image-GGUF) • [FP8](https://huggingface.co/unsloth/MiniMax-H3-Image-FP8)
* Originalmodell: [MiniMaxAI/MiniMax-H3-Image](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image)

Getestet mit einem Entwicklungs-Build von Unsloth (neuer als 2026.11.4) auf NVIDIA A100 (40 GB) und RTX PRO 6000 (96 GB).
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FN17t739HDhs4Bs9VVAEL%2Fminimax-h3-image-out-bookshop.webp?alt=media" alt="Rainy bookshop window with an UNSLOTH BOOKS chalkboard and a sleeping cat"><figcaption><p>FP8-Repository (INT8), 2048 × 2048, etwa 5 s auf einer A100</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

<div><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FdhaLehHOWudDk9TmHJfW%2Fminimax-h3-image-out-valley.webp?alt=media" alt="Misty autumn valley with a wooden footbridge"><figcaption><p>FP8-Repository (INT8)</p></figcaption></figure> <figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FE5iZZZi5oMaVw4Jo3ViS%2Fminimax-h3-image-out-island.webp?alt=media" alt="Isometric floating island city"><figcaption><p>FP8-Repository (INT8)</p></figcaption></figure> <figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FQ8V3wLPL9YacqR4YD5LK%2Fminimax-h3-image-out-ramen.webp?alt=media" alt="Overhead photo of ramen"><figcaption><p>GGUF UD-Q4_K_XL</p></figcaption></figure></div>

### Speicheranforderungen <a href="#memory-requirements" id="memory-requirements"></a>

Mit einem 32B-Qwen3-VL-Textencoder (aus MiniMax-H3) wird eine leistungsstarke GPU oder reichlich Arbeitsspeicher benötigt.

| Konfiguration                         | Bildmodell              | Textencoder                    | VAE    | Gesamter Download |
| ------------------------------------- | ----------------------- | ------------------------------ | ------ | ----------------- |
| **FP8-Repository** (Unsloth-Standard) | INT8-ConvRot, 20,3 GB   | INT8 Qwen3-VL 32B, 27,1 GB     | 2,3 GB | **etwa 50 GB**    |
| **GGUF UD-Q4\_K\_XL**                 | 13,6 GB                 | Q4\_K\_M Qwen3-VL 32B, 18,2 GB | 2,3 GB | **etwa 34 GB**    |
| **GGUF Q8\_0**                        | 22,0 GB                 | Q4\_K\_M Qwen3-VL 32B, 18,2 GB | 2,3 GB | **etwa 43 GB**    |
| Prompt-Verbesserer (optional)         | Qwen3.5-9B UD-Q4\_K\_XL |                                |        | **6,9 GB**        |

| Ihre Hardware                              | Beginnen Sie mit                                                                                            |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| **NVIDIA-GPU mit mindestens 80 GB**        | FP8-Repository, vollständig auf der GPU. Getestet mit einer RTX PRO 6000 mit 96 GB: Spitzenverbrauch 54 GB. |
| **NVIDIA-GPU mit 40 GB**                   | FP8-Repository. Getestet mit einer A100 mit 40 GB und 83 GB RAM: Teile werden aus dem RAM gestreamt.        |
| **NVIDIA-GPU mit 24 GB**                   | GGUF **UD-Q4\_K\_XL**, oder das FP8-Repository mit mindestens 48 GB Systemspeicher                          |
| **GPU mit 16 GB**                          | GGUF **UD-Q4\_K\_XL** oder kleiner, mit mindestens 48 GB Systemspeicher                                     |
| **Mac oder nur CPU, mindestens 64 GB RAM** | GGUF **UD-Q4\_K\_XL** (langsam)                                                                             |

Nur die Zeilen für 96 GB und 40 GB wurden getestet; die übrigen Angaben sind Schätzungen. Bei 24 GB ist UD-Q4\_K\_XL schneller als Q8\_0 (das auf den RAM ausweicht). Auf Macs und CPUs ist nur GGUF verfügbar.

#### FP8, INT8 und GGUF <a href="#fp8-int8-and-gguf" id="fp8-int8-and-gguf"></a>

Das FP8-Repository enthält zwei Dateien mit jeweils 20,3 GB: INT8-ConvRot und FP8. **Unsloth lädt standardmäßig INT8-ConvRot** (mit dem INT8-Textencoder), da es näher an bf16 liegt (LPIPS 0,140 gegenüber 0,255 bei FP8 mit 2048 × 2048). Der Auswahlbildschirm bezeichnet es weiterhin als **Schnelles FP8**. Auf einer GPU mit ausreichend Speicher ist es etwa dreimal schneller als GGUF.

GGUF-Quantisierungen: **Q8\_0** 22,03 GB (am nächsten an bf16), **UD-Q6\_K\_XL** 17,58 GB, **UD-Q4\_K\_XL** 13,61 GB (**empfohlen**), **UD-Q2\_K\_XL** 8,68 GB (knapper Speicher).

#### Hardwarehinweise <a href="#hardware-notes" id="hardware-notes"></a>

Hierfür ist Unsloth 2026.11.5 oder neuer erforderlich.

* **T4 und andere GPUs ohne bf16:** Das FP8-Repository (INT8-Bildmodell und Textencoder) rendert und bearbeitet mit fp16. Getestet auf einer Colab T4 mit 15 GB und 51 GB RAM: Die Blöcke werden aus dem Systemspeicher gestreamt (etwa 43 bis 47 GB belegt), bei einem GPU-Speicherbedarf von bis zu etwa 14 GB.

  | Aufgabe, 6 Schritte           | Zeit pro Bild  |
  | ----------------------------- | -------------- |
  | Text zu Bild, 1024 x 1024     | etwa 28 s      |
  | Text zu Bild, 2048 x 2048     | etwa 83 s      |
  | Bearbeitung, 1 Referenz, 1024 | 2,5 bis 3 Min. |

  LoRAs werden geladen und gerendert, aber beim Laden wird das vollständige 66-GB-Modell gestreamt (auf der T4 etwa 12 Min.). **Sequentielle** Platzierung benötigt etwa 52,4 GB freien Systemspeicher; bei weniger verweigert Unsloth den Vorgang und zeigt beide Werte an.
* **AMD unter Linux** (Radeon 8060S, gfx1151): LoRA-Training mit **bf16** Basismodell, erneutes Laden, Rendering mit der LoRA und Export funktionieren alle.

### Schnellstart <a href="#quickstart" id="quickstart"></a>

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FUySaKhMrEM4BEdibJvbp%2Fminimax-h3-image-flow.webp?alt=media" alt="Animation: pick MiniMax-H3-Image (Fast FP8), type a prompt, click Generate and get an alpine valley at sunrise" width="375"><figcaption><p>Der Unsloth-Workflow, beschleunigt</p></figcaption></figure>

{% stepper %}
{% step %}

#### Unsloth installieren <a href="#install-unsloth" id="install-unsloth"></a>

Hol dir die [Unsloth-Desktop-App](https://unsloth.ai/docs/de/desktop.md) für [macOS](https://unsloth.ai/docs/de/loslegen/install/mac.md), [Windows](https://unsloth.ai/docs/de/loslegen/install/windows-installation.md) oder [Linux](https://unsloth.ai/docs/de/loslegen/install/linux.md).

<a href="https://unsloth.ai/download" class="button primary" data-icon="down-to-bracket">Unsloth herunterladen</a>

Oder über das Terminal. macOS, Linux, WSL:

{% code collapsedlinecount="10" %}

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

{% endcode %}

Windows PowerShell:

{% code collapsedlinecount="10" %}

```powershell
irm https://unsloth.ai/install.ps1 | iex
```

{% endcode %}

Starte anschließend Unsloth und öffne `http://localhost:8888`:

{% code collapsedlinecount="10" %}

```bash
unsloth studio -H 0.0.0.0 -p 8888
```

{% endcode %}
{% endstep %}

{% step %}

#### Bilder öffnen <a href="#open-images" id="open-images"></a>

Wähle **Bilder** in der Seitenleiste aus. **Erstellen** wird standardmäßig geöffnet.

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FlQtHN8moCQiBVRksvUtk%2Fminimax-h3-image-images-page.png?alt=media" alt="The Unsloth Images page with the Create workflow open and no model loaded"><figcaption><p>Die Seite „Bilder“</p></figcaption></figure>
{% endstep %}

{% step %}

#### MiniMax-H3-Image auswählen <a href="#pick-minimax-h3-image" id="pick-minimax-h3-image"></a>

Klicke auf **Bildmodell auswählen**, suche nach `MiniMax-H3-Image` und wähle:

* **MiniMax-H3-Image (Fast FP8)**: das FP8-Repository. Für NVIDIA-GPUs mit mindestens 24 GB.
* **MiniMax-H3-Image-GGUF (Slow)**: Wähle eine Quantisierung. **UD-Q4\_K\_XL** wird empfohlen.

<div><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FHhCLEoV6z1L4Db8ily2v%2Fminimax-h3-image-picker-search.png?alt=media" alt="Model picker search results for MiniMax-H3-Image with the Fast FP8 and GGUF entries"><figcaption><p>Suchergebnisse</p></figcaption></figure> <figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F3ZuWCPvHggmFB2WbdphS%2Fminimax-h3-image-gguf-quants.png?alt=media" alt="The GGUF entry expanded to show its quants, with UD-Q4_K_XL marked recommended"><figcaption><p>GGUF-Quantisierungen</p></figcaption></figure></div>

Beim ersten Laden werden das Modell, der Text-Encoder und der VAE heruntergeladen.

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FqfYd6Ju8MCpA2vWphkeV%2Fminimax-h3-image-download.png?alt=media" alt="Download panel with the 27 GB INT8 text encoder" width="400"><figcaption><p>Erster Download des FP8-Repositorys</p></figcaption></figure>
{% endstep %}

{% step %}

#### Schreibe deinen Prompt <a href="#write-your-prompt" id="write-your-prompt"></a>

Beschreibe das gesamte Bild. Unsloth legt **6 Schritte** fest (gesperrt: Das Modell wurde exakt für 6 Schritte destilliert), **Guidance 1** und **2048 × 2048**.

**Prompt verbessern** (standardmäßig aktiviert, MiniMax-Referenzworkflow) lässt ein Qwen3.5-9B-Modell deinen Prompt umformulieren. Es ist ein separater **6,9 GB** Download und langsam: etwa **3,5 Minuten** zusätzlich pro Bild auf einer A100. Deaktiviere die Funktion für schnelle Tests.

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FBJhHYOSYImp8McKcvGjM%2Fminimax-h3-image-enhancer.png?alt=media" alt="Enhance prompt switch with its 6.9 GB download button" width="350"><figcaption><p>Prompt vor dem Download verbessern</p></figcaption></figure>
{% endstep %}

{% step %}

#### Generieren <a href="#generate" id="generate"></a>

Klicke auf **Generieren**. **Rezept** zeigt alle Einstellungen, die Präzision und den verbesserten Prompt.

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fmqa9vZ88KIaOFN27Gl5n%2Fminimax-h3-image-result-lossless.webp?alt=media" alt="Ginger cat asleep on books in a rainy bookshop window"><figcaption><p>FP8-Repository (INT8), kurzer Prompt, Prompt-Optimierung aktiviert, Seed 42</p></figcaption></figure>

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FwwUefNK5OGmbIuwl2tfE%2Fminimax-h3-image-recipe-lossless.webp?alt=media" alt="Recipe card with the enhanced prompt, INT8 precision, 6 steps and seed 42"><figcaption><p>Rezeptkarte</p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Bildbearbeitung <a href="#image-editing" id="image-editing"></a>

Wähle **Bearbeiten**, lade **Bild 1**hoch und **Bild hinzufügen** für weitere Bilder (bis zu 16). Benenne sie als `<Picture 1>`, `<Picture 2>` und gib an, was beibehalten und geändert werden soll. Die Ausgabe übernimmt das Seitenverhältnis von Bild 1 auf der 2048er-Leinwand; für diese Beispiele wird **Ausgabegröße** **Benutzerdefiniert** `1024 × 1024`verwendet, Seed 7, Prompt-Optimierung deaktiviert: jeweils 3 bis 4 s auf einer RTX PRO 6000 (FP8-Repository). Mit aktivierter Prompt-Optimierung dauerte eine Bearbeitung auf einer A100 etwa 9 Minuten.

{% hint style="info" %}
Bearbeite ein Bild nicht mit demselben Seed und derselben Größe, mit denen es generiert wurde. Die Bearbeitung verwendet dann das Rauschen des Bildes selbst als Ausgangspunkt und das Ergebnis ist übermäßig scharf; die Anweisung wird ignoriert. Ändere den Seed (oder lass ihn zufällig wählen).
{% endhint %}

**Ein Bild:** "Bearbeite \<Picture 1>. Verwandle die Szene in einen verschneiten Wintermorgen. Lass die Brücke, den Fluss und die Berge unverändert."

<div><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FdYqwblQlu0tXyHWZR02d%2Fminimax-h3-image-edit1.png?alt=media" alt="Edit with the autumn valley as Picture 1 and the snowy result"><figcaption><p>Ein Bild</p></figcaption></figure> <figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FCG9GfRXXtmBhCMLt7ko6%2Fminimax-h3-image-edit-winter.webp?alt=media" alt="The same valley, bridge and river on a snowy winter morning"><figcaption><p>Ergebnis</p></figcaption></figure></div>

**Zwei Bilder:** "Setze den Heißluftballon aus \<Picture 2> in den Himmel über dem Tal in \<Picture 1>. Lass die Brücke, die Bäume, den Fluss und die Beleuchtung unverändert."

<div><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FJ0iVCIJ1aDg9ibKSM9nY%2Fminimax-h3-image-edit2.png?alt=media" alt="Edit with the valley and a balloon as Pictures 1 and 2"><figcaption><p>Zwei Bilder</p></figcaption></figure> <figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FnyY7SUigpABhfJK6q40y%2Fminimax-h3-image-edit-balloon.webp?alt=media" alt="The valley from Picture 1 with the hot-air balloon from Picture 2 in the sky"><figcaption><p>Ergebnis</p></figcaption></figure></div>

### Eine LoRA trainieren <a href="#train-a-lora" id="train-a-lora"></a>

Siehe [MiniMax-H3-Image feinabstimmen](https://unsloth.ai/docs/de/modelle/minimax-h3-image/fine-tune-minimax-h3-image.md)

#### Vorher und nachher <a href="#before-and-after" id="before-and-after"></a>

Seed 42, 1024 × 1024, Prompt-Optimierung deaktiviert: `a trtcrd of a cat sitting on a throne holding a golden cup, "queen of cats"` und `a trtcrd of an astronaut standing on the moon holding a lantern, "the explorer"`.

<div><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fkg53StPeOhBWosYeBEkn%2Fminimax-h3-image-lora-cat-before.webp?alt=media" alt="Without the LoRA: photo-like cat on a throne"><figcaption><p>Ohne LoRA</p></figcaption></figure> <figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F5idj4QIy1DMxo4QWxs88%2Fminimax-h3-image-lora-cat-w06.webp?alt=media" alt="LoRA weight 0.6: illustrated cat"><figcaption><p>Gewicht 0,6</p></figcaption></figure> <figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FoD4Irr8nLFeWdVOvHUMT%2Fminimax-h3-image-lora-cat-after.webp?alt=media" alt="LoRA weight 1.0: tarot card style cat"><figcaption><p>Gewicht 1,0</p></figcaption></figure></div>

<div><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FjEaC0aZLy24V1JEzLzdH%2Fminimax-h3-image-lora-astronaut-before.webp?alt=media" alt="Without the LoRA: astronaut photo"><figcaption><p>Ohne LoRA</p></figcaption></figure> <figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F7KTnboVty4ipiJY5X4OH%2Fminimax-h3-image-lora-astronaut-after.webp?alt=media" alt="LoRA weight 1.0: tarot card style astronaut"><figcaption><p>Gewicht 1,0</p></figcaption></figure></div>

* Gewicht **1.0** gibt den Stil vollständig wieder; **0,6 bis 0,8** wirkt dezenter.
* Die LoRA verändert Prompts auch ohne das Triggerwort leicht. Verringere das Gewicht oder lade sie für andere Aufgaben nicht mit.
* Der Stil ist bei 1024 × 1024 (der Trainingsgröße) am stärksten und bei 2048 × 2048 schwächer.

[Weiter im Leitfaden zur Feinabstimmung](https://unsloth.ai/docs/de/modelle/minimax-h3-image/fine-tune-minimax-h3-image.md#before-and-after)

### Aus Code ausführen <a href="#run-from-code" id="run-from-code"></a>

#### Unsloth API <a href="#unsloth-api" id="unsloth-api"></a>

Lade das Modell auf der Seite „Bilder“ und rufe dann den OpenAI-kompatiblen `POST /v1/images/generations` Endpunkt auf (um stattdessen über `model` zu laden, aktiviere **Bild- und Videomodell je nach Anfrage wechseln** unter **Einstellungen → API**). Erstelle dort einen API-Schlüssel ([Unsloth API](https://unsloth.ai/docs/de/grundlagen/api.md)); in den Beispielen wird `UNSLOTH_API_KEY`.

Mit `openai` (`pip install openai`):

{% code collapsedlinecount="10" %}

```python
import base64
import os

from openai import OpenAI

client = OpenAI(base_url="http://localhost:8888/v1", api_key=os.environ["UNSLOTH_API_KEY"])

result = client.images.generate(
    model="unsloth/MiniMax-H3-Image-FP8",
    prompt="A misty mountain valley at sunrise with a wooden footbridge over a calm river, autumn trees in red, orange and gold on both banks, and soft golden light breaking through the mist. Detailed landscape photograph.",
    size="2048x2048",
    response_format="b64_json",
    extra_body={"steps": 6, "guidance": 1.0, "seed": 42},
)

with open("valley.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))
```

{% endcode %}

Mit `curl`:

{% code collapsedlinecount="10" %}

```bash
curl -s http://localhost:8888/v1/images/generations \
  -H "Authorization: Bearer $UNSLOTH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "unsloth/MiniMax-H3-Image-FP8",
    "prompt": "Isometric 3D illustration of a tiny floating island city with pastel houses and terracotta roofs, a waterfall pouring off the edge into soft clouds, and small hot-air balloons drifting around it. Clean lines, soft shadows, calm pastel palette.",
    "size": "2048x2048",
    "response_format": "b64_json",
    "seed": 7
  }' \
  | python3 -c "import sys, json, base64; open('island.png', 'wb').write(base64.b64decode(json.load(sys.stdin)['data'][0]['b64_json']))"
```

{% endcode %}

`size` ist `WIDTHxHEIGHT` in Vielfachen von 16; `steps` und `guidance` standardmäßig auf 6 und 1. Die API führt den Enhancer nicht aus. Etwa 3 s pro Bild auf einer RTX PRO 6000, 5 s auf einer A100.

**LoRAs über die API** (Unsloth 2026.11.5 oder neuer): Anfragen verwenden die beim Laden eingebundene LoRA, zum Beispiel nach **Mit Create bereitstellen**. Eine Anfrage mit einer anderen `loras` Liste wird abgelehnt; laden Sie sie neu, um sie zu ändern.

#### GGUF mit stable-diffusion.cpp <a href="#gguf-with-stable-diffusion.cpp" id="gguf-with-stable-diffusion.cpp"></a>

Führen Sie die GGUF-Datei mit `sd-cli` aus [stable-diffusion.cpp](https://github.com/unslothai/stable-diffusion.cpp) (Unsloths festgelegtem Release).

**1. Laden Sie `sd-cli`** herunter (Linux, CUDA 13). Auf der [Release-Seite](https://github.com/unslothai/stable-diffusion.cpp/releases/tag/master-982-0518b34-u27b9ddc) gibt es auch Builds für CUDA 12, Vulkan, CPU, macOS und Windows.

{% code collapsedlinecount="10" %}

```bash
curl -L -o sd.zip https://github.com/unslothai/stable-diffusion.cpp/releases/download/master-982-0518b34-u27b9ddc/sd-master-982-0518b34-u27b9ddc-bin-Linux-Ubuntu-22.04-x86_64-cuda13.zip
unzip -o sd.zip
mv sd-master-982-0518b34-u27b9ddc-bin-Linux-Ubuntu-22.04-x86_64-cuda13 sd
./sd/sd-cli --version
```

{% endcode %}

**2. Laden Sie das Modell, den Text-Encoder und den VAE herunter** (etwa 34 GB):

{% code collapsedlinecount="10" %}

```bash
pip install -U huggingface_hub
hf download unsloth/MiniMax-H3-Image-GGUF minimax_h3_image_pruned-UD-Q4_K_XL.gguf --local-dir models
hf download unsloth/MiniMax-H3-GGUF qwen3vl_32b_minimax_h3-Q4_K_M.gguf --local-dir models
hf download MiniMaxAI/MiniMax-H3-Image vae/diffusion_pytorch_model.safetensors --local-dir models
```

{% endcode %}

**3. Erstellen Sie ein Bild.** `--offload-to-cpu` hält die Gewichte im RAM und verschiebt jeden Teil bei Bedarf auf die GPU (maximal 19,4 GB VRAM, 39 GB RAM).

{% code collapsedlinecount="10" %}

```bash
./sd/sd-cli \
  --diffusion-model models/minimax_h3_image_pruned-UD-Q4_K_XL.gguf \
  --llm models/qwen3vl_32b_minimax_h3-Q4_K_M.gguf \
  --vae models/vae/diffusion_pytorch_model.safetensors \
  -p "A misty mountain valley at sunrise with a wooden footbridge over a calm river, autumn trees in red, orange and gold on both banks, and soft golden light breaking through the mist. Detailed landscape photograph." \
  --steps 6 --cfg-scale 1.0 --sampling-method euler --sigmas minimax-h3-image --rng cpu \
  --offload-to-cpu \
  -W 2048 -H 2048 --seed 42 \
  -o valley-sdcpp.png
```

{% endcode %}

103 s auf einer 40-GB-A100, 12 s auf einer RTX PRO 6000.

**4. Bearbeiten Sie ein Bild.** Jedes `-r` ist das nächste `<Picture N>`; `sd-cli` schneidet sie auf `-W` × `-H`, also an die Form von Bild 1 anpassen. Keine Vision-Datei erforderlich. 16 s und 20 s auf einer RTX PRO 6000.

{% code collapsedlinecount="10" %}

```bash
./sd/sd-cli \
  --diffusion-model models/minimax_h3_image_pruned-UD-Q4_K_XL.gguf \
  --llm models/qwen3vl_32b_minimax_h3-Q4_K_M.gguf \
  --vae models/vae/diffusion_pytorch_model.safetensors \
  -r valley-sdcpp.png \
  -p "Bearbeite <Picture 1>. Verwandle die Szene in einen verschneiten Wintermorgen. Behalte die Brücke, den Fluss und die Berge bei." \
  --steps 6 --cfg-scale 1.0 --sampling-method euler --sigmas minimax-h3-image --rng cpu \
  --offload-to-cpu \
  -W 1024 -H 1024 --seed 42 \
  -o valley-sdcpp-winter.png
```

{% endcode %}

Zwei Bilder (`balloon.png` ist ein Ballonfoto):

{% code collapsedlinecount="10" %}

```bash
./sd/sd-cli \
  --diffusion-model models/minimax_h3_image_pruned-UD-Q4_K_XL.gguf \
  --llm models/qwen3vl_32b_minimax_h3-Q4_K_M.gguf \
  --vae models/vae/diffusion_pytorch_model.safetensors \
  -r valley-sdcpp.png -r balloon.png \
  -p "Füge den Heißluftballon aus <Picture 2> am Himmel über dem Tal in <Picture 1> ein. Behalte die Brücke, die Bäume, den Fluss und die Beleuchtung bei." \
  --steps 6 --cfg-scale 1.0 --sampling-method euler --sigmas minimax-h3-image --rng cpu \
  --offload-to-cpu \
  -W 1024 -H 1024 --seed 42 \
  -o valley-sdcpp-balloon.png
```

{% endcode %}

Auf einem Mac oder einer CPU verwende das GGUF in der App oder die `Darwin-macOS-arm64` -/CPU- `sd-cli` Builds; dafür wird RAM für das Bildmodell sowie den 18,2-GB-Textencoder benötigt (von uns nicht getestet).

### Empfohlene Einstellungen <a href="#recommended-settings" id="recommended-settings"></a>

| Einstellung            | Unsloth (FP8 oder GGUF)                                                        | stable-diffusion.cpp                                          |
| ---------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------- |
| **Schritte**           | **6** (fest eingestellt)                                                       | `--steps 6`                                                   |
| **Guidance / CFG**     | **1**                                                                          | `--cfg-scale 1.0`                                             |
| **Sampler / Zeitplan** | Wird von Unsloth festgelegt                                                    | `--sampling-method euler --sigmas minimax-h3-image --rng cpu` |
| **Negativer Prompt**   | Leer lassen                                                                    | Leer lassen                                                   |
| **Größe**              | `2048×2048` als Ausgangspunkt (die Liste der **Modellgrößen** enthält weitere) | `-W 2048 -H 2048`                                             |
| **Seed**               | Eine beliebige Zahl, um ein Ergebnis zu wiederholen                            | `--seed 42`                                                   |

Die besten Ergebnisse erzielt man mit etwa 4 MP und mehr. **Modellgrößen** Die Liste `2368×1760` (4:3) und `2720×1536` (16:9) sowie Größen mit 16 MP wie `4096×4096` (etwa viermal so viel Speicher und Zeit).

### Fehlerbehebung <a href="#troubleshooting" id="troubleshooting"></a>

<details>

<summary>MiniMax-H3-Image wird nicht in der Modellauswahl angezeigt</summary>

[Unsloth aktualisieren](https://unsloth.ai/docs/get-started/install/updating) und neu starten. Wenn ein Modell geladen ist, wird die Modellauswahl mit **Auf dem Gerät**geöffnet: Klicke auf **Empfohlen**. Auf Macs und CPUs wird nur das GGUF-Modell angezeigt.

</details>

<details>

<summary>Die Generierung dauert mehrere Minuten</summary>

Deaktiviere **Prompt verbessern**  . Das GGUF-Modell ist auf NVIDIA außerdem etwa dreimal langsamer als das FP8-Repository.

</details>

<details>

<summary>Die API ignoriert das angeforderte Modell</summary>

Lade MiniMax-H3-Image auf der Seite „Bilder“, oder aktiviere **Bild- und Videomodell je nach Anfrage wechseln** unter **Einstellungen → API**.

</details>

<details>

<summary>sd-cli meldet, dass libcudart.so.12 oder libcudart.so.13 fehlt</summary>

Verwende die `cuda13` ZIP-Datei mit CUDA 13, `cuda12` mit CUDA 12 oder den Vulkan-Build.

</details>

Siehe auch [Bilddiffusionsmodelle lokal ausführen](https://unsloth.ai/docs/de/grundlagen/diffusion-image.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://unsloth.ai/docs/de/modelle/minimax-h3-image.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
