Was ist MiniMax H3-Image?

MiniMax H3-Image ist ein Open-Weight-Bildmodell von MiniMax, das am 10. November 2026 veröffentlicht wurde und Bilder mit etwa 16 Megapixeln (4096 x 4096) generiert und bearbeitet – ganz ohne Upscaler. Laut MiniMax dauert ein 4K-Bild etwa 10 Sekunden. Sie können es über die MiniMax-API aufrufen, in Hailuo AI und MiniMax Code verwenden oder die Gewichte von Hugging Face herunterladen.

Dieser Leitfaden erklärt, was MiniMax H3-Image ist, was MiniMax tatsächlich verspricht, was „Open-Weight" unter der Lizenz bedeutet, was es während des Launch-Wochen-Rabatts kostet und wie Sie die API über Ihren Coding-Agenten testen.

Was ist MiniMax H3-Image?

MiniMax H3-Image ist ein Text-zu-Bild- und Bildbearbeitungsmodell aus der MiniMax-H3-Familie. Ein einzelner Checkpoint übernimmt beide Aufgaben: Er erzeugt Bilder aus einem Prompt und bearbeitet bis zu 16 Referenzbilder. Er liefert etwa 16 Megapixel in jedem Seitenverhältnis, von 4096 x 4096 (1:1) bis 6272 x 2688 (21:9), und seine Gewichte sind unter einer Community-Lizenz veröffentlicht.

In MiniMax’ Launch-Beitrag auf X heißt es kurz und knapp: „4K-Bilderzeugung in 10 Sekunden", 16 Millionen Pixel, Realismus, präzise Prompt-Befolgung und Bearbeitung, bis zu 16 Referenzbilder und offene Gewichte.

H3-Image ist unabhängig von MiniMax’ Coding-Modell, das im MiniMax-M3-Explainer behandelt wird, und verfügt über eigene API-Endpunkte.

Was MiniMax über H3-Image verspricht

Hier ist, was MiniMax auf der Hugging-Face-Modellkarte und in der Ankündigung veröffentlicht. Betrachten Sie die Angaben zu Geschwindigkeit und Qualität als Aussagen von MiniMax; zum Zeitpunkt der Erstellung dieses Artikels hatte niemand außerhalb des Unternehmens unabhängige Messungen veröffentlicht.

Aussage	Was MiniMax sagt	Quelle
Auflösung	Rund 16 MP, 4096 x 4096 bei 1:1, bis 6272 x 2688 bei 21:9, ohne Upscaler	Modellkarte
Geschwindigkeit	Ein 4K-Bild in etwa 10 Sekunden	Launch-Beitrag
Sampling	Destilliert auf 6 Sampling-Schritte, kein Classifier-Free Guidance	Modellkarte
Referenzen	Bis zu 16 Referenzbilder pro Bearbeitung	Modellkarte, API-Leitfaden
Instruktionsbefolgung	„Die stärkste Instruktionsbefolgung unter den Open-Source-Modellen"	Modellkarte
Arbeitsbereich	Rund 4 MP bis 20 MP, beste Ergebnisse bei etwa 16 MP	Modellkarte

Die Geschwindigkeitsangabe beruht auf 6 destillierten Schritten und dem Verzicht auf Classifier-Free Guidance, das den Arbeitsaufwand pro Schritt normalerweise verdoppelt. MiniMax nennt die Hardware hinter dem 10-Sekunden-Wert nicht, also verstehen Sie ihn nicht als Zusicherung für Ihre eigene GPU.

Die Modellkarte veröffentlicht keine Benchmark-Tabelle zur Aussage über die Instruktionsbefolgung. Unser Schwesterartikel MiniMax H3-Image vs. Nano Banana 2.1 stellt beide direkt gegenüber.

Was im Modell steckt

Die Modellkarte ist ungewöhnlich präzise bei der Architektur:

Diffusion-Transformer: 33,1B Parameter, ein dichter Single-Stream-Transformer mit 50 Schichten, gespeichert in BF16 (68,65 GB).
Text-Encoder: der MiniMax-H3-Text-Encoder, unverändert, geladen aus dem separaten MiniMax-H3-Repository (66,7 GB).
Image-VAE: 16x räumliche Downsampling und 24 latente Kanäle (2,34 GB).
Optionaler Prompt-Expander: MiniMax-H3-Image-PE (17,9 GB, NVFP4), der einen kurzen Prompt in die detaillierte englische Beschreibung umwandelt, die das Modell erwartet.

