AI-translated from English; not yet reviewed by a fluent editor.

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

> Mit Layout-Boxen und Referenzbildern von FLUX 3 Image lassen sich Bildkompositionen planen oder gezielte Änderungen vornehmen. Ein dokumentationsbasierter Leitfaden zu Koordinaten, Abruf, Preisen und Grenzen.

By BIG CHANGE Editorial

Published: 2026-10-03T04:10:59.237Z
Updated: 2026-10-03T04:10:59.237Z
Canonical: https://bigchange.ai/blog/flux-3-image-layout-editing-guide

![Conceptual charcoal illustration of one right hand placing a flat runner cutout on an orange square art backing.](https://bigchange.ai/api/media/file/flux-layout-collage-hero-v1.png)
AI-generated conceptual editorial illustration by BIG CHANGE.

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](https://docs.bfl.ai/release-notes).

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](https://docs.bfl.ai/release-notes)
- **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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)
- **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](https://docs.bfl.ai/quick_start/pricing), [Bearbeitungsgrenzen](https://docs.bfl.ai/flux_3/flux3_image_layout)

## Wählen Sie den Browser- oder API-Weg

BFLs [Produktseite](https://bfl.ai/models/flux-3-image) beschreibt zwei Einstiegsmöglichkeiten: Zeichnen Sie Boxen im browserbasierten Playground oder senden Sie einen Layout-Prompt über die API. In der [Dokumentation zum Playground](https://playground.bfl.ai) 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](https://dashboard.bfl.ai) 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](https://docs.bfl.ai/flux_3/flux3_image_generate), [Preise und Einrichtung](https://docs.bfl.ai/quick_start/pricing)

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](https://bfl.ai/models/flux-3-image)

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

| Aufgabe | Dokumentierte Eingabe | Zu verwendende Steuerung |
| --- | --- | --- |
| Eine neue Komposition erzeugen | Ein Szenenprompt, optional ergänzt um eine Elementtabelle | `bbox` für jedes Element, dessen Platzierung wichtig ist |
| Ein erkennbares Detail ändern | Eine Anweisung und ein Referenzbild | Eine genaue Beschreibung kann genügen; prüfen Sie den erweiterten Prompt |
| Genau festlegen, welche Elemente geändert werden | Eine Anweisung, ein Referenzbild und eine Bearbeitungstabelle | Ausgangs- und Zielboxen sowie „Beibehalten“-Zeilen für Elemente, die erhalten bleiben sollen |
| Referenzen kombinieren | Ein Prompt, der ihre jeweilige Rolle erläutert, und 2 bis 10 Bilder | Angeben, welches Bild das jeweilige Motiv, Objekt oder die Umgebung liefert |

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](https://docs.bfl.ai/flux_3/flux3_image_layout)

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](https://docs.bfl.ai/flux_3/flux3_image_overview)

## 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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#format)

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:

| Kante | Pixelposition | Berechnung | Rasterwert |
| --- | --- | --- | --- |
| Oben | 108 | 108 ÷ 1080 × 1000 | 100 |
| Links | 384 | 384 ÷ 1920 × 1000 | 200 |
| Unten | 972 | 972 ÷ 1080 × 1000 | 900 |
| Rechts | 1536 | 1536 ÷ 1920 × 1000 | 800 |

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](https://docs.bfl.ai/flux_3/flux3_image_layout#send-a-request)

## 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:

```json
{
  "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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)

## Ein vorhandenes Bild bearbeiten

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

| Vorgang | `from` | `src_bbox` | `tgt_bbox` |
| --- | --- | --- | --- |
| Ein Element beibehalten | `"ref_image_0"` | Seine Ausgangsbox | Dieselbe Box |
| Es verschieben oder skalieren | `"ref_image_0"` | Seine Ausgangsbox | Eine andere Zielbox |
| Hinzufügen, ersetzen oder umfärben | `null` | `null` | Die gewünschte Ausgabebox |
| Es entfernen | `"ref_image_0"` | Seine Ausgangsbox | `null` |

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](https://docs.bfl.ai/flux_3/flux3_image_layout), [Schema für Bearbeitungszeilen](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#edit-an-image-box-by-box)

## 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](https://docs.bfl.ai/flux_3/flux3_image_overview)

| Auflösung | Dokumentierte Bildgröße | Preis pro Bild | Kosten für zehn Anfragen (berechnet) |
| --- | --- | --- | --- |
| `768sq` | 768 × 768 | $0.041 | $0.41 |
| `1k` | Rund 1 Megapixel | $0.048 | $0.48 |
| `2k` | Rund 4 Megapixel | $0.100 | $1.00 |
| `4k` | Rund 16 Megapixel | $0.607 | $6.07 |

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](https://docs.bfl.ai/quick_start/pricing)

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](https://docs.bfl.ai/flux_3/flux3_image_overview#ground-the-prompt)

## 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](https://docs.bfl.ai/flux_3/flux3_image_generate#results-and-errors)

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](https://docs.bfl.ai/flux_3/flux3_image_generate)

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](https://bfl.ai/models/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](https://docs.bfl.ai/release-notes): 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](https://docs.bfl.ai/flux_3/flux3_image_overview): Nennt Parameter, Grenzen für Referenzen, Auflösungen und Verhalten der Recherche-Funktion.
- [Tutorial zu Begrenzungsboxen](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes): Erläutert die beiden Tabellenstrukturen und das oben angepasste Beispiel mit der laufenden Silhouette.
- [Leitfaden zur Bildbearbeitung](https://docs.bfl.ai/flux_3/flux3_image_layout): Belegt die Umrechnung von Koordinaten, die Reihenfolge von Referenzen und die Einschränkungen bei kleinen Regionen und angrenzenden Bildbereichen.
- [Leitfaden zur Generierung](https://docs.bfl.ai/flux_3/flux3_image_generate): Dokumentiert Authentifizierung, asynchronen Abruf, ablaufende Links und Fehler.
- [Preise](https://docs.bfl.ai/quick_start/pricing): Nennt die in unserer Berechnung verwendeten Tarife. Prüfen Sie Preise und Anfrageparameter erneut, bevor Sie einen Versuch bezahlen; die Dokumente werden laufend aktualisiert.

## Sources

- [FLUX 3 Image](https://bfl.ai/models/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 BIG CHANGE. Die geprüften Quellen belegen nicht, dass dieser Image-Endpunkt als Download mit offenen Gewichten verfügbar ist.
- [FLUX 3 Image overview](https://docs.bfl.ai/flux_3/flux3_image_overview) — Nennt Parameter, Grenzen für Referenzen, Auflösungen und Verhalten der Recherche-Funktion.
- [FLUX 3 Image layout and editing](https://docs.bfl.ai/flux_3/flux3_image_layout) — Belegt die Umrechnung von Koordinaten, die Reihenfolge von Referenzen und die Einschränkungen bei kleinen Regionen und angrenzenden Bildbereichen.
- [FLUX 3 Image generation](https://docs.bfl.ai/flux_3/flux3_image_generate) — Dokumentiert Authentifizierung, asynchronen Abruf, ablaufende Links und Fehler.
- [Release notes](https://docs.bfl.ai/release-notes) — 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.
- [Pricing](https://docs.bfl.ai/quick_start/pricing) — Nennt die Tarife, die in unserer Berechnung verwendet werden. Prüfen Sie Preise und Anfrageparameter erneut, bevor Sie einen Versuch bezahlen; dies sind aktuelle Dokumente.
- [FLUX 3 Image bounding boxes](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes) — Erläutert die beiden Tabellenstrukturen und das oben angepasste Beispiel mit der laufenden Silhouette.