Black Forest Labs

FLUX 3 Image

flux-3-image

Ein bildorientiertes Modell aus der multimodalen Familie von Black Forest Labs, das eine gemeinsame Trainingsarchitektur und das Self-Flow-Framework mit Video und Audio teilt und sich für Upgrades von Bildgenerierungs-Pipelines auf Basis des FLUX-Systems eignet

flux-3-image

flux-3-image ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

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

Preise

flux-3-image per image

Spezifikationen	Einzelpreis
768S	$0.041
1K	$0.048
1.5K	$0.070
2K	$0.100
4K	$0.607

Positionierung

flux-3-image ist das Bildmodell aus der multimodalen FLUX-3-Familie von Black Forest Labs und wird über die einheitliche Schnittstelle von HiAPI.ai aufgerufen. Es akzeptiert sowohl reine Text-Prompts zur direkten Bilderzeugung als auch bis zu 10 Referenzbilder für die Generierung und partielle Bearbeitung; Ausgabeformat, Auflösungsstufe und Toleranz gegenüber Inhaltssicherheit sind einstellbar. Geeignet für Entwickler, die eine Pipeline zur Generierung visueller Inhalte aufbauen, sowie für Teams, die eine neue Modellgeneration in bestehende FLUX-Bild-Workflows integrieren möchten.

Zentrale Highlights

Gemeinsame Steuerung über Referenzbilder und Prompts – bis zu 10 Referenzbilder können übergeben und im Prompt jeweils ihre Rolle als Motiv, Stil oder Komposition zugewiesen werden.
Optionale Web-Recherche zur Ergänzung visueller Informationen – Grounding ist standardmäßig aktiviert; vor der Generierung werden Webseiten und Bilder durchsucht, um das Prompt um Entitäts- und Szenendetails zu ergänzen.
Fein wählbare Auflösung und Bildformate – die Ausgabe umfasst fünf Pixelstufen von 768 bis 4K sowie 16 Seitenverhältnisse; im Auto-Modus wird das Bildformat anhand von Prompt und Referenzbildern automatisch festgelegt.

Funktionsbeschreibung

Text-zu-Bild und referenzbildgestützte Generierung: Mit einer einzigen Anfrage lässt sich aus einem Prompt ein Bild erzeugen; werden Referenzbilder bereitgestellt, genügt es, im Prompt die zu ändernden und beizubehaltenden Inhalte zu benennen, um gezielte Anpassungen ohne schrittweisen Ablauf vorzunehmen.

Kombination mehrerer Referenzbilder: Pro Anfrage sind bis zu 10 Referenzbilder verfügbar, die jeweils die Rolle von Motiv, Stil oder Komposition übernehmen – ideal, um mehrere visuelle Materialien in einem Bild zusammenzuführen.

Steuerung von Bildformat und Auflösung: aspect_ratio bietet 16 Seitenverhältnisse von 21:9 (Querformat) bis 9:21 (Hochformat) sowie eine automatische Auswahl; resolution reicht von 768 bis 4K, was die Batch-Erzeugung entsprechend Ausspielkanal und Schärfeanforderungen erleichtert.

Einstellbare Toleranz gegenüber Inhaltssicherheit: safety_tolerance ist von 0 bis 4 einstellbar, Standard ist 2; Teams können die Filterstärke gemäß ihren eigenen Compliance-Anforderungen verschärfen oder lockern.

Anwendungsszenarien

Stilisierte Bilderzeugung für Kreativteams – Designvorgaben und Stilreferenzbilder eingeben und visuelle Entwürfe erzeugen, die der vorgegebenen Komposition und dem Bildformat entsprechen, für Werbematerial und Konzeptpräsentationen.
Modell-Upgrade bestehender FLUX-Pipelines – bestehende Aufrufe zur Bilderzeugung durch Text-Prompts ersetzen; die Ausgabe behält die bisherige Schnittstellenform bei, sodass das Modell ohne Änderung der übergeordneten Abläufe aktualisiert werden kann.
Erzeugung von Szenenbildern mit Faktenbezug – nach Aktivierung von Grounding das Motiv mit einem kurzen Prompt beschreiben und Bilder erzeugen, die durch Rechercheinformationen ergänzt sind, für Inhaltsbebilderung und Szenendarstellungen.
Zusammenführung mehrerer Materialien und Bildüberarbeitung – mehrere Referenzbilder hochladen und deren jeweilige Rolle kennzeichnen, um einheitlich stilisierte Kompositionen oder Überarbeitungen zu erhalten, für E-Commerce-Bilder und die Wiederverwendung von Materialien.