Zusammengezählt lädt ein vollständiges lokales Setup rund 137 GB herunter – vor dem optionalen Expander.

Was „Open-Weight" bei MiniMax H3-Image bedeutet

MiniMax H3-Image ist Open-Weight, nicht Open-Source im OSI-Sinne. Sie können die Gewichte herunterladen und ausführen, aber die MiniMax-H3-Image-Community-Lizenz setzt echte Grenzen. Lesen Sie sie, bevor Sie darauf aufbauen. Die Punkte, die die meisten Teams betreffen:

Territorium. Die Lizenz gewährt Rechte weltweit, außer in den „Excluded Territories": der Europäischen Union, dem Vereinigten Königreich, der Republik Korea und den USA. Teams dort müssen zwecks einer separaten Lizenz MiniMax kontaktieren.
Umsatz und Hosting. Sie benötigen eine vorherige schriftliche Genehmigung von MiniMax, wenn Sie und Ihre verbundenen Unternehmen mehr als 1 Million US-Dollar annualisierten Umsatz erzielen oder das Modell als gehosteten Dienst für Dritte anbieten. Anfragen laufen über MiniMax’ Lizenzkonsole.
Namensnennung. Kommerzielle Produkte müssen „MiniMax-H3-Image" prominently in der Benutzeroberfläche anzeigen.
Kein Training anderer Modelle. Sie dürfen das Modell oder seine Ausgaben nicht verwenden, um ein anderes KI-Modell zu verbessern.
Kennzeichnungspflicht. Die Richtlinie zur akzeptablen Nutzung verbietet die öffentliche Veröffentlichung generierter Inhalte, ohne klar anzugeben, dass es sich um maschinell erzeugte Inhalte handelt.

MiniMax erhebt keine Ansprüche an den Bildern, die Sie generieren. Wenn Sie nur die gehostete API aufrufen, lesen Sie auch MiniMax’ Plattformbedingungen für diese Nutzung.

Wo Sie MiniMax H3-Image verwenden können

Diagramm der vier Zugangswege zu MiniMax H3-Image: die MiniMax-API-Endpunkte, die Hailuo-AI-Webanwendung, die MiniMax-Code-Desktop-App und die offenen Gewichte auf Hugging Face für Self-Hosting

Sie haben vier Möglichkeiten:

MiniMax-API. Text-zu-Bild unter POST https://api.minimax.io/v1/images/generations und Bearbeitung unter /v1/images/edits, beide mit der Modell-ID MiniMax-H3-Image oder der schnelleren MiniMax-H3-Image-Highspeed. Die vollständige Anleitung finden Sie in unserem MiniMax-H3-Image-API-Leitfaden.
Hailuo AI. MiniMax’ Webanwendung, ganz ohne Code.
MiniMax Code. MiniMax’ Desktop-App für macOS und Windows, im Launch-Beitrag als Ort zur Nutzung von H3-Image genannt.
Self-Hosting. MiniMax empfiehlt SGLang, vLLM-Omni, diffusers oder ComfyUI und listet NVIDIA H200, RTX PRO 6000 Blackwell und AMD Instinct MI350X unter den unterstützten Beschleunigern auf. Die Modellkarte gibt keine Mindest-VRAM-Angabe.

Wenn Sie nach kostenlosen Zugangswegen suchen, behandelt der Beitrag MiniMax H3-Image kostenlos nutzen diese Optionen.

So funktioniert die MiniMax-H3-Image-API

Die API folgt dem OpenAI-Stil für Bilder, daher ist der Request kurz:

curl https://api.minimax.io/v1/images/generations \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3-Image",
    "prompt": "An orange cat on a sunny windowsill, film texture",
    "aspect_ratio": "16:9",
    "area": "4K",
    "response_format": "url"
  }'

Die wichtigsten Parameter, laut API-Referenz:

