Black Forest Labs
FLUX.2
flux-2/text-to-image
Die Bildgenerierungs- und -bearbeitungsfamilie von Black Forest Labs, unterstützt Stiltransfers auf Basis von Referenzbildern sowie die Fusion mehrerer Referenzbilder; bei der Bearbeitung bleiben die ursprüngliche Komposition und die Position des Motivs möglichst erhalten
flux-2/text-to-image ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
imagePreise
flux-2/text-to-image per image
| Spezifikationen | Einzelpreis |
|---|---|
| 0.5 MP | $0.0375 |
| 1 MP | $0.050 |
| 2 MP | $0.075 |
| 4 MP | $0.125 |
Einordnung und Kurzprofil
FLUX.2 Text-zu-Bild ist der reine Textgenerierungs-Pfad des von Black Forest Labs eingeführten Bildgenerierungsmodells, aufrufbar über die einheitliche Schnittstelle von HiAPI.ai. Es nimmt einen Text-Prompt entgegen, gibt fotorealistische Bilder aus und bietet Parametersteuerung für Auflösung, Seitenverhältnis, Ausgabeformat und -qualität sowie Zufalls-Seed. Geeignet ist es für die kreative Konzepterkundung und die visuelle Massenproduktion, bei der stabile und reproduzierbare Bildergebnisse gefragt sind.
Zentrale Highlights
- Auflösung und Bildformat bedarfsgerecht konfigurierbar – unterstützt Ausgabeauflösungen von 0,5 bis 4 MP sowie zahlreiche gängige Seitenverhältnisse; Breite und Höhe lassen sich auch individuell festlegen, sodass sich Schärfe und Bildkomposition nach Verwendungszweck wählen lassen.
- Reproduzierbare Generierung per Zufalls-Seed – mit einem gesetzten Seed lässt sich dasselbe Ergebnis wiederholen, was Parametervergleiche und Versionsregression auf Basis derselben Komposition erleichtert.
- Steuerbare Ausgabeparameter – wählbar sind die Formate webp, jpg und png sowie eine einstellbare Komprimierungsqualität, sodass direkt verteilbare Bilddateien entstehen.
- Anpassbare Sicherheitstoleranz – safety_tolerance bietet einen Bereich von 1 bis 5, mit dem sich die Strenge der Filterung an die Compliance-Anforderungen des jeweiligen Geschäftsfalls anpassen lässt.
Funktionsbeschreibung
Fotorealistische Bilder aus Text: Mit einem Text-Prompt lassen sich Bilder erzeugen; offizielle und Drittanbieter-Quellen positionieren das Modell vor allem im fotorealistischen Stil, einsetzbar für Konzeptvisualisierungen und die Erstellung von Bildmaterial.
Steuerung von Bildformat und Auflösung: Über aspect_ratio lässt sich ein voreingestelltes Verhältnis wählen oder Breite und Höhe individuell festlegen; zusammen mit dem Auflösungsparameter von 0,5 bis 4 MP passt dies zu Quer- und Hochformat-Kompositionen sowie zu unterschiedlichen Anzeigeplätzen.
Anpassung von Ausgabeformat und Qualität: Unterstützt werden die drei Ausgabeformate webp, jpg und png sowie eine einstellbare Speicherqualität von 0 bis 100, um je nach Verwendungszweck Dateigröße und Bildqualität abzuwägen.
Reproduzierbare Generierung: Nach Festlegung eines Seeds liefert dieselbe Kombination aus Prompt und Parametern ein konsistentes Ergebnis, was die Nachvollziehbarkeit von Änderungen im Iterationsprozess erleichtert.
Anpassbare Sicherheitsfilterung: Der Parameter safety_tolerance bietet fünf Stufen von am strengsten bis am lockersten, einstellbar nach dem Compliance-Maßstab des jeweiligen Einsatzszenarios.
Typische Anwendungsfälle
- Konzeptskizzen für Kreativteams – mit kurzen Prompts schnell mehrere visuelle Entwurfsvarianten erzeugen, um die Richtung zu filtern und intern zu bewerten, bevor die Ausarbeitung festgelegt wird.
- Kompositionserkundung für Design und Werbung – unter Kombination von Seitenverhältnis und Auflösung Quer- und Hochformatbilder erzeugen, die direkt für Angebotsentwürfe und Layout-Vorabtests genutzt werden.
- Workflows zur Massenproduktion von Bildmaterial – mit festem Seed und festgelegten Ausgabeformat-Parametern in automatisierten Prozessen einheitlich spezifizierte Bildassets in großer Zahl erzeugen.
- Fotorealistische visuelle Referenzen – fotorealistische Szenen oder Produktstimmungsbilder erzeugen, die als Referenzmaterial vor Fotografie, Szenenaufbau oder Rendering dienen.
Grenzen und Auswahlhinweise
Dieser Pfad akzeptiert ausschließlich Text-Prompts und verarbeitet keine Referenzbilder; wer auf Basis vorhandener Bilder bearbeiten oder den Stil übertragen möchte, sollte den Bild-zu-Bild-Pfad derselben Modellfamilie verwenden. Die Auflösung reicht bis 4 MP, die Parameterbeschreibung empfiehlt jedoch 2 MP und weniger; bei übergroßen Ausgaben ist der Qualitätsgewinn selbst abzuwägen. Die Sicherheitsfilterung wirkt stufenweise; strengere Stufen können die Sichtbarkeit der generierten Inhalte beeinträchtigen. Die in Forschungsmaterialien erwähnten nicht-kommerziellen Lizenzen und Hardware-Bereitstellungsanforderungen hängen vom tatsächlichen Bezugsweg des Modells ab; beim Aufruf über HiAPI.ai können solche Selbst-Deployment-Einschränkungen ignoriert werden.
Neuigkeiten
Changelog ansehen →- Neues Modell Neues Modell: flux-2-klein-4b/text-to-image, kosteneffiziente Text-zu-Bild-Generierung mit Auflösungsstufen von 0,25–4 MP; mit …
- Neues Modell Neues Bildbearbeitungsmodell: flux-2-klein-4b/image-to-image unterstützt ein einzelnes Referenzbild und 0,25–4 MP Aus…
Häufige Fragen
Alle Fragen ansehen →-
Wie viele Referenzbilder unterstützt die Bildbearbeitung mit FLUX.2?
Unterstützt 1 bis 8 Referenzbilder im Format JPEG, PNG oder WebP, jeweils maximal 10MB. Bei der Komposition mehrerer Bilder sollten die Rollen der einzelnen Bilder im Prompt in der Reihenfolge angegeben werden.
-
Welche Funktion hat das auto-Seitenverhältnis?
auto übernimmt das Seitenverhältnis des ersten Referenzbildes; wenn eine feste Quer-, Hoch- oder quadratische Ausgabe benötigt wird, kann ein explizites Seitenverhältnis gewählt werden.
-
Wie erfolgt die Abrechnung für 1K und 2K?
1K und 2K verwenden unterschiedliche Preisstufen pro Bild; die Anzahl der Referenzbilder wird nicht zusätzlich berechnet. Die konkreten Beträge richten sich nach dem aktuellen Preis auf dieser Seite.
-
Wie lässt sich das Driften von Motiv und Logo reduzieren?
Beschreiben Sie für jedes Referenzbild ausdrücklich den Verwendungszweck und listen Sie gleichzeitig auf, was geändert werden soll und was beim Motiv, beim Text, beim Material, bei der Position und beim Licht erhalten bleiben muss.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: flux-2/text-to-image
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für flux-2/text-to-image und Route default — siehe Parametertabelle unten.
seedintegerOptionalZufälliger Startwert zur Reproduktion der Generierungsergebnisse; bei gleichem Startwert erhält man reproduzierbare Ausgaben.
widthintegerOptionalmin 256max 2048Benutzerdefinierte Bildbreite, wirksam nur wenn aspect_ratio auf custom gesetzt ist; wird automatisch auf das nächste Vielfache von 16 gerundet.
heightintegerOptionalmin 256max 2048Benutzerdefinierte Bildhöhe, wirksam nur wenn aspect_ratio auf custom gesetzt ist; wird automatisch auf das nächste Vielfache von 16 gerundet.
promptstringPflichtText-Prompt für die Bilderzeugung, der den gewünschten Bildinhalt beschreibt.
resolutionstringOptionalStandard: "1 MP"Megapixel-Auflösung (MP) des Ausgabebildes, bis zu 4 MP unterstützt, 2 MP oder weniger empfohlen. Standard: 1 MP.
0.5 MP1 MP2 MP4 MPaspect_ratiostringOptionalStandard: "1:1"Seitenverhältnis des erzeugten Bildes. Standard: 1:1.
1:116:93:22:34:55:49:163:4Alle anzeigen (2)
4:3customoutput_formatstringOptionalStandard: "webp"Speicherformat des Ausgabebildes. Standard: webp.
webpjpgpngoutput_qualityintegerOptionalStandard: 80min 0max 100Speicherqualität des Ausgabebildes, Wertebereich 0 bis 100; unwirksam für das PNG-Format. Standard: 80.
safety_toleranceintegerOptionalStandard: 2min 1max 5Sicherheitstoleranz, 1 ist am strengsten, 5 am lockersten. Standard: 2.
callbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2/text-to-image",
"input": {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "flux-2/text-to-image",
input: {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "flux-2/text-to-image",
"input": {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artikel
Alle Artikel ansehen →-
Tutorial
kandinsky-6.0-pro/image-to-video auf HiAPI: Tutorial mit curl und Python
Eine funktionierende Bild-zu-Video-Anfrage auf HiAPI ausführen: vom Upload des ersten Frames über asynchrones Polling bis zum finalen Download
-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
-
Vergleichstest
hailuo-2.3-fast/image-to-video im Quervergleich: Wie man Bild-zu-Video-Modelle auswählt und worauf bei der Migration zu achten ist
-
Tutorial
So rufen Sie hailuo-2.3-fast/image-to-video über die HiAPI API auf: curl und Python in der Praxis
Die erste lauffähige Anfrage für die schnelle, kostengünstige Bild-zu-Video-Stufe – von der Modell-ID bis zum heruntergeladenen MP4
-
Tutorial
Kandinsky 6.0 Pro Text-zu-Video auf HiAPI: curl- und Python-Tutorial
Eine anfrageorientierte praktische Demonstration: Aufbau des Aufrufs vom Prompt zum Videoclip, Absenden der Anfrage, Abfragen des Fertigstellungsstatus und Herunterladen des Ergebnisses
-
Tutorial
So nutzt du kling-4.0/text-to-video über die HiAPI-API: curl, Python und ein lauffähiges Anforderungsbeispiel
Ein praxisnaher Leitfaden für Entwickler: filmische Prompts, synchrones Audio, asynchrones Polling und Download der Ausgabe
-
Vergleichstest
Recraft v4.1 Flash 文生图横向对比:Entwickler-Auswahl und Migrationsleitfaden
Mit Kosten von $0,01 pro Bild und reiner Text-zu-Bild-Fähigkeit beurteilen, ob es zu Ihrer Bildgenerierungs-Pipeline passt
-
Tutorial
So rufen Sie kling-4.0/image-to-video auf HiAPI auf: curl, Python und Polling
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Nano Banana Google $0.021 /Bild -
Grok Imagine xAI $0.011 /Sekunde -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /Bild -
FASHN Tryon v1.6 FASHN $0.107 /Bild -
Recraft V4.1 Recraft $0.010 /Bild -
Krea 2 Medium Turbo Krea $0.021 /Bild -
Seedream 5.0 ByteDance $0.025 /Bild -
FLUX.1 Fill Pro Black Forest Labs $0.071 /Bild -
851 Labs Background Remover 851 Labs $0.002 /Bild -
Seedream 4.5 ByteDance $0.045 /Bild -
Qwen Image 2.1 Alibaba $0.020 /Bild -
BRIA Eraser Bria $0.058 /Bild
Gleicher Anbieter
-
FLUX.1 Fill Pro Black Forest Labs $0.071 /Bild -
FLUX 3 Video Black Forest Labs $0.090 /Sekunde -
FLUX 3 Image Black Forest Labs $0.041 /Bild -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /Bild -
FLUX.1 Schnell Black Forest Labs $0.005 /Bild -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /Bild -
FLUX.2 Black Forest Labs $0.035 /Bild -
FLUX 1.1 Pro Black Forest Labs $0.050 /Bild -
FLUX.1 Kontext Max Black Forest Labs $0.071 /Bild -
FLUX 3 Max Black Forest Labs $0.061 /Sekunde



