MiniMax
MiniMax H3 Image
minimax-h3-image/text-to-image
MiniMax-Bildmodell: Text-zu-Bild und Bearbeitung mit 1–16 Referenzbildern in einer gemeinsamen Funktion, Ausgabe bis 4K, Unterstützung von zehn Bildformaten und automatischem Seitenverhältnis, geeignet für Konzeptdesign, kommerzielle Visualisierung und Kreation in verschiedenen Stilen
minimax-h3-image/text-to-image ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
imagePreise
minimax-h3-image/text-to-image per image
| Spezifikationen | Einzelpreis |
|---|---|
| 1K | $0.0129 |
| 2K | $0.0129 |
| 4K | $0.0393 |
Positionierung und Kurzprofil
Dies ist ein Modell, das aus einer Textbeschreibung ein statisches Bild erzeugt. Sie geben lediglich einen Prompt ein und erhalten ein Bild, das der Beschreibung entspricht; dabei lassen sich die Auflösungsstufe, das Seitenverhältnis und das Ausgabeformat steuern. Bei Bedarf können Sie über einen festen Zufalls-Seed die Ergebnisse bei gleichem Prompt und gleichen Einstellungen reproduzierbar machen. Das Modell richtet sich an Designer, Content-Creator und Entwickler, die kreative Ideen schnell umsetzen möchten, und eignet sich für Konzeptbilder, Stimmungsbilder von Szenen sowie vielfältige visuelle Assets.
Wesentliche Highlights
- Automatische Prompt-Erweiterung – Der eingegebene Prompt wird automatisch erweitert und mit mehr Details angereichert, was zu einer reicheren Bildwirkung beiträgt.
- Mehrere Auflösungsstufen wählbar – Die Ausgabeauflösung kann unter 1K, 2K und 4K gewählt werden, entsprechend etwa 1, 4 und 16 Megapixeln.
- Unterstützung mehrerer Seitenverhältnisse – Integriert sind zahlreiche Verhältnisse von 1:1 bis 21:9, zusätzlich ist eine automatische Auswahl möglich, passend zu unterschiedlichen Layout-Anforderungen.
- Reproduzierbar durch festen Seed – Mit einem ganzzahligen Seed zwischen 0 und 2147483647 lassen sich Ergebnisse bei gleichem Prompt und gleichen Parametern reproduzieren.
Funktionsbeschreibung
Text zu Bild: Sie geben einen Prompt ein, der das Bild beschreibt, und das Modell erzeugt daraus ein statisches Bild. Der Prompt muss mindestens 1 Zeichen und darf höchstens 5000 Zeichen lang sein.
Steuerung der Auflösungsstufe: Die Ausgabeauflösung kann unter 1K, 2K und 4K gewählt werden, entsprechend etwa 1, 4 und 16 Megapixeln; standardmäßig wird 2K verwendet.
Steuerung des Seitenverhältnisses: Unterstützt werden 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9 sowie ein automatisches Verhältnis; standardmäßig 1:1.
Auswahl des Ausgabeformats: Ausgabe als JPEG oder PNG möglich; PNG-Dateien sind größer, etwa 12 MB bei 2K und etwa 30 MB bei 4K.
Fester Zufalls-Seed: Ein ganzzahliger Seed von 0 bis 2147483647 ermöglicht die Reproduktion von Ergebnissen bei gleichem Prompt und gleichen Parametern; ohne Angabe wird zufällig generiert.
Anwendungsfälle
- Concept-Designer entwerfen Charaktere und Szenen – Aus einer Textbeschreibung von Charakteren oder Szenen werden stilisierte Konzeptbilder für frühe Präsentationen und die visuelle Entwicklung erzeugt.
- Content-Creator erstellen Illustrationen – Passend zum Thema eines Artikels oder Videos werden Prompts formuliert und layoutgerechte Bilder generiert, die direkt für die Veröffentlichung genutzt werden können.
- Erstellung kommerzieller visueller Assets – Durch Wahl der 4K-Stufe und eines breiten Seitenverhältnisses entstehen hochauflösende Assets für Werbung oder Präsentationsmaterial.
- Entwickler generieren Bilder im Batch – Über feste Seeds und Parametersätze werden reproduzierbare Bild-Assets in großen Mengen erzeugt und in Design- oder Content-Pipelines integriert.
Einschränkungen und Auswahlhinweise
Der Prompt ist ein Pflichtfeld, darf höchstens 5000 Zeichen lang sein und nicht ausschließlich aus Leerzeichen bestehen. Auflösungsstufe, Seitenverhältnis und Ausgabeformat sind jeweils aus den aufgeführten Enum-Werten zu wählen; benutzerdefinierte Zahlenwerte werden nicht unterstützt. Der Seed-Wert ist auf ganze Zahlen von 0 bis 2147483647 beschränkt. Das Ergebnis ist ein statisches Bild, und jede Anfrage liefert ein Bild.
Neuigkeiten
Changelog ansehen →- Neues Modell MiniMax H3 Image ist verfügbar: Text-zu-Bild und Bearbeitung mit mehreren Referenzbildern
Häufige Fragen
Alle Fragen ansehen →-
Wie viele Referenzbilder können maximal angegeben werden?
Beim Bild-zu-Bild-Workflow werden pro Anfrage maximal 16 Referenzbilder akzeptiert, mindestens 1, im Format JPG, PNG oder WEBP, mit einer Kantenlänge von 128–8192 px und höchstens 20 MB pro Bild. Jedes Referenzbild kostet zusätzlich $0.0036, zum Beispiel kostet 2K mit 3 Referenzbildern insgesamt $0.0129 + 3 × $0.0036 = $0.0237. Beim Verfassen des Prompts sollten die einzelnen Bilder in der Reihenfolge ihrer Übergabe mit Nummern wie Picture 1, Picture 2 referenziert werden, damit das Modell sie korrekt den Objekten zuordnen kann, die du bearbeiten oder kombinieren möchtest.
-
Wie werden die Ausgabemaße festgelegt, und wie groß können sie werden?
Die Auflösung ist in drei Stufen verfügbar: 1K, 2K und 4K, entsprechend etwa 1 MP, 4 MP und 16 MP; Standard ist 2K. Das Seitenverhältnis kann auf auto oder 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9 gesetzt werden; bei auto entscheidet das Modell anhand des Prompts und der Referenzbilder selbst – wenn eine feste Bildkomposition gewünscht ist, explizit angeben.
-
Wie sollte man den Prompt schreiben, damit das Aussehen der Figur erhalten bleibt?
Der Aufbau folgt der Reihenfolge „zuerst das zu erhaltende Motiv beschreiben, dann den zu ändernden Teil schreiben, zuletzt mit Nummern auf Bilder verweisen“: ① Beschreibe zunächst in ein bis zwei Sätzen die äußeren Merkmale des festen Motivs, etwa Frisur, Kleidung, Farbgebung und markante Details; ② erläutere dann die Zielszene, die Pose, die Kameraeinstellung und das Licht; ③ wenn auf Referenzbilder verwiesen werden soll, schreibe „die Person in Picture 1“, und nummeriere mehrere Bilder in der Reihenfolge ihrer Übergabe. Der Prompt darf höchstens 5000 Zeichen umfassen; Details in den Fließtext zu schreiben ist wirksamer, als Adjektive zu häufen.
-
Wie erstellt man mehransichtige Charakter-Setups desselben Charakters?
Verwende zunächst ein klares, unverdecktes Referenzbild als Picture 1, lege die Beschreibung der Figurenmerkmale im Prompt fest und generiere dann Bild für Bild, wobei du nur die Beschreibung von Winkel oder Pose änderst, zum Beispiel Vorderansicht, Seitenansicht, Rückansicht, Halbfigur und Ganzkörper, mit einem festen Seitenverhältnis von 3:4 oder 1:1. Denselben Seed für jedes Bild beizubehalten hilft, zufällige Abweichungen zu reduzieren; die stilistische Konsistenz einer Bildserie wird hauptsächlich durch das Referenzbild plus eine feste Beschreibung des Motivs gewahrt.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: minimax-h3-image/text-to-image
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für minimax-h3-image/text-to-image und Route default — siehe Parametertabelle unten.
seedintegerOptionalmin 0max 2147483647Fester Zufallsseed für reproduzierbare Ergebnisse; ganzzahlig, bei Auslassung wird ein zufälliger Seed verwendet.
promptstringPflichtminLength 1maxLength 5000pattern \SBildbeschreibungs-Prompt, Länge 1–5000 Zeichen; der Prompt wird automatisch erweitert, um reichere Details darzustellen.
resolutionstringOptionalStandard: "2K"Ausgabauflösungsstufe: 1K entspricht ca. 1 MP, 2K ca. 4 MP, 4K ca. 16 MP; Standard ist 2K.
1K2K4Kaspect_ratiostringOptionalStandard: "1:1"Ausgabeseitenverhältnis; bei Einstellung auf auto wählt das Modell selbst, Standard ist 1:1.
auto1:15:44:54:33:43:22:3Alle anzeigen (3)Weniger anzeigen
16:99:1621:9output_formatstringOptionalStandard: "jpeg"Ausgabebildformat, Standard ist jpeg; PNG-Dateien sind deutlich größer (2K ca. 12 MB, 4K ca. 30 MB).
jpegpngcallbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image/text-to-image",
"input": {
"prompt": "…",
"resolution": "2K",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "minimax-h3-image/text-to-image",
input: {
"prompt": "…",
"resolution": "2K",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "minimax-h3-image/text-to-image",
"input": {
"prompt": "…",
"resolution": "2K",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artikel
Alle Artikel ansehen →Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Z-Image Alibaba $0.008 /Bild -
GPT Image 2.6 OpenAI $0.023 /Bild -
Google Virtual Try-On Google $0.107 /Bild -
Imagen 4 Google $0.030 /Bild -
FLUX 1.1 Pro Black Forest Labs $0.050 /Bild -
851 Labs Background Remover 851 Labs $0.002 /Bild -
Krea 3 Krea $0.036 /Bild -
FIBO 1.5 Bria $0.058 /Bild -
Seedream 5.5 ByteDance $0.019 /Bild -
FLUX.1 Kontext Max Black Forest Labs $0.071 /Bild -
Nano Banana Pro Google $0.029 /Bild -
Recraft V4.1 Recraft $0.010 /Bild