size akzeptiert WIDTHxHEIGHT (655.360 bis 20.000.000 Pixel, Seitenverhältnis zwischen 1:3 und 3:1) oder auto. Bei auto legen Sie stattdessen aspect_ratio und area fest (1K, 2K oder 4K, Standard 4K). Die Mischung beider Formen liefert einen 400-Fehler.
n fordert 1 bis 10 Bilder pro Request an.
output_format ist standardmäßig jpeg, alternativ png oder webp.
response_format ist url (Laden Sie das Bild selbst herunter, da die URL nicht garantiert dauerhaft verfügbar ist) oder b64_json.
stream: true übermittelt jedes Bild per Server-Sent Events, sobald es fertig ist.
Prompt-Verstärkung ist standardmäßig aktiviert. Jedes Ergebnis enthält einen revised_prompt, der zeigt, was das Modell tatsächlich verwendet hat. Setzen Sie disable_prompt_enhanced: true, um Ihren Prompt unverändert zu senden.

Ein Verhalten sorgte für Verwirrung: Wenn mindestens ein Bild erfolgreich ist, gibt der Aufruf HTTP 200 zurück, selbst wenn andere die Inhalts-Sicherheitsprüfung nicht bestanden haben. Prüfen Sie bei jedem Element data[].error. Abgerechnet werden nur erfolgreiche Bilder.

Der Leitfaden listet auch auf, was nicht unterstützt wird: Vorschaubilder, maskierte Bearbeitungen und transparente Hintergründe.

Für die Bearbeitung übergeben Sie 1 bis 16 Referenzbilder als öffentliche URLs, hochgeladene Datei-IDs oder Data-URIs, mit insgesamt bis zu 64 MiB pro Request. Ihr Prompt verweist auf sie als <Picture 1>, <Picture 2> usw., in Upload-Reihenfolge.

MiniMax-H3-Image-Preise und der Launch-Wochen-Rabatt

MiniMax rechnet H3-Image pro einer Million Tokens ab, aufgeteilt in Texteingabe, Bildeingabe und Bildausgabe. Laut der MiniMax-Preisseite, geprüft am 11. November 2026:

Modell	Text-Eingabe / M Tokens	Bild-Eingabe / M Tokens	Bild-Ausgabe / M Tokens
MiniMax-H3-Image	$2.30	$1.50	$3.80
MiniMax-H3-Image-Highspeed	$2.30	$3.00	$7.60

MiniMax’ eigene Beispielkosten pro Text-zu-Bild-Ergebnis beim Standardmodell betragen $0.02179 bei 1K, $0.02333 bei 2K und $0.06879 bei 4K. Das Highspeed-4K-Beispiel kostet $0.13001.

Der Launch-Rabatt beträgt 50 % auf die Gesamtkosten des Requests bei beiden Modellen, wenn das gelieferte Bild mindestens 16.600.000 Pixel hat. Er läuft bis zum 17. November 2026, 16:00 UTC. In diesem Zeitraum listet MiniMax ein Standard-4K-Text-zu-Bild-Ergebnis bei $0.03439 und ein Highspeed-Ergebnis bei $0.06501. Kleinere Bilder qualifizieren sich nicht, also kostet ein 2K-Render genauso viel wie vorher.

Testen Sie die MiniMax-H3-Image-API mit Apidog CLI

Bevor Sie H3-Image in eine App integrieren, stellen Sie sicher, dass Request-Struktur, Authentifizierung und Fehlerbehandlung funktionieren – auch der Fall „200 mit fehlgeschlagenem Element". Lassen Sie Ihren Coding-Agenten diesen Check mit der Apidog CLI erstellen und ausführen, statt Requests von Hand durchzuklicken.

Workflow-Diagramm: Ein Coding-Agent verwendet die Apidog CLI, um einen Endpunkt und einen Testfall zu erstellen, ruft POST /v1/images/generations auf MiniMax H3-Image auf, liest einen Testbericht mit Prüfung von Status 200, data[0].url und keinem data[].error, und korrigiert und führt dann erneut aus

Richten Sie die CLI einmal ein:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install

Das Skill vermittelt Ihrem Agenten (Claude Code, Codex, Cursor oder einem anderen) die Befehle der CLI. Dann geben Sie ihm einen einzigen Prompt:

In Apidog project <projectId>, add the MiniMax H3-Image endpoint
POST /v1/images/generations from https://platform.minimax.io/docs/api-reference/image-generation-h3-generations
with Bearer auth from {{MINIMAX_API_KEY}}. Create an environment with base URL
https://api.minimax.io. Write a test case that sends model MiniMax-H3-Image,
area 1K, n 1, and asserts status 200, data[0].url exists, data[0].error is absent
and usage.generated_images equals 1. Run it and summarize the result.

