Einführung
FLUX.2 [max] Bearbeitung lässt das FLUX.2-Modell mit der höchsten Qualität von Black Forest Labs auf Fotos laufen, die Sie bereits haben. Es nimmt ein bis drei Quellen und eine Anweisung und liefert ein Bild in der Form der ersten Quelle oder in einem von neun Seitenverhältnissen, in 1k oder 2k.
Den Modus nach dem Ausgangsmaterial wählen
| Was Sie haben | Modus |
|---|---|
| ein geschriebenes Briefing | FLUX.2 Max Text-zu-Bild |
| ein bis drei Fotos zum Ändern oder Kombinieren | FLUX.2 Max Bearbeitung |
Wichtige Funktionen und Highlights
Bis zu drei Referenzen
Kombinieren Sie Menschen und Orte aus getrennten Fotos in einer Anfrage. In unserem Buchhandlungs-Test wurden zwei Porträts und ein Raum zu einer Szene, wobei jedes Gesicht, jede Frisur und jedes Outfit erhalten blieb und das Lampenlicht des Raums auf beiden Frauen lag.
Hintergrund- und Lichtwechsel
Tauschen Sie eine Studiokulisse gegen einen Hafen zur goldenen Stunde und leuchten Sie das Motiv neu aus, bei unverändertem Gesicht, Bart, Ausdruck und unveränderter Kleidung.
Ein Preis pro Bearbeitung
Eine Bearbeitung wird je Bild zu einem einzigen Preis abgerechnet, unabhängig von der Zahl der Quellen oder der Größenstufe. Abgelehnte Anfragen werden nicht berechnet.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis zu 5.000 Zeichen. Sagen Sie, was sich ändern soll und was gleich bleiben muss. mindestens 1 Zeichen · höchstens 5000 Zeichen |
image_urls | Ja | 1 bis 3 Quellbilder, jeweils bis zu 10 MB. Sagen Sie im Prompt, was jedes beisteuert: eine Person, einen Raum, ein Produkt. mindestens 1 Einträge · höchstens 3 Einträge |
aspect_ratio | Nein | auto (Standard) behält die Form des ersten Quellbilds bei etwa einem Megapixel; oder wählen Sie eines von neun Formaten von 21:9 bis 9:21. Das Format ändert den Preis nicht. |
resolution | Nein | 1k (Standard) oder 2k, wird nur verwendet, wenn Sie ein Seitenverhältnis wählen; bei auto bleibt das Ergebnis bei etwa einem Megapixel. |
seed | Nein | Optionale ganze Zahl von 0 bis 2147483647. |
Preis
$0.076 / Bild
Abrechnung je Bild zu einem Preis pro Bearbeitung, unabhängig von der Zahl der Quellbilder und der Größenstufe. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet.
Anwendungsfälle
Produkt- und Ortsfotografie
Neue Hintergründe, neues Licht und stimmige Szenen für Katalog- und Kampagnenbilder.
Alltägliche Porträtretusche
Ändern Sie Umgebung, Licht oder Stil eines alltäglichen Porträts, während die Person erkennbar bleibt.
Gruppenszenen aus getrennten Fotos
Holen Sie Personen aus einzelnen Porträts in einen Raum oder an einen Ort.
Prompt-Leitfaden und Praxistipps
Sagen Sie, was gleich bleibt
Führen Sie nach der Änderung Gesichter, Haare, Kleidung und Pose auf, die sich nicht bewegen dürfen.
Nummerieren Sie Ihre Quellen
Nennen Sie sie image 1, image 2 und image 3 in der Reihenfolge des Hochladens und geben Sie jeder eine Rolle.
Saubere, alltägliche Ausgangsfotos verwenden
Bearbeitungen werden streng gefiltert: In unseren Tests lehnte Max Porträt-Bearbeitungen schon auf der Stufe Mild ab. Produkte, Orte und schlicht gekleidete Porträts sind das sichere Material.
Mit auto den Bildausschnitt behalten
auto behält die Form der ersten Quelle; wählen Sie ein Seitenverhältnis und eine Stufe, wenn Sie einen anderen Ausschnitt oder 2k möchten.
Planen Sie bis zu zwei Minuten ein
Unsere Bearbeitungen dauerten etwa 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-max/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.
