Zum Hauptinhalt springen
POST

Autorisierung

string
erforderlich
Alle Endpunkte erfordern eine Authentifizierung per Bearer TokenAPI-Schlüssel erhalten:Besuchen Sie die Seite zur Verwaltung von API-Schlüsseln, um Ihren API-Schlüssel zu erhaltenFügen Sie ihn in den Anfrage-Header ein:

Body

string
Standard:"mai-image-2.7"
erforderlich
Name des BildgenerierungsmodellsBeide Modelle bieten exakt dieselben Funktionen und Parameter.
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Bildauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
string
erforderlich
Textbeschreibung für die Bildgenerierung oder Bearbeitungsanweisung
  • Unterstützt Chinesisch und Englisch, detaillierte Beschreibungen werden empfohlen
  • Maximal 20.000 Zeichen; längere Prompts führen zu 400
  • Darf nicht leer sein oder nur aus Leerzeichen bestehen
integer
Standard:"1"
Anzahl der zu generierenden BilderWert: 1
Pro Anfrage wird nur 1 Bild erzeugt; senden Sie für mehrere Bilder separate Aufgaben. 0, negative Werte oder Werte größer als 1 führen zu 400
string
Standard:"1:1"
Seitenverhältnis oder Pixelabmessungen des Bildes, gilt nur für Text-zu-BildZwei Schreibweisen werden unterstützt:
  • Seitenverhältnis: beliebiges ganzzahliges Verhältnis von 1:4 bis 4:1, z. B. 1:1, 16:9, 9:16, 21:9; bestimmt zusammen mit resolution die tatsächlichen Pixel
  • Pixelabmessungen: BreitexHöhe (auch Breite*Höhe, Breite×Höhe), z. B. 2048x1152; resolution wird dann ignoriert
Grenzen für Pixelabmessungen:
  • Breite und Höhe jeweils ≥ 768
  • Breite × Höhe ≤ 4.194.304 (2048×2048)
  • Breite und Höhe werden jeweils auf ein Vielfaches von 32 abgerundet, z. B. ergibt 1000x1000 tatsächlich 992x992
Beispiele: ✅ 2048x2048, 2048x1152, 2560x1536; ❌ 512x512 (Seitenlänge unter 768), 2080x2048 (Gesamtpixelzahl überschritten)
auto wird nicht unterstützt und führt zu 400
string
Standard:"1K"
Ausgabeauflösungsstufe, gilt nur, wenn size ein Seitenverhältnis istOptionen: 1K / 2K (auch in Kleinschreibung)size × resolution → tatsächliche Pixelzuordnung:
4K wird nicht unterstützt; andere Stufen führen zu 400. Da die kürzere Seite mindestens 768 beträgt, überschreiten Seitenverhältnisse, die gestreckter als 2:1 sind, auf der Stufe 1K tatsächlich etwa 1 Million Pixel.
integer
Exakte Pixelbreite, muss zusammen mit height angegeben werden
  • Höchste Priorität: überschreibt bei gemeinsamer Angabe size und resolution
  • Es gelten dieselben Grenzen wie für Pixelabmessungen in size: Breite und Höhe jeweils ≥ 768, Gesamtpixelzahl ≤ 4.194.304
  • Gilt nur für Text-zu-Bild
integer
Exakte Pixelhöhe, muss zusammen mit width angegeben werden; es gelten dieselben Grenzen wie für width
array
Array von Referenzbildern; bei Angabe wird in den Bild-zu-Bild-Modus gewechselt
  • 1 Bild: Einzelbildbearbeitung, mehrere Bilder: Komposition mehrerer Bilder
string
HintergrundtypOptionen: auto / opaque, Wirkung wie ohne Angabe
Ein transparenter Hintergrund (transparent) ist derzeit nicht verfügbar; transparent oder andere Werte führen zu 400
auto_aspect_ratio: true und web_grounding: true werden nicht unterstützt und führen zu 400. quality, style, output_format, response_format und mask_url werden nicht unterstützt und ignoriert. Die Ausgabe erfolgt immer als PNG.

Anwendungsbeispiele

Text-zu-Bild (minimale Anfrage) Standardmäßig 1:1 + 1K, Ausgabe 1024×1024.
Text-zu-Bild (mit Seitenverhältnis + 2K)
Text-zu-Bild (exakte Pixel)
Einzelbildbearbeitung
Komposition mehrerer Bilder (URL + Base64 gemischt)

Response

integer
Statuscode der Antwort
array
Array mit Antwortdaten

Abfrage der Aufgabenergebnisse

Nach erfolgreicher Einreichung wird eine task_id zurückgegeben. Pollen Sie den Aufgabenstatus über GET /v1/tasks/{task_id}, siehe API zur Aufgabenabfrage für Details. Wir empfehlen, alle 3–5 Sekunden abzufragen und ein Gesamt-Timeout von 3 Minuten festzulegen.

Beispiel einer erfolgreichen Antwort

Bildzugriff: data.result.images[0].url[0]. Der Bildlink läuft nach expires_at ab; laden Sie das Bild daher möglichst bald herunter und speichern Sie es.

Aufgabenstatus