Black Forest Labs

FLUX.2 Klein 9B

flux-2-klein-9b/text-to-image

Bildmodell mit 9 Milliarden Parametern auf Basis von Rectified Flow, durch Schritt-Destillation auf 4 Schritte reduziert, vereint Text-zu-Bild und Bearbeitung mit ein oder mehreren Referenzbildern in einer kompakten Architektur und ist für latenzarme Echtzeit-Generierungsszenarien ausgelegt

flux-2-klein-9b/image-to-image flux-2-klein-9b/text-to-image

flux-2-klein-9b/text-to-image ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

flux-2-klein-9b/text-to-image per image

Einzelpreis	$0.00858

Einordnung und Kurzprofil

Der reine Text-zu-Bild-Pfad von FLUX.2 klein 9B, vorgestellt von Black Forest Labs, zielt auf ein ausgewogenes Verhältnis zwischen Qualität und Latenz. Es erzeugt Bilder direkt anhand von Textaufforderungen, unterstützt die Auswahl von Seitenverhältnissen von 1:1 bis 16:9 sowie die drei Ausgabeformate jpeg, png und webp; die Anzahl der Inferenzschritte kann zwischen 4 und 8 eingestellt werden, wobei mit den standardmäßigen 4 Schritten die Generierung bereits abgeschlossen ist. Geeignet ist es für latenzempfindliche Batch-Produktion von Inhalten, Marketing-Bebilderung und visuelle Exploration in der Prototypenphase; Entwickler können es über die einheitliche Schnittstelle von HiAPI.ai einbinden.

Kernhighlights

Inferenz mit wenigen Schritten für latenzempfindliche Szenarien – Das Schritt-Distillationsdesign ermöglicht die Bilderzeugung in nur 4 Schritten, wobei der Parameter zwischen 4 und 8 Schritten einstellbar ist, um zwischen Geschwindigkeit und Detailtreue abzuwägen.
Fester Seed für reproduzierbare Generierung – Der Seed-Parameter ermöglicht bei gleicher Kombination aus Aufforderung und Seed reproduzierbare Ergebnisse, was Regressionstests und Versionsvergleiche erleichtert.
Ausgabeparameter passend zur Engineering-Pipeline – Die Seitenverhältnisse decken die gängigen Kompositionen 1:1, 4:3, 3:4, 16:9 und 9:16 ab; die Ausgabe kann direkt als jpeg, png oder webp gewählt werden, sodass zusätzliche Transkodierung entfällt.

Funktionsbeschreibung

Text-zu-Bild-Generierung: Übergibt man eine Textaufforderung, erhält man das entsprechende Bild, ohne dass ein Referenzbild erforderlich ist; lediglich prompt muss angegeben werden, alle übrigen Parameter haben Standardwerte, was die Integration kostengünstig macht.

Steuerung von Inferenzschritten und Seed: num_inference_steps kann zwischen 4 und 8 angepasst werden, um die Generierungsfeinheit zu verändern; seed dient zur Fixierung der Zufälligkeit und eignet sich für Evaluierungen und Debugging, die eine stabile Reproduktion erfordern.

Kompositionsverhältnisse und Ausgabeformate: aspect_ratio deckt fünf Verhältnisse in Hoch-, Quer- und quadratischem Format ab; output_format unterstützt jpeg, png und webp, sodass die Generierungsergebnisse direkt den Anforderungen an Seitenplatzierung und Speicherung entsprechen.

Anwendungsszenarien

Batch-Bebilderung durch Content-Teams – Auf Basis von Produkt- oder Themenbeschreibungen werden Bebilderungen im Batch generiert; nach Festlegung von Verhältnis und Ausgabeformat können sie direkt für Artikel, Landingpages und Social-Media-Materialien verwendet werden.
Visuelle Entwurfsexploration für Produktprototypen – Mit kurzen Aufforderungen werden schnell mehrere Kompositionsvarianten erzeugt; zusammen mit einem festen Seed lassen sich Kandidatenstile reproduzieren, um vor dem Design-Review Richtungen zu filtern.
Integration in Anwendungen mit Echtzeit- oder Hochfrequenz-Bilderzeugung – Für latenzempfindliche Online-Funktionen werden Bilder mit den standardmäßigen 4 Inferenzschritten erzeugt; bei Bedarf lässt sich die Schrittanzahl anpassen, um Qualität und Laufzeit zu steuern.

