MiniMax H3 Image API
Vollständige API-Referenz für die Text-zu-Bild- und Bildbearbeitungsmodelle von MiniMax H3 Image.
Modellvarianten
Diese API unterstützt zwei Modellvarianten:
Kurzübersicht
Unterstützte Seitenverhältnisse
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
Geben Sie das Verhältnis als separate numerische Werte für width und height an, nicht als Pixelabmessungen. Werden beide Werte weggelassen, gilt standardmäßig das Verhältnis 1:1; andernfalls müssen beide Werte als eines der unterstützten Ganzzahlpaare angegeben werden.
MiniMax H3 Image (Text-zu-Bild)
Endpunkt
POST /api/v1/image/task
Authentifizierung
Authorization: Bearer YOUR_API_KEY
Anfrageparameter
Erforderlich
Optional
Hinweis: Das Verhältnis width:height muss einem der 15 oben aufgeführten unterstützten Seitenverhältnisse entsprechen.
Beispielanfrage
javascript
MiniMax H3 Image Edit (Bildbearbeitung)
Endpunkt
POST /api/v1/image/task
Anfrageparameter
Erforderlich
Optional
Hinweis: Das Verhältnis width:height muss einem der 15 oben aufgeführten unterstützten Seitenverhältnisse entsprechen.
Beispielanfrage
javascript
Beispiel für die Bearbeitung eines einzelnen Bildes
javascript
Beispiel für eine Komposition aus mehreren Bildern
javascript
Antwortformat
Anfängliche Antwort
json
Polling-Antwort
Fragen Sie GET /api/v1/image/{task_id} regelmäßig ab, um den Status zu prüfen. Erfolgreiche Polling-Antworten enthalten die URLs der generierten Bilder unter data.task_result.images[].url.
Statuswerte
submitted: Aufgabe angenommenprocessing: Bildgenerierung läuftsucceed: Bildgenerierung abgeschlossenfailed: Bildgenerierung fehlgeschlagen
Bewährte Vorgehensweisen
- Detaillierte Prompts: Beschreiben Sie Motiv, Beleuchtung und Komposition und begrenzen Sie Prompts auf 5000 Zeichen
- Auflösungsauswahl: Geben Sie bei jeder Anfrage ausdrücklich
1k,2koder4kan - Seitenverhältnis: Verwenden Sie zusammengehörige Verhältniswerte für
widthundheightoder lassen Sie beide für1:1weg - Qualität der Bildbearbeitung: Stellen Sie 1-16 Referenzbilder bereit, die den unterstützten Format- und Abmessungsanforderungen entsprechen