FLUX 3 Image: Leitfaden zu Layout-Boxen und gezielten Bildbearbeitungen

Mit FLUX 3 Image können Sie beschreiben, wo einzelne Elemente platziert werden sollen, indem Sie Rechtecke als Teil eines Bildprompts verwenden. Dasselbe System unterstützt Änderungen an einem Referenzbild: Für jedes Element lassen sich eine Ausgangsposition, ein Ziel und eine Beschreibung der gewünschten Änderung angeben. Black Forest Labs nahm den Bildendpunkt in seine Versionshinweise vom 1. Oktober 2026.

Für Designerinnen, Designer und Kreative liegt der entscheidende Unterschied darin, ob sie eine ganze Komposition planen oder ein Element in einem vorhandenen Bild ändern wollen. Dieser Leitfaden erklärt, wie Sie sich zwischen beiden Möglichkeiten entscheiden, ein Rechteck in die erforderlichen Koordinaten umrechnen und ein API-Ergebnis abrufen. Dies ist ein Leitfaden auf Grundlage der Dokumentation, geprüft am 3. Oktober 2026. BIG CHANGE hat mit dem Produkt kein Bild generiert und keines bearbeitet.

Die große Änderung

• Was sich geändert hat: Die Veröffentlichung von BFL vom 1. Oktober dokumentiert Komposition und Bearbeitung über v1/flux-3-image. Eine Szenenbeschreibung und eine JSON-Elementtabelle teilen sich einen Prompt; Boxen legen Positionen oder Änderungen fest. Versionshinweise von BFL
• Warum das wichtig ist: Kreative können ein geplantes Rechteck in Koordinaten umrechnen und anschließend festlegen, welche Elemente eines Referenzbilds erhalten, verschoben oder ersetzt werden sollen. Entscheidend ist, wie viel sie festlegen möchten: eine ganze Komposition, eine einfache Anweisung oder eine ausführliche Bearbeitungstabelle. BFL-Tutorial zu Boxen
• Worauf zu achten ist: Legen Sie vor dem Absenden Auflösung und Budget fest: Für 1k und 4k nennt BFL Preise von 0,048 $ und 0,607 $ pro Bild. Prüfen Sie das vollständige Ergebnis, da Elemente über die Boxen hinausreichen können und eine Bearbeitung die Beleuchtung, Schatten oder Spiegelungen in der Nähe verändern kann. BFL-Preise, Bearbeitungsgrenzen

Wählen Sie den Browser- oder API-Weg

BFLs Produktseite beschreibt zwei Einstiegsmöglichkeiten: Zeichnen Sie Boxen im browserbasierten Playground oder senden Sie einen Layout-Prompt über die API. In der Dokumentation zum Playground finden Sie die codefreie Nutzung. Wählen Sie den Browserweg, wenn Sie die Regionen direkt einzeichnen möchten; verwenden Sie die API, wenn Sie Koordinaten in einer Anfrage übergeben und das Ergebnis programmatisch abrufen müssen. Wir haben die aktuellen Playground-Steuerelemente nicht geprüft; die folgenden Anweisungen erläutern daher das dokumentierte Anfrageformat und keine Abfolge von Browser-Schaltflächen.

Richten Sie für die API ein BFL-Konto ein, laden Sie Guthaben auf und rufen Sie im Dashboard Ihren Schlüssel ab. Senden Sie JSON mit einer POST-Anfrage an https://api.bfl.ai/v1/flux-3-image, wobei Sie Content-Type: application/json und den API-Schlüssel im x-key-Header angeben. Nur prompt ist erforderlich. BFL-Leitfaden zur Generierung, Preise und Einrichtung

FLUX 3 Image und FLUX 3 Dev müssen auseinandergehalten werden: Diese Anleitung behandelt den gehosteten Image-Endpunkt von BFL. Auf der Produktseite wird über den Vertrieb eine kommerzielle Lizenz für die Gewichte angeboten. Die für diesen Leitfaden geprüften Quellen belegen nicht, dass FLUX 3 Image mit offenen Gewichten heruntergeladen werden kann. Zugang zu FLUX 3 Image

Legen Sie fest, wie viel Sie am Bild vorgeben möchten

Bei einer einfachen Änderung wird laut BFL während der Prompt-Erweiterung automatisch eine Box ermittelt. Wenn Sie genauer steuern möchten, geben Sie eine eigene Tabelle an. In normalen Anweisungen bezeichnet „Bild 1“ die erste Referenz; in Bearbeitungszeilen ist dieselbe Referenz ref_image_0. BFL-Leitfaden zur Bildbearbeitung

