Black Forest Labs

FLUX.2

flux-2/image-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/image-to-image flux-2/text-to-image

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

Spezifikationen	Einzelpreis
1K	$0.035
2K	$0.050

Positionsübersicht

FLUX.2-Bildbearbeitungslinie: Sie erhält 1 bis 8 Referenzbilder sowie eine Bearbeitungsanweisung und führt Stilaustausch und Detailanpassungen durch, wobei Bildkomposition und Position des Hauptmotivs möglichst erhalten bleiben. Geeignet für Entwickler, die vorhandenes Material in neue Visualisierungen umwandeln möchten, etwa für Stiltransfer, die Fusion mehrerer Bilder und die Iteration kreativer Prototypen. Der Aufruf erfolgt über die einheitliche Schnittstelle von HiAPI.ai; als Ausgabauflösung stehen 1K oder 2K zur Wahl, und das Seitenverhältnis unterstützt gängige Formate sowie den Modus auto, der dem ersten Bild folgt.

Kernhighlights

Beim Bearbeiten bleiben Komposition und Position des Hauptmotivs vorrangig erhalten – Stil und Details werden gemäß Anweisung geändert, statt ein fremdes Bild neu zu erzeugen, was den späteren Ausrichtungsaufwand reduziert.
Pro Durchlauf lassen sich 1 bis 8 Referenzbilder verketten – im Prompt können die Bilder der Reihe nach referenziert werden, um Material auszutauschen und Elemente mehrerer Bilder zu verschmelzen.
Ausgabeformat und -auflösung sind steuerbar – 1K oder 2K sowie verschiedene Seitenverhältnisse lassen sich festlegen; im Modus auto wird die Komposition des ersten Eingabebilds direkt übernommen.

Funktionsbeschreibung

Anweisungsgesteuerte Bildbearbeitung: Übergibt man ein Referenzbild und eine Bearbeitungsanweisung, erhält man das geänderte Bild – geeignet für gezielte Anpassungen an vorhandenem Material statt für die Generierung von Grund auf.

Referenzierung mehrerer Bilder und Kombination von Elementen: Bis zu 8 Eingabebilder; im Prompt lassen sich die Bilder über ihre Nummer referenzieren, sodass sich Elemente eines Bildes in die Szene eines anderen Bildes einfügen lassen.

Übernahme von Komposition und Seitenverhältnis: Ist das Seitenverhältnis auf auto gesetzt, wird das erste Eingabebild übernommen; Inhalte ändern sich, während das ursprüngliche Layout erhalten bleibt – praktisch für das batchweise Ersetzen von Material gleicher Größe.

Wählbare Ausgabeauflösung: Es werden die beiden Ausgabestufen 1K und 2K unterstützt, wählbar je nach Anforderung der Enddarstellung – für Vorschau- wie für Fertigungszwecke.

Anwendungsszenarien

Stiltransfer auf vorhandene Fotos durch Designer – Originalfoto und Stilbeschreibung eingeben und eine stilisierte Version erhalten, die die Position des Hauptmotivs bewahrt, etwa für Moodboards und erste Konzeptentwürfe.
Austausch von Elementen in Marketingmaterialien – Produktbild und Szenenbild übergeben und den Bildinhalt gemäß Anweisung ersetzen, um formatgleiche Werbebilder für die Ausspielung über mehrere Kanäle zu erzeugen.
Einheitlicher Stil mit mehreren Referenzbildern – Mehrere vorhandene visuelle Materialien eingeben und stilistisch konsistente Derivate erzeugen, etwa für die serielle Erweiterung einer Kampagnenvisualisierung.

Einschränkungen und Auswahlhinweise

Es wird ausschließlich Bild-zu-Bild unterstützt; mindestens ein Referenzbild ist erforderlich, eine reine Textgenerierung ist nicht möglich. Der Prompt ist auf 3 bis 5000 Zeichen begrenzt, Eingabebilder müssen jpeg/png/webp sein und dürfen je 10 MB nicht überschreiten, SVG wird nicht unterstützt. Als Auflösung stehen nur 1K und 2K zur Verfügung. Wenn ein Bild von Grund auf konzipiert werden soll, ist stattdessen die Text-zu-Bild-Linie derselben Familie zu verwenden; bei Anforderungen an eine nicht-kommerzielle Lizenz oder lokale Bereitstellung sind Lizenz- und Bereitstellungsbedingungen gesondert zu prüfen.

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 … Jul 27, 2026
Neues Modell Neues Bildbearbeitungsmodell: flux-2-klein-4b/image-to-image unterstützt ein einzelnes Referenzbild und 0,25–4 MP Aus… Jul 27, 2026

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

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

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

promptstringPflichtminLength 3maxLength 5000

Bearbeitungsanweisung, die den gewünschten Ausgabe-Effekt beschreibt, Länge 3-5000 Zeichen. Eingabebilder müssen in der Reihenfolge referenziert werden, z. B. „Den Krug aus Bild 1 in die Kapsel aus Bild 2 einfügen“.

image_urlsarrayPflichtminItems 1maxItems 8

Array von Eingabe-Referenzbildern mit 1-8 Bildern, jedes eine öffentlich zugängliche URL, unterstützt die Formate jpeg/png/webp, max. 10 MB pro Bild; SVG wird nicht unterstützt.

Array [ string ]

resolutionstringPflichtStandard: "1K"

Auflösung des Ausgabebildes, Standard 1K.

Optionen:1K2K

aspect_ratiostringPflichtStandard: "1:1"

Seitenverhältnis des generierten Bildes, Standard 1:1; bei Einstellung auf auto wird das Seitenverhältnis des ersten Eingabebildes übernommen.

Optionen:1:14:33:416:99:163:22:3auto

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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "1:1"
  }
}'

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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "1:1"
    }
  }),
});
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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "1:1"
        }
    },
)
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"
    }
  }
}