Zum Hauptinhalt springen
POST

Authentifizierung

string
erforderlich
Alle Endpunkte verwenden Bearer-Token-Authentifizierung. Den Schlüssel erhalten Sie auf der API-Schlüssel-Seite.

Modellübersicht

MiniMax H3 Image ist stark bei fotorealistischen Aufnahmen, Postern, Produktbildern und Bildern mit Text. Das Modell erweitert den Prompt standardmäßig zunächst automatisch zu einer detaillierten Bildbeschreibung und generiert erst dann das Bild. Den erweiterten Text finden Sie im Abfrageergebnis unter revised_prompt. Soll exakt nach dem Originaltext generiert werden, siehe Prompt-Optimierung deaktivieren.
Ohne resolution wird standardmäßig in 4K (ca. 16 Megapixel) ausgegeben; der Preis liegt etwa beim 3,6-Fachen von 1K / 2K. Wenn Sie kein 4K benötigen, übergeben Sie explizit "resolution": "2K".

Anfrageparameter

string
erforderlich
Name des Bildgenerierungsmodells, fest minimax-h3-image-highspeed.
string
erforderlich
Textbeschreibung des zu erzeugenden oder zu bearbeitenden Bildes.Unterstützt Chinesisch und Englisch. Länge nach Entfernen führender und abschließender Leerzeichen: 1 ~ 32,000 Zeichen.
string[]
Array mit Referenzbildern, höchstens 16. Ist das Feld gesetzt, wird automatisch der Bearbeitungsmodus aktiviert.Jeder Eintrag kann ein öffentlich erreichbarer http(s)://-Direktlink oder Inline-Base64 im Format data:image/png;base64,... sein (die Plattform wandelt es zuerst in einen Link um und übergibt es dann an das Modell).Siehe Anforderungen an Referenzbilder.
string
Standard:"auto"
Seitenverhältnis oder exakte Pixelmaße des Ausgabebildes.Unterstützt:
  • auto: Das Modell wählt Komposition und Seitenverhältnis anhand des Prompts
  • Seitenverhältnis: Format X:Y, X und Y ganze Zahlen von 1 bis 300, Verhältnis zwischen 1:3 und 3:1 (einschließlich), z. B. 1:1, 4:3, 16:9, 9:16, 3:1
  • Exakte Pixel: BreitexHöhe, z. B. 2048x1152 (auch die Trennzeichen X, ×, * sind zulässig)
Siehe Größenregeln.
string
Standard:"4K"
Auflösungsstufe; bestimmt zusammen mit dem Seitenverhältnis die tatsächlichen Ausgabepixel.
  • 1K: ca. 1 Megapixel
  • 2K: ca. 4,2 Megapixel
  • 4K (Standard): ca. 16 Megapixel
Kleinschreibung wird ebenfalls akzeptiert.
Wenn size exakte Pixelmaße verwendet, darf resolution nicht übergeben werden, sonst wird 400 zurückgegeben.
integer
Standard:"1"
Anzahl der zu generierenden Bilder, 1 ~ 10.
boolean
Standard:"true"
Ob der Prompt automatisch erweitert wird.false wirkt nur bei Text-zu-Bild und erfordert eine explizit angegebene Größe; siehe Prompt-Optimierung deaktivieren.
string
Standard:"jpeg"
Ausgabedateiformat.
  • jpeg (Standard, auch jpg möglich)
  • png
  • webp
integer
Standard:"95"
Kompressionsqualität von 0 bis 100; wirkt nicht bei png.
boolean
Standard:"false"
Ob ein sichtbares Wasserzeichen für KI-Generierung auf dem Bild angebracht wird. Die unsichtbare Kennzeichnung in den Bildmetadaten bleibt davon unberührt.
Folgende Parameter werden nicht unterstützt und ignoriert: quality, style, seed, negative_prompt, background, mask_url.Ergebnisse werden immer als URL zurückgegeben; response_format: "b64_json" führt zu 400.

Größenregeln

Stufe + Seitenverhältnis

Die Stufe bestimmt die Gesamtfläche, das Seitenverhältnis die Form: Die tatsächlichen Ausgabepixel rundet das Modell anhand von Verhältnis und Stufe; maßgeblich ist das zurückgegebene Ergebnis. Für exakte Maße verwenden Sie die Pixelschreibweise.

Exakte Pixel

Bei size: "BreitexHöhe" gelten folgende Bedingungen:
  • ✅ 1024x1024, 2048x1152, 1536x1536, 4000x5000
  • ❌ 512x512 (Fläche zu klein), 4000x1000 (Verhältnis über 3:1), 5000x5000 (über 20 Megapixel)

Anforderungen an Referenzbilder

Stellen Sie bei URLs sicher, dass der Link öffentlich erreichbar ist. Ist der Link nicht erreichbar, schlägt die Aufgabe in der Generierungsphase fehl (status ist failed, die Kosten werden vollständig erstattet).Im Bearbeitungsmodus ist die Prompt-Optimierung immer aktiv und kann nicht deaktiviert werden.

Prompt-Optimierung deaktivieren

Standardmäßig erweitert das Modell zuerst den Prompt und generiert dann das Bild. Für eine Generierung exakt nach dem Originaltext übergeben Sie "prompt_optimizer": false. Voraussetzungen:
  • Nur für Text-zu-Bild; mit image_urls wird 400 zurückgegeben
  • Die Größe muss explizit angegeben sein: size muss ein Seitenverhältnis (z. B. 1:1) oder Pixelmaße (z. B. 1024x1024) sein, nicht auto und nicht leer
Bei deaktivierter Optimierung liest das Modell nur etwa die ersten 4096 Token des Prompts.

Response

integer
Antwortstatuscode; 200 bei erfolgreicher Übermittlung.
array
Daten der Übermittlungsantwort.

Übermittlungsantwort

Nach erfolgreicher Übermittlung wird sofort die ID der asynchronen Aufgabe zurückgegeben:

Aufgabenergebnis abfragen

Verwenden Sie die task_id aus der Übermittlungsantwort mit dem Endpunkt zur Aufgabenabfrage:
Die Schnellversion generiert schneller als die Standardversion (gemessen beim Standardmodell: einzelnes Bild in 1K / 2K etwa 10 ~ 20 Sekunden, in 4K etwa 20 Sekunden). Fragen Sie den Status am besten alle 3 ~ 5 Sekunden ab, bis er completed oder failed lautet. Eine Aufgabe kann bis zu 600 Sekunden laufen; setzen Sie das Polling-Timeout im Client daher auf 10 Minuten.

Erfolgreiche Aufgabe

Die Bild-URLs stehen in data.result.images[0].url[]; alle n Bilder befinden sich in diesem einen Array. Laden Sie sie vor expires_at herunter und speichern Sie sie. Schlägt eine Aufgabe fehl, ist status failed, der Grund steht in error.message, und die Kosten werden automatisch vollständig erstattet.

Anwendungsbeispiele

Text-zu-Bild (Standard 4K)

Text-zu-Bild (1K + Seitenverhältnis, 4 Bilder)

Exakte Pixel + PNG

Bearbeitung mit Referenzbildern

Prompt-Optimierung deaktivieren