Black Forest Labs

FLUX.1 Kontext Max

flux-1-kontext-max

Die Flaggschiff-Version zur Bildbearbeitung aus der Kontext-Reihe, spezialisiert auf lokale Änderungen per natürlicher Sprachbefehl, mit stärkerer Befolgung von Prompts und besserer Textsetzung im Bild – ideal für Markenvisuals und die serielle Produktion von Storyboards

flux-1-kontext-max

flux-1-kontext-max ausprobieren

Eingabe

Ausgabe

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

Preise

flux-1-kontext-max per image

Einzelpreis	$0.0715

Einordnung und Kurzprofil

FLUX.1 Kontext Max ist ein Bildgenerierungs- und Bildbearbeitungsmodell von Black Forest Labs, das über die einheitliche Schnittstelle von HiAPI.ai aufgerufen wird. Es unterstützt Text-zu-Bild sowie Einzelbildbearbeitung: Wird ein Originalbild bereitgestellt, werden die im Prompt angegebenen Inhalte gezielt geändert und der Rest beibehalten; ohne Originalbild wird anhand des Prompts ein neues Bild erzeugt. Im Vergleich zu den einfacheren Versionen der Serie ist es bei Prompt-Treue und Textsetzung im Bild stärker und eignet sich für Entwickler und Content-Teams, die den Bearbeitungsumfang präzise steuern und die Bildkonsistenz wahren müssen.

Kernhighlights

Lokale Bearbeitung unter Beibehaltung nicht spezifizierter Bereiche – im Prompt müssen nur die zu ändernden Farben, Objekte, Hintergründe oder Stile beschrieben werden, der übrige Bildinhalt bleibt möglichst unverändert.
Stärkste Prompt-Treue und Textsetzung der Serie – als höchste Ausbaustufe der Kontext-Serie führt es komplexe Bearbeitungsabsichten und die Darstellung von Text im Bild genauer und sauberer aus.
Gemeinsame Parameter für Text-zu-Bild und Bild-zu-Bild – über dieselbe Schnittstelle lässt sich durch Übergeben oder Weglassen des Originalbilds zwischen Neugenerierung und Bearbeitung auf Basis des Originalbilds wählen.
Einstellbares Seitenverhältnis und Prüfintensität – unterstützt sechs Ausgabeverhältnisse, die Formate jpeg/png sowie eine Inhaltsprüfungs-Toleranz von Stufe 0 bis 2.

Funktionsbeschreibung

Natürlichsprachige lokale Bearbeitung: Wird ein einzelnes Originalbild zusammen mit einem Prompt übergeben, ändert das Modell nur die beschriebenen Teile, nicht erwähnte Bereiche bleiben unverändert – ideal für schnelle Iterationen auf vorhandenem Material.

Text-zu-Bild-Generierung: Ohne Originalbild wird anhand des Prompts ein völlig neues Bild erzeugt; dieselbe Schnittstelle verbindet die Neuerstellung von Grund auf mit der anschließenden Bearbeitung.

Textverarbeitung im Bild: Die Textsetzung ist die beste der Serie und eignet sich, um Schriftzüge im Bild zu erzeugen oder zu ändern und dabei Lesbarkeit und Sauberkeit zu wahren.

Steuerung von Verhältnis und Format: Beim Bearbeiten wird ohne Angabe das Verhältnis des Originalbilds übernommen; mit Angabe wird auf das Zielverhältnis zugeschnitten oder ergänzt. Die Ausgabe ist wahlweise jpeg oder png und lässt sich direkt in nachgelagerte Prozesse einbinden.

Schalter für Prompt-Umschreibung: Das Prompt-Upsampling kann aktiviert werden, um Details und Kreativität zu ergänzen, oder deaktiviert bleiben, um eine strikte Generierung nach dem Originaltext sicherzustellen.

Anwendungsszenarien

Marketingteams bearbeiten vorhandenes Markenmaterial – fertige Poster oder Banner eingeben und die zu ersetzenden Farben, Objekte oder Hintergründe angeben, um direkt einsetzbare Varianten zu erhalten.
Designer passen Text im Bild an – in bestehenden Layouts Text und Satzspiegel per Prompt ersetzen und druckfertige Ergebnisse für Werbeflächen oder Social Media erzeugen.
Storyboard und Produktion mehrerer Szenen – mit derselben Stilvorlage Bild für Bild bearbeiten und so eine kohärente, stilistisch einheitliche Bildserie für Storyboards erhalten.
Lokaler Austausch bei Produktbildern – Produktfotos hochladen und Hintergrund- oder Farbwechsel vorgeben, um fertige Bilder für E-Commerce-Detail- und Präsentationsseiten zu erzeugen.

Einschränkungen und Auswahlhinweise

Es wird nur ein einzelnes Originalbild als Eingabe unterstützt; über mehrere Referenzbilder lässt sich keine Charakterkonsistenz wahren. Der Schwerpunkt liegt auf Bildbearbeitung und gezielten Bereichsänderungen, reine Text-zu-Bild-Generierung ist nicht seine Hauptstärke. Als gehostetes Closed-Source-Modell lässt es sich nicht lokal betreiben und eignet sich nicht für Szenarien, in denen die Inferenzumgebung selbst kontrolliert werden muss. Die Abrechnung erfolgt pro Bild; bei hohem Volumen und häufigen Bearbeitungen sind die Kosten in die Bewertung einzubeziehen. Wer nur alltägliche Anpassungen wie einfache Farb- oder Hintergrundänderungen benötigt, kann zur Kostensenkung eine niedrigere Version derselben Serie in Betracht ziehen.

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-1-kontext-max

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für flux-1-kontext-max und Route default — siehe Parametertabelle unten.

promptstringPflichtminLength 1maxLength 4000

描述要生成的图片；使用原图时，描述需要修改和需要保留的内容。可用中文或英文，非英文提示词会先自动转成英文再生成。

input_imagestringOptional

可选的原图地址，只支持单张。提供后在该图基础上按提示词编辑；省略时按提示词生成全新图片。

aspect_ratiostringOptional

输出宽高比。编辑时留空沿用原图比例（实际像素按 32 的倍数微调），指定后按该比例裁切或补边；文生图留空时由模型选择画幅。

Optionen:21:916:94:31:13:49:16

output_formatstringOptionalStandard: "jpeg"

输出文件格式：jpeg 或 png。

Optionen:jpegpng

safety_toleranceintegerOptionalStandard: 2

内容审核严格程度：0 最严格，2 最宽松；文生图与编辑两种模式统一提供 0–2。

Optionen:012

prompt_upsamplingbooleanOptionalStandard: false

开启后自动改写提示词以增加细节与创意，耗时略长；需要严格按原文生成时关闭。

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-1-kontext-max",
  "input": {
    "prompt": "…",
    "output_format": "jpeg",
    "safety_tolerance": 2,
    "prompt_upsampling": false
  }
}'

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-1-kontext-max",
    input: {
      "prompt": "…",
      "output_format": "jpeg",
      "safety_tolerance": 2,
      "prompt_upsampling": false
    }
  }),
});
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-1-kontext-max",
        "input": {
          "prompt": "…",
          "output_format": "jpeg",
          "safety_tolerance": 2,
          "prompt_upsampling": False
        }
    },
)
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"
    }
  }
}