Einführung
FLUX.2 [pro] Text-zu-Bild ist das Produktionsmodell von Black Forest Labs aus der FLUX.2-Generation, erschienen am 25. November 2025. Es macht aus einem geschriebenen Prompt ein fotografisches Bild in 1k oder 2k und neun Seitenverhältnissen, mit Text, der im Bild korrekt lesbar ist, und Farben, die Sie per Hex-Code festlegen.
Den Modus nach dem Ausgangsmaterial wählen
| Was Sie haben | Modus |
|---|---|
| ein geschriebenes Briefing | FLUX.2 [pro] Text-zu-Bild |
| ein bis drei Bilder zum Ändern oder Kombinieren | FLUX.2 [pro] Bearbeitung |
Wichtige Funktionen und Highlights
Lesbarer Text im Bild
Setzen Sie die Wörter in Anführungszeichen und geben Sie an, wo sie stehen. In unserem Poster-Test kamen eine Serifen-Schlagzeile und eine kleine Zeile in Groteskschrift beide genau wie geschrieben zurück.
Farbkontrolle per Hex-Code
Schreiben Sie Farben als Hex-Codes, und die Palette folgt. Unser Poster nutzte einen Petrol- und einen Kupferton, und Meer und Horizontband nahmen sie an.
Dokumentarischer Realismus
Hauttextur, Fensterlicht und Filmkorn wirken wie Fotografien. Unser Balkonporträt behielt Sommersprossen und feine Linien bei 2k.
Moderiert, mit Grenzen
Die Stufe Mild wird gerendert. In unseren Tests wurde die Stufe Mittel in manchen Läufen gerendert und kam in anderen abgeschwächt zurück, Anfragen der Stufe Stark kamen abgeschwächt zurück, und die Stufe Sehr stark wurde ohne Berechnung abgelehnt.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Erforderlich, bis zu 5.000 Zeichen. Beschreiben Sie Motiv, Kleidung, Umgebung, Licht und Objektiv in einfachen Sätzen. mindestens 1 Zeichen · höchstens 5000 Zeichen |
aspect_ratio | Nein | Eines von neun Formaten: 1:1 (Standard), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21. Das Format ändert den Preis nicht. |
resolution | Nein | 1k (Standard) entspricht etwa einem Megapixel; 2k sind 2048 Pixel an der langen Seite. Die Größenstufe beeinflusst den Preis. |
seed | Nein | Optionale ganze Zahl von 0 bis 2147483647. |
Preis
Abrechnung je Bild nach Größenstufe; das Seitenverhältnis ändert den Preis nicht. Abgelehnte und fehlgeschlagene Anfragen werden nicht berechnet.
| Spezifikation | Preis |
|---|---|
| $0.03 / Bild |
| $0.0391 / Bild |
Anwendungsfälle
Poster und Kampagnenentwürfe
Eine Schlagzeile, ein Claim und ein Foto in einem Bild, für Konzepte zu Duft, Mode oder Produkten.
Paar- und Figurenporträts
Zwei Menschen mit unterschiedlichen Haaren, Kleidung und Stimmung in einer unverstellten Szene, für Geschichten, Moodboards und Figurenblätter.
Social-Motive in jedem Format
Quadratische, hochformatige, breite und ultrabreite Bilder aus demselben Prompt, indem Sie das Format ändern.
Prompt-Leitfaden und Praxistipps
Schreiben Sie ganze Sätze
Motiv, Kleidung, Umgebung, Licht und Objektiv in Sätzen funktionieren besser als eine Liste von Schlüsselwörtern.
Text in Anführungszeichen setzen und den Stil benennen
Setzen Sie jede Zeile in Anführungszeichen und beschreiben Sie die Schrift, zum Beispiel eine weit gesperrte Serifen-Schlagzeile oben.
Die Palette festlegen
Geben Sie Hex-Codes für die zwei oder drei Farben an, auf die es ankommt, und sagen Sie, wo sie erscheinen.
Entwürfe in 1k
Testen Sie eine Komposition in 1k und rendern Sie den Favoriten dann in 2k. Die Größenstufe beeinflusst den Preis.
Mit einem Seed vergleichen
Halten Sie den Seed fest, während Sie eine Formulierung ändern, damit Unterschiede von Ihrem Wortlaut kommen.
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-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# 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.
