Der Agent setzt das in eine kurze Folge von apidog-Befehlen um. Alle unten gezeigten Flags stammen aus apidog <command> --help der Apidog CLI 2.2.12:

apidog environment create --project <projectId> --base-url https://api.minimax.io
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file ./h3-endpoint.json
apidog endpoint create --project <projectId> --file ./h3-endpoint.json
apidog test-case category --project <projectId>
apidog cli-schema validate test-case-create --file ./h3-case.json
apidog test-case create --project <projectId> --file ./h3-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
  --env-var "MINIMAX_API_KEY=$MINIMAX_API_KEY" -r cli,json

cli-schema get übergibt dem Agenten die exakte JSON-Struktur, und cli-schema validate prüft jede Datei, bevor etwas geschrieben wird. test-case category liefert eine gültige Kategorie-ID, damit der Testfall in der App erscheint. Der Lauf gibt eine Bestehen-/Fehlschlag-Zusammenfassung in Ihrem Terminal aus und schreibt einen JSON-Bericht, den der Agent ausliest, um zu entscheiden, was zu korrigieren ist. Fügen Sie --upload-report hinzu, um denselben Lauf in Apidog anzuzeigen.

Mit area: 1K bleibt jeder Testaufruf beim niedrigsten gelisteten Beispielpreis von MiniMax. Mehr zu diesem Muster finden Sie im Apidog-CLI-Agenten-Workflow und unter Apidog CLI in Claude Code. Apidogs kostenloser Plan umfasst bis zu 4 Nutzer.

Sollten Sie MiniMax H3-Image ausprobieren?

Probieren Sie es aus, wenn Sie große, detaillierte Bilder benötigen und eine Open-Weight-Option wollen, oder wenn Multi-Referenz-Bearbeitung (Produktfotos, Raumaufteilungen, Character Sheets) Ihr Anwendungsfall ist. Der Launch-Rabatt macht 4K-Tests bis zum 17. November günstig.

Überlegen Sie beim Self-Hosting zweimal: rund 137 GB an Gewichten, Datacenter-GPUs und eine Lizenz, die die EU, das Vereinigte Königreich, die Republik Korea und die USA ausschließt. Für die meisten Teams ist die API der praktikable Weg. Wenn Sie Bild-APIs vergleichen, behandeln unsere Leitfäden zur GPT-Image-2.6-API, zur Nano-Banana-2.1-API und zu Qwen-Image 2.1 die Alternativen.

FAQ

Ist MiniMax H3-Image kostenlos? Die Gewichte dürfen innerhalb des Lizenzgebiets, unter den Umsatz- und Hosting-Grenzen, lizenzgebührenfrei heruntergeladen und ausgeführt werden. Die API ist kostenpflichtig pro Token. Sehen Sie sich unseren Leitfaden zum kostenlosen Zugang für kostenlose Wege an.

Ist MiniMax H3-Image Open-Source? MiniMax bezeichnet es auf Hugging Face als Open-Source, aber es wird unter einer benutzerdefinierten Community-Lizenz mit Einschränkungen zu Territorium, Umsatz, Namensnennung und Trainingsverbot ausgeliefert. „Open-Weight" ist der genauere Begriff.

Wie schnell ist MiniMax H3-Image? MiniMax sagt, ein 4K-Bild dauere etwa 10 Sekunden. Das ist die Angabe des Unternehmens; es nennt die Hardware nicht, und zum Zeitpunkt der Erstellung dieses Artikels gab es keinen unabhängigen Benchmark.

Was ist der Unterschied zwischen MiniMax-H3-Image und MiniMax-H3-Image-Highspeed? Beide akzeptieren dieselben Parameter und Grenzen. Highspeed ist die schnellere Stufe und kostet mehr: $7.60 pro Million Bild-Ausgabe-Tokens gegenüber $3.80.

Wie viele Referenzbilder kann MiniMax H3-Image verwenden? Bis zu 16 pro Bearbeitungs-Request, jeweils 128 bis 8.192 Pixel pro Seite, mit einer Obergrenze von 64 MiB für den gesamten Request-Body.

Wann endet der MiniMax-H3-Image-Launch-Rabatt? Am 17. November 2026, um 16:00 UTC. Er gilt nur für Bilder mit mindestens 16.600.000 Pixeln.