Black Forest Labs
FLUX 3 Image Klein
flux-3-image-klein
flux-3-image-klein ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
imagePreise
flux-3-image-klein per image
| Spezifikationen | Einzelpreis |
|---|---|
| 768 | $0.0092 |
| 1K | $0.0103 |
| 1.5K | $0.0126 |
| 2K | $0.016 |
| 4K | $0.0412 |
Kurzbeschreibung der Positionierung
Dies ist ein Modell für Bildgenerierungs- und Bildbearbeitungsszenarien, das Bilder allein anhand eines Prompts erzeugen kann und bei Vorlage von Referenzbildern auch Bilder gemäß Anweisungen ändern oder zusammensetzen kann. Die Eingabe kann bis zu 10 Referenzbilder enthalten, und Layout sowie Teilbereiche lassen sich mit Tags zusammen mit Begrenzungsrahmen beschreiben. Die Ausgabe ist ein statisches Bild, wahlweise in Auflösungsstufen von 768 bis 4K und in verschiedenen Quer- und Hochformaten. Geeignet für Entwickler und Designteams, die visuelle Materialien in großen Mengen erzeugen, den Stil von Referenzbildern fortführen oder das Layout kontrollieren möchten.
Kernhighlights
- Text-zu-Bild und Bearbeitung mit Referenzbildern vereint – dasselbe Modell akzeptiert sowohl reine Prompt-Generierung als auch Referenzbilder mit Anweisungen zur Änderung und Zusammensetzung.
- Kombination von bis zu zehn Referenzbildern – pro Anfrage können mehrere Referenzbilder übergeben werden, für die Zusammensetzung mehrerer Bilder oder um verschiedenen Bildern die Rollen von Motiv und Stil zuzuweisen.
- Ausgabestufen bis 4K – die Auflösung ist wahlweise unter 768, 1K, 1,5K, 2K und 4K einstellbar, Breite und Höhe variieren je nach gewähltem Seitenverhältnis.
- Layoutsteuerung per Begrenzungsrahmen – im Prompt lassen sich mit Tags zusammen mit Begrenzungsrahmen-JSON die Position von Elementen festlegen und Teilbereiche bearbeiten.
Funktionsbeschreibung
Bildgenerierung allein per Prompt: Es genügt die Angabe eines Prompts, um ein Bild zu erzeugen; der Prompt umfasst bis zu 5000 Zeichen. Ohne Referenzbild liegt der Text-zu-Bild-Modus vor, der sich zum Aufbau eines Bildes von Grund auf eignet.
Anweisungsbasierte Bearbeitung mit Referenzbildern: Übergibt man Referenzbilder und beschreibt im Prompt, was geändert und was beibehalten werden soll, lassen sich gezielte Anpassungen am Bild vornehmen; bis zu 10 Referenzbilder sind möglich.
Mehrere Referenzbilder und Layoutsteuerung: Mehrere Referenzbilder können jeweils die Rolle von Motiv, Stil oder Bildkomposition übernehmen; mit Tags und Begrenzungsrahmen-JSON lässt sich die Platzierung von Elementen festlegen, was die Organisation komplexer Bildinhalte erleichtert.
Wahl von Seitenverhältnis und Format: Das Seitenverhältnis ist in mehreren Quer- und Hochformaten von 21:9 bis 9:21 oder im Automatikmodus wählbar; das Ausgabeformat ist jpeg oder png.
Einstellbare Schritte und Zufalls-Seed: Die Diffusionsschritte sind von 1 bis 16 einstellbar; bei weniger Schritten ist die Generierung schneller, aber das Detail kann abnehmen. Mit einem Seed von 0 bis 4294967295 lassen sich Ergebnisse mit gleichen Parametern weitestgehend reproduzieren.
Anwendungsszenarien
- Bildretusche für E-Commerce und Marketingmaterialien – Mitarbeiter im Betrieb laden Produktreferenzbilder hoch und fügen Änderungsanweisungen hinzu, um angepasste Hauptbilder oder Varianten für Produktdetailseiten und Aktionsflächen zu erhalten.
- Stilzusammensetzung aus mehreren Referenzbildern – Designer übergeben Motivbild und Stilreferenz und setzen daraus einen visuellen Entwurf mit einheitlicher Tonalität zusammen, für Markenwerbebilder und Social-Media-Grafiken.
- Poster-Generierung mit Layoutsteuerung – Marketingteams beschreiben mit Prompt und Begrenzungsrahmen die Position von Überschrift und Elementen und erzeugen Quer- oder Hochformat-Werbegrafiken für Ausspielung und Druckvorschau.
- Erzeugung hochauflösender Fertigbilder – Content-Teams wählen die 2K- oder 4K-Stufe, um Fertigbilder für Präsentationsseiten und Materialausgaben mit höheren Pixelmaßen zu erzeugen.
- Batch-Validierung von Bildprototypen – Entwickler erzeugen mit festem Seed und wenigen Schritten schnell mehrere Entwürfe zur Auswahl kreativer Richtungen und zum frühen Vergleich von Varianten.
Einschränkungen und Auswahlhinweise
Der Eingabe-Prompt muss 1 bis 5000 Zeichen umfassen, Referenzbilder müssen erreichbare http- oder https-Bildlinks sein, maximal 10 Stück. Auflösung, Seitenverhältnis und Ausgabeformat sind pro Anfrage jeweils als eine Option festzulegen. Die Obergrenze der Diffusionsschritte beträgt 16; bei weniger Schritten kann das Detail abnehmen. Die Auflösungsstufen beschreiben die Ausgabepixelstufe, die konkreten Breiten- und Höhenmaße variieren je nach Seitenverhältnis. Der Seed dient nur dazu, Ergebnisse mit gleichen Parametern weitestgehend zu reproduzieren, eine vollständige Übereinstimmung ist nicht garantiert; die Toleranz der Inhaltssicherheit liegt zwischen 0 und 4, wobei 0 am strengsten ist.
Neuigkeiten
Changelog ansehen →- Neues Modell Neues Modell verfügbar: FLUX 3 Image Klein
Häufige Fragen
Alle Fragen ansehen →-
Warum sind die erzeugten Bilder bei kurzen Prompts so vage?
Bei kurzen Prompts sind zu wenige Informationen vorhanden, sodass das Modell nur auf Basis gängiger Interpretationen ergänzt und das Ergebnis daher oft vage bleibt. Schreibt man den Prompt als vollständige Beschreibung, wird das Ergebnis deutlich stabiler: ① Motiv und Details zum Aussehen ② Szene und Umgebung ③ Licht und Farbton ④ Bildaufbau und Perspektive ⑤ Stil und Anforderungen an die Bildqualität. Der Prompt kann bis zu 5000 Zeichen lang sein, genug, um jeden Punkt ausführlich zu beschreiben.
-
Wie wechselt man zwischen Text-zu-Bild und Bildbearbeitung?
Dasselbe Modell, zwei Verwendungsweisen – der Unterschied liegt nur darin, ob ein Referenzbild übergeben wird. Lässt man image_urls weg, erzeugt man ein Bild aus Text und generiert ausschließlich nach dem Prompt; übergibt man image_urls, wechselt man zur instruktionsbasierten Bearbeitung, und der Prompt muss klar angeben, welche Teile des Referenzbilds geändert und welche beibehalten werden sollen. Bei der Bearbeitung empfiehlt es sich, die zu ändernden Stellen und die gewünschten Effekte einzeln aufzulisten, statt nur einen Satz zum Gesamtstil zu schreiben.
-
Wie viele Referenzbilder können maximal verwendet werden?
image_urls erlaubt maximal 10 und mindestens 1 Bild. Sobald Referenzbilder übergeben werden, wird der Bearbeitungs- oder Mehrfachreferenz-Kompositionsmodus aktiviert. Für jedes Bild muss im Prompt seine Rolle beschrieben werden, zum Beispiel ist das erste Bild die Person, das zweite das Produkt und das dritte der Hintergrundstil. Diese Obergrenze eignet sich für Kompositionsszenarien, die Charakter- oder Produktkonsistenz über mehrere Bilder hinweg erfordern.
-
Wie steuere ich das Layout?
Verwende die Tags im Prompt zusammen mit bbox-JSON, um die Position der Elemente festzulegen. Schreibe im Prompt Platzhalter der Form <Tag> und füge das entsprechende Begrenzungsrahmen-JSON hinzu, um anzugeben, in welchem Bereich die einzelnen Elemente platziert werden, und schreibe dann die konkrete Beschreibung in den Inhalt, der zum jeweiligen Tag gehört. Geeignet für Bilder wie Poster oder Banner, bei denen die Layoutpositionen fest vorgegeben sein müssen.
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-3-image-klein
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für flux-3-image-klein und Route default — siehe Parametertabelle unten.
seedintegerOptionalmin 0max 4294967295Zufälliger Startwert, um bei gleichen Parametern möglichst identische Ergebnisse zu reproduzieren; ganzzahlig, wird bei Weglassen zufällig generiert.
stepsintegerOptionalStandard: 16min 1max 16Anzahl der Diffusionsschritte, Wertebereich 1–16, Standard 16; je niedriger der Wert, desto schneller die Generierung, Details können abnehmen, der Preis bleibt unverändert.
promptstringPflichtminLength 1maxLength 5000Beschreibt das gewünschte Bild oder legt fest, welche Inhalte im Referenzbild geändert und welche beibehalten werden sollen; kann zusammen mit <Tags> und bbox-JSON zur Festlegung von Layout und lokalen Bearbeitungsbereichen verwendet werden.
image_urlsarrayOptionalminItems 1maxItems 10Array mit Referenzbildern, dessen Elemente Bildadressen sind; im Prompt muss für jedes Bild die Rolle von Motiv, Stil oder Komposition erläutert werden, bei Weglassen handelt es sich um Text-zu-Bild.
Array [ string ]
resolutionstringOptionalStandard: "1K"Ausgabepixelstufe, die konkreten Breiten- und Höhenwerte variieren je nach Seitenverhältnis; Standard 1K.
7681K1.5K2K4Kaspect_ratiostringOptionalStandard: "auto"Ausgabe-Seitenverhältnis, wählbar als Querformat, Hochformat oder Quadrat; Standard auto, im automatischen Modus wird das Seitenverhältnis anhand von Prompt und Referenzbild bestimmt.
21:92:116:93:27:54:35:41:1Alle anzeigen (8)Weniger anzeigen
4:53:45:72:39:161:29:21autooutput_formatstringOptionalStandard: "jpeg"Ausgabebildformat, Standard jpeg.
jpegpngsafety_toleranceintegerOptionalStandard: 2min 0max 4Toleranz für Inhaltssicherheit, ganzzahlig, 0 ist am strengsten; 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-3-image-klein",
"input": {
"steps": 16,
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "jpeg",
"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-3-image-klein",
input: {
"steps": 16,
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "jpeg",
"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-3-image-klein",
"input": {
"steps": 16,
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "jpeg",
"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 →Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Grok Imagine Quality xAI $0.070 /Bild -
Nano Banana Pro Google $0.029 /Bild -
Nano Banana Google $0.011 /Bild -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /Bild -
GPT Image 2.6 OpenAI $0.023 /Bild -
Krea 3 Krea $0.036 /Bild -
GPT Image 2.5 OpenAI $0.017 /Bild -
Seedream 5.5 ByteDance $0.019 /Bild -
Recraft V4.1 Recraft $0.010 /Bild -
FLUX.1 Schnell Black Forest Labs $0.005 /Bild -
Ideogram V3 Character Ideogram $0.090 /Bild -
GPT Image 2 OpenAI $0.007 /Bild
Gleicher Anbieter
-
FLUX.2 Klein 9B Black Forest Labs $0.0086 /Bild -
FLUX.2 Black Forest Labs $0.035 /Bild -
FLUX 3 Image Black Forest Labs $0.041 /Bild -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /Bild -
FLUX 1.1 Pro Black Forest Labs $0.050 /Bild -
FLUX 3 Video Black Forest Labs $0.090 /Sekunde -
FLUX 3 Max Black Forest Labs $0.121 /Sekunde -
FLUX.1 Schnell Black Forest Labs $0.005 /Bild -
FLUX.1 Kontext Max Black Forest Labs $0.071 /Bild -
FLUX.1 Fill Pro Black Forest Labs $0.071 /Bild


