Black Forest Labs

FLUX.2 Klein 9B

flux-2-klein-9b/image-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/image-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/image-to-image per image

Einzelpreis	$0.03143

Positionierung und Kurzprofil

Ein Bildbearbeitungsmodell auf Basis der FLUX.2 klein 9B-Architektur, das über die einheitliche Schnittstelle von HiAPI.ai aufgerufen wird. Es nimmt ein Referenzbild und eine Bearbeitungsanweisung entgegen, passt Inhalt und Stil des Originalbildes gemäß der Beschreibung an und unterstützt die Angabe von Ausgabeseitenverhältnis und -format. Es eignet sich für Entwickler, die schnelle Iterationen per Bild-zu-Bild und Bearbeitungsergebnisse mit geringer Latenz anstreben, etwa für Prototyping und die Neugestaltung von Inhalten.

Hauptmerkmale

Anweisungsbasierte Bearbeitung mit einem einzigen Referenzbild – Laden Sie einfach ein Referenzbild hoch und geben Sie eine Bearbeitungsbeschreibung an; das Modell ändert das Bild gemäß der Anweisung, ohne dass zusätzliche Masken oder aufwendige Vorverarbeitung nötig sind.
Wenige Inferenzschritte von 4 bis 8 – Dank Schritt-Distillation lässt sich die Anzahl der Inferenzschritte zwischen 4 und 8 einstellen, wodurch sich Qualität und Latenz flexibel abwägen lassen.
Ausgabeseitenverhältnis und -format frei wählbar – Unterstützt die fünf Seitenverhältnisse 1:1, 4:3, 3:4, 16:9 und 9:16 sowie die drei Ausgabeformate jpeg, png und webp, sodass sich die Ausgabe direkt in nachgelagerte Prozesse einbinden lässt.

Funktionsbeschreibung

Anweisungsbasierte Bearbeitung anhand eines Referenzbildes: Geben Sie ein Bild im Format jpeg/png/webp sowie eine textliche Bearbeitungsbeschreibung ein; das Modell erzeugt daraufhin das geänderte Bild. Ideal, um Bearbeitungsideen schnell zu prüfen.

Einstellbare Inferenzschritte: num_inference_steps akzeptiert ganze Zahlen von 4 bis 8. Mehr Schritte liefern mehr Details, weniger Schritte reagieren schneller – je nach Anwendungsfall abwägbar.

Kontrollierte Ausgabespezifikationen: Seitenverhältnis und Dateiformat des erzeugten Bildes lassen sich vorgeben, wodurch nachgelagerte Zuschnitt- und Transkodierschritte entfallen und das Ergebnis direkt zur Anzeige oder Speicherung genutzt werden kann.

Reproduzierbare Generierung: Über den Parameter seed lässt sich der Zufallsstartwert fixieren, um bei Debugging und Vergleichen dasselbe Bearbeitungsergebnis zu reproduzieren.

Anwendungsfälle

Designer iterieren schnell über visuelle Konzepte – Laden Sie ein Stilreferenzbild hoch und beschreiben Sie die gewünschte Anpassungsrichtung in Text, um mehrere bearbeitete Versionen zu erzeugen, die zur Konzeptauswahl und Kundenkommunikation dienen.
Content-Ersteller gestalten Bilder neu – Geben Sie auf Basis vorhandener Materialbilder Bearbeitungsanweisungen ein und erzeugen Sie stilisierte oder inhaltlich angepasste Bilder für Social Media und Artikelillustrationen.
Validierung der Bild-zu-Bild-Kette in der Entwicklungsintegration – Mit festem seed und wenigen Inferenzschritten lassen sich schnell Bilder erzeugen, um Schnittstellenparameter und nachgelagerte Pipelines zu prüfen; die Ergebnisse dienen Integrationstests.

Einschränkungen und Auswahlhinweise

Es wird nur ein einzelnes Referenzbild als Eingabe unterstützt, und das Eingabebild wird auf 1 MP skaliert, wodurch die Detailtreue bei hoher Auflösung begrenzt ist; das Format svg wird nicht unterstützt. Die Obergrenze der Inferenzschritte liegt bei 8, was für Anforderungen an besonders hohe Qualität oder feine Kontrolle möglicherweise nicht ausreicht. Das Modell konzentriert sich auf die Bildbearbeitung und deckt keine Modalitäten wie Video oder Audio ab. Wenn Sie reine Text-zu-Bild-Generierung oder Ausgaben mit höherer Auflösung benötigen, sollten Sie andere Varianten derselben Serie oder Modelle mit entsprechenden Fähigkeiten in Betracht ziehen.

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/image-to-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

seedintegerOptional

Zufälliger Startwert zur Reproduktion der Generierungsergebnisse; als Ganzzahl eingeben, bei gleichem Startwert werden konsistente Ausgaben erzielt.

promptstringPflicht

Prompt, der in Textform beschreibt, welche Bearbeitung am Referenzbild durchgeführt werden soll.

image_urlsarrayPflichtminItems 1maxItems 1

Array von Referenzbildern, nur ein Bild erforderlich; unterstützt die Formate jpeg, png und webp, svg wird nicht unterstützt, Eingabebilder werden auf 1 MP skaliert.

Array [ string ]

aspect_ratiostringOptionalStandard: "1:1"

Seitenverhältnis des generierten Bildes als Zeichenkette; Standard ist 1:1.

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

output_formatstringOptionalStandard: "png"

Ausgabeformat des generierten Bildes als Zeichenkette; Standard ist png.

Optionen:jpegpngwebp

num_inference_stepsintegerOptionalStandard: 4min 4max 8

Anzahl der Inferenzschritte als Ganzzahl zwischen 4 und 8; Standard ist 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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "aspect_ratio": "1:1",
    "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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "aspect_ratio": "1:1",
      "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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "aspect_ratio": "1:1",
          "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"
    }
  }
}