Einschränkungen und Auswahlhinweise

Öffentlich verfügbare Informationen konzentrieren sich überwiegend auf die gesamte FLUX-3-Familie und die Videosparte; die konkreten Spezifikationen dieser Bildversion sind nur begrenzt offengelegt. Beschreibungen von gemeinsamem Training und Videofähigkeiten auf Familienebene lassen sich nicht unmittelbar mit dem vollständigen Funktionsumfang dieses Modells gleichsetzen. Grounding durchsucht zunächst und generiert anschließend, was die Dauer einer einzelnen Anfrage erhöhen kann. Für Generierungsgeschwindigkeit, Stabilität und das Verhalten bei extrem schwierigen Prompts empfiehlt es sich, zunächst mit eigenen Beispielen zu validieren, bevor das Modell in die Produktion übernommen wird. Falls Video- oder Audiogenerierung benötigt wird, sollte ein Modell der entsprechenden Sparte derselben Familie gewählt werden.

Häufige Fragen

Alle Fragen ansehen →

Kann man mit einem einzigen Einstieg sowohl generieren als auch bearbeiten?

Ja. Ohne Referenzbild wird aus Text generiert; mit 1–10 Referenzbildern wird rund um vorhandenes Material bearbeitet. Bereite einfach je nach Ziel Text oder Bilder vor.
Wie sollte man die fünf Auflösungsstufen auswählen?

Verwenden Sie zunächst 768 oder 1K, um die Richtung zu besprechen; wenn mehr Details benötigt werden, ziehen Sie 1.5K oder 2K in Betracht, und wenn größere Bilder und Spielraum zum Zuschneiden benötigt werden, ziehen Sie 4K in Betracht. Die Stufen sind keine festen Seitenlängen; bitte überprüfen Sie die Breite und Höhe der zurückgegebenen Bilder.
Wie werden die Referenzbilder aufgeteilt?

Erkläre der Reihe nach, welches Bild das Motiv, welches die Umgebung und welches nur die Farbgebung oder den Stil liefert, und benenne zugleich die Elemente, die nicht übernommen werden sollen.
Wie viele Bilder werden pro Vorgang generiert?

Jede Aufgabe liefert ein Bild. Wenn eine andere Ausrichtung benötigt wird, passen Sie die Beschreibung an und reichen Sie eine separate Aufgabe ein.

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-3-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

promptstringPflichtminLength 1maxLength 5000

Beschreibe den gewünschten Bildinhalt; wenn Referenzbilder bereitgestellt werden, kannst du hier auch angeben, welche Teile des Bildes geändert und welche beibehalten werden sollen.

groundingbooleanOptionalStandard: true

Boolescher Wert, der steuert, ob vor der Generierung eine Websuche nach Webseiten und Bildern durchgeführt wird, um die visuellen Informationen im Prompt zu ergänzen; Standardwert ist true.

image_urlsarrayOptionalminItems 1maxItems 10

Array von Referenzbild-URLs, die als visuelle Referenz für die Generierung dienen; das Motiv, der Stil oder die kompositorische Rolle jedes Bildes muss im Prompt angegeben werden.

Array [ string ]

resolutionstringOptionalStandard: "1K"

Auflösungsstufe der Ausgabe; die genauen Breiten- und Höhenwerte variieren je nach Seitenverhältnis; Standardwert ist 1K.

Optionen:7681K1.5K2K4K

aspect_ratiostringOptionalStandard: "auto"

Seitenverhältnis der Ausgabe, wahlweise Querformat, Hochformat oder Quadrat; auto bedeutet, dass das Format automatisch anhand von Prompt und Referenzbildern bestimmt wird; Standardwert ist auto.

Optionen:21:92:116:93:27:54:35:41:1

Alle anzeigen (8)

4:53:45:72:39:161:29:21auto

safety_toleranceintegerOptionalStandard: 2min 0max 4

Ganzzahl für die Toleranz gegenüber Inhaltssicherheit; der Wert 0 ist am strengsten; Standardwert ist 2.

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-3-image",
  "input": {
    "prompt": "…",
    "grounding": true,
    "resolution": "1K",
    "aspect_ratio": "auto",
    "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",
    input: {
      "prompt": "…",
      "grounding": true,
      "resolution": "1K",
      "aspect_ratio": "auto",
      "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",
        "input": {
          "prompt": "…",
          "grounding": True,
          "resolution": "1K",
          "aspect_ratio": "auto",
          "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

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