Referenzbilder gehören in images als URLs oder Base64-Daten hinein, entweder als einzelner String oder als Liste. Sie können 1 bis 10 Bilder umfassen; jedes muss zwischen 256 × 256 Pixeln und 16 Megapixeln groß sein. Das Standardformat aspect_ratio hat den Wert auto: Es richtet sich nach dem ersten Referenzbild oder ist quadratisch, wenn kein Referenzbild mitgegeben wird. Legen Sie das Format ausdrücklich fest, wenn Ihr Layout eine bestimmte Form erfordert. BFL-Endpunktübersicht

Rechnen Sie ein Rechteck in eine Box um

Jede Box besteht aus [top, left, bottom, right]; die ganzzahligen Koordinaten reichen von 0 bis 1000. Zuerst kommen die vertikalen Koordinaten. Jede Achse wird unabhängig über die gesamte Bildfläche skaliert; das Raster wird daher an ein Quer- oder Hochformat angepasst. BFL-Boxformat

Um Pixelpositionen umzurechnen, teilen Sie obere und untere Kante durch die Bildhöhe und die linke und rechte Kante durch die Bildbreite. Multiplizieren Sie jedes Ergebnis mit 1000 und runden Sie es. Die dokumentierte Umrechnung von BFL verwendet eine Bildfläche von 1920 × 1080 Pixeln:

Die Box lautet [100, 200, 900, 800]. Sie erstreckt sich vertikal über 10 bis 90 Prozent und horizontal über 20 bis 80 Prozent des Bildes. Deshalb verändert das Vertauschen von Breite und Höhe oder die Eingabe der linken Kante vor der oberen die vorgesehene Region. Behalten Sie das Seitenverhältnis bei, für das Sie das Layout entworfen haben. BFL-Umrechnung von Koordinaten

Ein neues Bild komponieren

Beschreiben Sie die gesamte Komposition und benennen Sie Elemente mit <id> als Markierungen. Fügen Sie ein JSON-Array mit einem Feld id, bbox und desc für jedes Element hinzu. Das Array ist Text innerhalb von prompt, kein weiteres Feld auf oberster Ebene der API-Anfrage.

Das dokumentierte Beispiel von BFL zeigt eine laufende Silhouette: Ein Hintergrund füllt die gesamte Bildfläche aus, und eine Figur befindet sich in der mittleren Box. Die folgende gekürzte Anfrage übernimmt das Layout des Beispiels; BIG CHANGE hat sie nicht ausgeführt:

{
  "prompt": "A black running silhouette <silhouette_1> on a chartreuse background <background_1>. [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"Chartreuse background with paper texture\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"Black running silhouette with stippled texture\"}]",
  "aspect_ratio": "1:1",
  "resolution": "1k"
}

Wenn ein Layout Text enthält, erhält jede Zeile eine eigene Tabellenzeile; die genau gewünschten Wörter gehören in desc. Boxen steuern Platzierung und Größe, doch laut BFL kann ein Element über sein Rechteck hinausreichen. Es handelt sich nicht um Masken, die den Inhalt hart abschneiden. BFL-Tutorial zu Komposition und Grenzen

Ein vorhandenes Bild bearbeiten

Geben Sie das Ausgangsbild in images an. Bearbeitungszeilen behalten id und desc bei, ersetzen aber bbox durch diese Felder:

Verbinden Sie die Anweisung und das Bearbeitungsarray zu prompt, wie bei der Komposition. Beschreiben Sie Ergänzungen und Entfernungen sowohl in der Anweisung als auch in der Tabelle. Fügen Sie „Beibehalten“-Zeilen für Elemente hinzu, die an Ort und Stelle bleiben sollen. Laut BFL bleiben Pixel außerhalb der Boxen üblicherweise unverändert; die Beleuchtung, Spiegelungen und Schatten in der Nähe können sich jedoch ändern. Vergleichen Sie vor der Freigabe der Bearbeitung das gesamte Ergebnis mit dem Ausgangsbild. BFL berichtet außerdem, dass neue Elemente in ungefähr 40 × 25 Pixel großen Boxen in den eigenen Tests häufig nicht erschienen. Dies ist eine Beobachtung des Anbieters, weder eine allgemeingültige Mindestgröße noch ein Test von BIG CHANGE. BFL-Hinweise zur Bildbearbeitung, Schema für Bearbeitungszeilen

Wählen Sie Auflösung und Budget

Die Übersicht führt 768sq, 1k, 1.5k, 2k und 4k; standardmäßig ist 1k voreingestellt. Die Preisseite führt die folgenden Preise auf, nennt jedoch keinen Preis für 1.5k. Prüfen Sie die Kosten dieser Option, bevor Sie sie verwenden. BFL-Übersicht

