Skip to main content
POST

Unterstützte Modelle

Sofern ein Parameter nicht ausdrücklich als exklusiv für Flex gekennzeichnet ist, gelten die folgenden Parameter und Pixelgrenzen für alle drei Modelle.

Autorisierung

string
erforderlich
Alle Endpunkte erfordern eine Authentifizierung mit einem Bearer-Token.API-Key abrufen:Rufen Sie die API-Key-Verwaltung auf, um Ihren API-Key zu erhalten.Fügen Sie ihn dem Anfrage-Header hinzu:

Body

string
erforderlich
Modellname:
  • flux-2-flex – Flex-Modell mit präzisen Steuerungsmöglichkeiten
  • flux-2-pro – Pro-Modell für allgemeine Anwendungen
  • flux-2-max – Max-Modell mit höchster Qualität
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 Generierung oder Bearbeitung des Bildes.
string
Standard:"2MP"
Stufe der Ausgabeauflösung:
  • 1MP
  • 2MP – Standard
  • 3MP
  • 4MP
Dabei entspricht 1MP 1,048,576 Pixeln.Kompatible Aliase: 512 / 512P / 1M entsprechen 1MP, 1K / 1024 entsprechen 2MP, 2K / 2048 entsprechen 3MP und 4K entspricht 4MP. Andere Werte werden abgelehnt.Die tatsächlichen Ausgabemaße hängen zusätzlich von size ab.
string
Standard:"1:1"
Seitenverhältnis oder Pixelmaße des Ausgabebildes.size unterstützt auch auto: Wenn image_urls angegeben ist, wird das Seitenverhältnis des Referenzbildes übernommen und die aktuelle resolution-Stufe beibehalten. Ohne Referenzbild wird der Standardwert 1:1 verwendet.Folgende Größenoptionen werden unterstützt:
  • 1:1 – Quadrat (Standard)
  • 4:3 – Querformat
  • 3:4 – Hochformat
  • 16:9 – Breitbild
  • 9:16 – vertikales Breitbild
  • 3:2 – klassisches Querformat
  • 2:3 – klassisches Hochformat
  • 21:9 – Ultrawide
  • 9:21 – ultrahoch
  • auto – Seitenverhältnis des Referenzbildes übernehmen
Alternativ kann eine Pixelangabe im Format "BreitexHöhe" übergeben werden, zum Beispiel "1024x1536".
integer
Exakte Ausgabebreite in Pixeln. Muss zusammen mit height angegeben werden; beide Werte müssen mindestens 64 betragen.Wird nur einer der beiden Werte angegeben, schlägt die Aufgabe fehl.
integer
Exakte Ausgabehöhe in Pixeln. Muss zusammen mit width angegeben werden; beide Werte müssen mindestens 64 betragen.Die Gesamtausgabe darf 4 MP nicht überschreiten: width × height ≤ 4.194.304.
array
Liste der Referenzbilder für Bild-zu-Bild-Aufgaben oder die Kombination mehrerer Referenzbilder.Einschränkungen:
  • Maximal 8 Bilder
  • Öffentlich erreichbare URLs oder Base64-kodierte Eingabebilder werden unterstützt
  • Die Gesamtpixelzahl des Ausgabebildes und aller Referenzbilder darf 9 MP nicht überschreiten
string
Standard:"jpeg"
Kodierungsformat des Ausgabebildes. Unterstützt werden jpeg, png und webp; Standard ist jpeg.
integer
Standard:"1"
Anzahl der zu generierenden Bilder. Der Wert muss 1 sein. Für mehrere Bilder müssen mehrere Aufgaben übermittelt werden.
integer
Zufalls-Seed. Ein fester Seed erzeugt bei unveränderten übrigen Parametern dasselbe Ergebnis; ohne Angabe wird er zufällig gewählt.
boolean
Standard:"false"
Legt fest, ob die Prompt-Erweiterung aktiviert wird:
  • true – aktiviert
  • false – deaktiviert (Standard)