Einschränkungen und Auswahlhinweise

Dieser Pfad erzeugt Bilder ausschließlich aus Text und akzeptiert keine Referenzbilder; wenn eine Bearbeitung oder Stiländerung auf Basis vorhandener Bilder erforderlich ist, sollte der Bild-zu-Bild-Pfad derselben Serie gewählt werden. Die Anzahl der Inferenzschritte unterstützt nur 4 bis 8 Schritte; eine feinere Anpassung durch längeres Sampling ist nicht möglich, und außer prompt gibt es keine Parameter wie Negative Prompts. Die Modellkarte enthält Einschränkungen für die Nutzung außerhalb des vorgesehenen Rahmens; vor kommerzieller Nutzung sollte der Originaltext der Lizenz selbst geprüft werden. Wenn die Aufgabe Ausgaben anderer Modalitäten wie Video oder Audio erfordert, ist dieses Modell nicht geeignet.

Häufige Fragen

Alle Fragen ansehen →

Wie viele Referenzbilder unterstützt die Bildbearbeitung mit FLUX.2 [klein] 9B?

Derzeit wird 1 Referenzbild im Format JPEG, PNG oder WebP unterstützt. image_urls muss ein Array sein, das genau eine öffentliche Bild-URL enthält.
Für welche Bearbeitungsaufgaben ist es geeignet?

Geeignet für die Bereinigung von Produktbildern, den Austausch von Hintergründen, das Umschreiben von Bildtexten, die Änderung von Farbgebungen sowie kommerzielle Retuschen, bei denen das Motiv und der Kamerawinkel erhalten bleiben müssen.
Wie werden die Inferenzschritte festgelegt?

num_inference_steps unterstützt ganze Zahlen von 4 bis 8, Standard ist 4. Der aktuelle Preis ändert sich nicht mit der Anzahl der Inferenzschritte.
Welche Seitenverhältnisse und Formate werden unterstützt?

Die Seitenverhältnisse 1:1, 4:3, 3:4, 16:9 und 9:16 werden unterstützt; die Formate JPEG, PNG und WebP werden unterstützt.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der 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-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

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

modelstringPflicht

Aktueller Festwert: flux-2-klein-9b/text-to-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für flux-2-klein-9b/text-to-image und Route default — siehe Parametertabelle unten.

seedintegerOptional

Zufälliger Startwert für die Reproduzierbarkeit der Ergebnisse; als Ganzzahl angegeben.

promptstringPflicht

Text-Prompt für die Bilderzeugung; als Zeichenkette angegeben.

aspect_ratiostringOptionalStandard: "4:3"

Seitenverhältnis des erzeugten Bildes; als Zeichenkette angegeben. Standard: 4:3.

Optionen:1:14:33:416:99:16

output_formatstringOptionalStandard: "png"

Ausgabeformat des erzeugten Bildes; als Zeichenkette angegeben. Standard: png.

Optionen:jpegpngwebp

num_inference_stepsintegerOptionalStandard: 4min 4max 8

Anzahl der Inferenzschritte; als Ganzzahl zwischen 4 und 8 angegeben. Standard: 4.

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

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.

urlstringPflicht

Pflicht, 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.

Optionen:final

storagestringOptionalStandard: "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.

Optionen:temppersistent

Anfragebeispiele

# 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-klein-9b/text-to-image",
  "input": {
    "prompt": "…",
    "aspect_ratio": "4:3",
    "output_format": "png",
    "num_inference_steps": 4
  }
}'

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-klein-9b/text-to-image",
    input: {
      "prompt": "…",
      "aspect_ratio": "4:3",
      "output_format": "png",
      "num_inference_steps": 4
    }
  }),
});
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-klein-9b/text-to-image",
        "input": {
          "prompt": "…",
          "aspect_ratio": "4:3",
          "output_format": "png",
          "num_inference_steps": 4
        }
    },
)
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

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelö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.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

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.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-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

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

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"
    }
  }
}