Einführung
FLUX.2 [flex] Bearbeitung lässt FLUX.2 [flex] von Black Forest Labs auf Bildern laufen, die Sie bereits haben. Es nimmt ein bis drei Quellen und eine Anweisung, etwa neues Licht, eine neue Szene oder ergänzte Schrift, und liefert ein 1k-Ergebnis in der Form der Vorlage oder in einem von neun Formaten.
Den Modus nach dem Ausgangsmaterial wählen
| Was Sie haben | Modus |
|---|---|
| ein geschriebenes Briefing | FLUX.2 [flex] Text-zu-Bild |
| Bilder zum Ändern oder Kombinieren | FLUX.2 [flex] Bearbeitung |
Wichtige Funktionen und Highlights
Neues Licht bei erhaltenem Motiv
In unserem Test wurde ein Porträt bei Tag zu einer regnerischen Nacht mit nassen Steinen, Schaufensterlicht und Regentropfen, während die Frau, ihr Mantel und ihre Pose blieben.
Composings mit mehreren Quellen
Nennen Sie jede Quelle per Nummer und sagen Sie, wie sie sich verbinden. In unserem Parfüm-Test wurde eine Flasche aus einem Foto auf einen Marmorsims aus einem anderen gestellt, mit angepasstem Licht und passender Spiegelung.
Text über dem Ergebnis ergänzt
Setzen Sie jede Schlagzeile oder Beschriftung, die hinzukommen soll, in Anführungszeichen. Unser Composing kam mit der Schlagzeile wie geschrieben zurück; ein „No.“ in einem Etikett kann als Numerozeichen zurückkommen.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis zu 5.000 Zeichen. Sagen Sie, was sich ändern soll und was gleich bleiben muss, und nennen Sie jede Quelle nach ihrer Position, etwa image 1 und image 2. mindestens 1 Zeichen · höchstens 5000 Zeichen |
image_urls | Ja | 1 bis 3 Quellbilder, in der Reihenfolge, in der Ihr Prompt sie nennt. Der Preis ist unabhängig von der Zahl der Quellen gleich. mindestens 1 Einträge · höchstens 3 Einträge |
aspect_ratio | Nein | auto (Standard) behält ungefähr Größe und Form der ersten Quelle; oder wählen Sie eines von neun Formaten von 21:9 bis 9:21. Das Format ändert den Preis nicht. |
resolution | Nein | Für die Bearbeitung ist nur 1k verfügbar. Es gilt, wenn Sie ein festes Seitenverhältnis wählen; bei auto folgt das Ergebnis der Größe der ersten Quelle. |
seed | Nein | Optionale ganze Zahl von 0 bis 2147483647. Verwenden Sie sie mit demselben Prompt und denselben Quellen erneut, um Varianten nebeneinander zu vergleichen. |
Preis
$0.115 / Bild
Abrechnung je Bild zu einem festen Preis: Zahl der Quellbilder und Seitenverhältnis ändern ihn nicht. Abgelehnte und fehlgeschlagene Anfragen werden nicht berechnet.
Anwendungsfälle
Produktszenen
Versetzen Sie ein Packshot in eine gestylte Umgebung und ergänzen Sie ein Etikett oder eine Schlagzeile.
Stimmungs- und Wettervarianten
Zeigen Sie einem Kunden, der eine Richtung wählt, ein Porträt bei Dämmerung, im Regen oder unter Neonlicht.
Landschaften und Alltagsbilder
Ändern Sie Tageszeit, Jahreszeit oder Hintergrund einer Landschaft oder Straßenszene.
Prompt-Leitfaden und Praxistipps
Sagen Sie, was bleibt
Führen Sie nach der Änderung Gesicht, Outfit und Pose auf, die gleich bleiben müssen.
Nummerieren Sie Ihre Quellen
Schreiben Sie image 1 und image 2 in den Prompt, damit jede Quelle eine klare Rolle hat.
Bei jugendfreiem Material bleiben
Die Bearbeitung lehnt Porträts schon auf der Stufe Mild deutlich schneller ab als Text-zu-Bild; nutzen Sie sie daher für Produkte, Landschaften und alltägliche Porträts.
Mit auto den Bildausschnitt behalten
Mit auto folgt das Ergebnis der Größe Ihrer ersten Quelle. Wählen Sie nur dann ein festes Format, wenn Sie neu zuschneiden möchten.
Planen Sie ein bis zwei Minuten ein
Bearbeitungen dauerten in unseren Tests 45 bis 120 Sekunden.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-flex/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