Setzen Sie den Wert ausdrücklich auf false, um die Prompt-Umformulierung zu deaktivieren.
integer
Standard:"2"
Toleranzstufe der Inhaltsprüfung im Bereich von 0 bis 5. Höhere Werte bedeuten eine weniger strenge Prüfung.
integer
Standard:"50"
Anzahl der Sampling-Schritte, nur von flux-2-flex unterstützt. Bereich: 1–50. Höhere Werte liefern üblicherweise mehr Details, benötigen aber mehr Zeit.
number
Standard:"5.0"
Stärke der Prompt-Gewichtung, nur von flux-2-flex unterstützt. Bereich: 1,5–10. Höhere Werte richten das Ergebnis üblicherweise stärker am Prompt aus.

Auflösungstabelle

Priorität der Größenparameter

  1. Gemeinsam angegebene width und height legen die exakten Pixelmaße fest.
  2. Eine Pixelangabe in size, zum Beispiel 1024x1536, legt die exakten Pixelmaße fest.
  3. Andernfalls bestimmen resolution und das Seitenverhältnis in size die Maße anhand der Tabelle.
  4. Ohne Größenangaben gilt 2MP mit 1:1, also 1440×1440.
Nur width oder nur height anzugeben ist ungültig und führt zum Fehlschlagen der Aufgabe.

Anwendungsbeispiele

Einfache Text-zu-Bild-Generierung
Generierung mit höchster Qualität
Exakte Pixelmaße
Kombination mehrerer Referenzbilder
Präzise Steuerung mit Flex

Response

Nach erfolgreichem Absenden ist data ein Array. Die Aufgaben-ID befindet sich in data[0].task_id.
integer
Statuscode der Antwort.
array
Array der Antwortdaten.

Aufgabenergebnis abfragen

Die Aufgabe wird asynchron verarbeitet. Rufen Sie mit der task_id aus der Übermittlungsantwort den folgenden Endpunkt auf, bis sich der Status in completed oder failed ändert:
Mögliche Aufgabenstatus: Beispiel einer abgeschlossenen Antwort:
result.images[].url ist ein String-Array. Diese Modellfamilie generiert pro Anfrage genau ein Bild; lesen Sie daher url[0]. Die Gültigkeitsdauer der Bild-URL richtet sich nach dem Unix-Zeitstempel expires_at im selben Objekt. Speichern Sie das Ergebnis vor diesem Zeitpunkt.

Ungültige Modellparameter und fehlgeschlagene Aufgaben

Ungültige Modellparameter werden asynchron gemeldet: Die Übermittlung liefert HTTP 200 und eine task_id. Erst beim Abfragen der Aufgabe erscheint der Endstatus failed mit dem konkreten Grund unter data.error.message. Deshalb muss bis zu einem Endstatus abgefragt werden.
data.error.code lautet bei solchen Fehlern immer task_failed; der konkrete Grund steht in message. Fehlgeschlagene Aufgaben werden vollständig erstattet.

Hinweise

  1. Größenbeschränkung: Das Ausgabebild darf 4 MP nicht überschreiten; Breite und Höhe müssen jeweils mindestens 64 Pixel betragen.
  2. Gesamtpixelgrenze: Das Ausgabebild und alle Referenzbilder dürfen zusammen höchstens 9 MP umfassen.
  3. Referenzbilder: Es werden maximal 8 Referenzbilder als öffentlich erreichbare Bild-URLs oder Base64-kodierte Eingabebilder unterstützt.
  4. Feste Bildanzahl: n muss 1 sein; pro Anfrage wird genau ein Bild generiert.
  5. Prompt-Erweiterung: prompt_upsampling ist standardmäßig deaktiviert.
  6. Exklusive Flex-Parameter: steps und guidance gelten nur für flux-2-flex.
  7. Asynchrone Aufgabe: Fragen Sie nach erfolgreicher Übermittlung /v1/tasks/{task_id} ab, um das endgültige Ergebnis zu erhalten.
  8. Ergebnislink: Die Gültigkeit der Bild-URL richtet sich nach expires_at in der Antwort.