Dies sind die von BFL angegebenen Preise in US-Dollar, geprüft am 3. Oktober. Die Spalte für zehn Anfragen ist berechnet und keine gemessene Ausgabe. BFL nennt denselben Preis für API und Playground; ein Guthabenpunkt entspricht 0,01 $. Die Antwort nach dem Absenden enthält das Feld cost. Eine 4k-Anfrage kostet etwa 12,6-mal so viel wie eine Anfrage mit 1k; wählen Sie die für Ihre Aufgabe nötige Ausgabegröße und planen Sie weitere Versuche ein. Eine geänderte Auflösung erfordert eine neue Anfrage. Dieser Leitfaden belegt nicht, dass zwei Anfragen dieselbe Komposition ergeben. BFL-Preise

Die optionale Einstellung grounding ist standardmäßig auf true gesetzt und aktiviert vor der Generierung eine Web- und Bildsuche. Laut BFL liefert die Deaktivierung schnellere Ergebnisse, bei denen nur der Prompt verwendet wird. Wir haben weder diesen Geschwindigkeitsunterschied gemessen noch die Genauigkeit der durch Recherche gestützten Ergebnisse geprüft. BFL-Dokumentation zur Recherche-Funktion

Absenden, abrufen und Ausgabe speichern

Bewahren Sie nach dem Absenden die zurückgegebene polling_url auf und fragen Sie genau diese URL mit Ihrem API-Schlüssel ab. Sie verweist auf die Region, in der sich der Auftrag befindet. Pending, Reasoning und Generating bedeuten, dass der Auftrag noch läuft. Bei Ready laden Sie result.sample herunter; der signierte Link läuft nach einer Stunde ab. Senden Sie Ihren x-key-Header nicht an die Download-URL. Das Ergebnis enthält außerdem result.prompt; darin steht die erweiterte Anweisung. Auch result.duration, die Generierungsdauer, ist enthalten. BFL-Anleitung zum Abruf von Ergebnissen

Ein blockierter oder fehlgeschlagener Auftrag erfordert eine andere Reaktion als ein laufender. Request Moderated bedeutet, dass die Eingabe blockiert wurde; Content Moderated bedeutet, dass die Ausgabe blockiert wurde. Passen Sie die Eingabe vor einem neuen Versuch an. Bei Error prüfen Sie die Antwort; bei einem unbekannten oder abgelaufenen Auftrag lautet die Meldung Task not found. BFL warnt, dass ein fehlgeschlagener Auftrag als HTTP 503 mit einem gewöhnlichen JSON-Body eintreffen kann; lesen Sie status aus, bevor Sie es erneut versuchen. Zu große Referenzbilder führen zu 400; ein unbekanntes Feld, ein ungültiger Wert, ein leerer Prompt oder ein zu kleines Bild kann zu 422 führen. Felder wie seed, width und input_image von anderen Endpunkten werden hier nicht akzeptiert. BFL-Leitfaden zur Generierung und zu Fehlern

Der Versuch ist abgeschlossen, wenn Sie die Ausgabe gespeichert und ihre Platzierung, angeforderten Texte sowie die umliegenden Bereiche einer Bearbeitung geprüft haben. Eine Ready-Antwort belegt, dass ein Ergebnis verfügbar ist; durch Ihre Sichtprüfung entscheiden Sie, ob es die Aufgabe erfüllt.

Quellen und weiterführende Informationen

• Produktseite zu FLUX 3 Image: Belegt die Browser- und API-Zugänge sowie den kommerziellen Zugang zu Modellgewichten. Die Demonstrationen stammen vom Anbieter und sind keine Testergebnisse von uns.
• Versionshinweise vom 1. Oktober: Datieren die Veröffentlichung des Bildendpunkts und beschreiben den gemeinsamen Endpunkt. Weitreichende Aussagen zur Steuerung werden zusammen mit den enger gefassten Grenzen in den Tutorials gelesen.
• Endpunktübersicht: Nennt Parameter, Grenzen für Referenzen, Auflösungen und Verhalten der Recherche-Funktion.
• Tutorial zu Begrenzungsboxen: Erläutert die beiden Tabellenstrukturen und das oben angepasste Beispiel mit der laufenden Silhouette.
• Leitfaden zur Bildbearbeitung: Belegt die Umrechnung von Koordinaten, die Reihenfolge von Referenzen und die Einschränkungen bei kleinen Regionen und angrenzenden Bildbereichen.
• Leitfaden zur Generierung: Dokumentiert Authentifizierung, asynchronen Abruf, ablaufende Links und Fehler.
• Preise: Nennt die in unserer Berechnung verwendeten Tarife. Prüfen Sie Preise und Anfrageparameter erneut, bevor Sie einen Versuch bezahlen; die Dokumente werden laufend aktualisiert.