Black Forest Labs
FLUX 1.1 Pro
flux-1.1-pro
Black Forest Labs' Flaggschiff-Modell für Text-zu-Bild, ca. 6-mal schnellere Generierung als Flux.1 Pro, bessere Prompta-Treue, ideal für die Bilderzeugung im großen Maßstab
flux-1.1-pro ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
imagePreise
flux-1.1-pro per image
| Einzelpreis | $0.050 |
|---|
Positionierung und Kurzüberblick
flux-1.1-pro ist ein Text-zu-Bild- und Bild-zu-Bild-Modell von Black Forest Labs für den Produktiveinsatz, das Entwickler über die einheitliche Schnittstelle von HiAPI.ai aufrufen. Es unterstützt die direkte Bilderzeugung per Textprompt und ebenso die bildkonditionierte Generierung mit angehängter Referenzbild-URL; die Prompt-Treue ist gut, weshalb es sich für Geschäftsprozesse eignet, die stabile Ergebnisse in hoher Qualität erfordern. Die Seitenverhältnisse decken gängige Formate wie 1:1, 16:9, 3:2, 4:5 und 9:16 ab, zudem sind benutzerdefinierte Größen möglich; Ausgabeformat und -qualität sind einstellbar, was die Anbindung an Batch-Generierung und automatisierte Produktionsketten erleichtert.
Zentrale Highlights
- Dualmodus für Text-zu-Bild und Bild-zu-Bild – dieselbe Schnittstelle erzeugt Bilder sowohl rein aus Prompts als auch mit Referenzbild-URL als Bildbedingung, wodurch der Wechsel zwischen mehreren Modellen entfällt.
- Reproduzierbare Generierungssteuerung – mit festem seed liefern wiederholte Aufrufe konsistente Ergebnisse, was Regressionstests und die Reproduktion von Batch-Aufgaben erleichtert.
- Ausgabeparameter nach Bedarf anpassbar – Seitenverhältnis, benutzerdefinierte Größe, Formate webp/jpg/png sowie Ausgabequalität stehen zur Wahl und eignen sich für unterschiedliche nachgelagerte Zwecke.
- Für Produktionsworkflows konzipiert – die vollständige Parameterstruktur eignet sich für die Anbindung an automatisierte Batch-Generierung und stabile Lieferprozesse.
Funktionsbeschreibung
Text-zu-Bild: erzeugt Bilder direkt mit dem prompt als Kerneingabe, ideal für Kreation und Materialerstellung ohne Ausgangsmaterial.
Generierung mit Referenzbild-Bedingung: übergibt über image_prompt eine Referenzbild-URL im Format jpeg, png, gif oder webp und generiert auf Basis vorhandener visueller Vorlagen.
Bildformat- und Größensteuerung: mehrere gängige Seitenverhältnisse sind integriert; bei Auswahl von custom lassen sich Breite und Höhe zwischen 256 und 1440 Pixeln benutzerdefiniert festlegen, ausgerichtet auf 32 Pixel.
Ausgabeformat und -qualität: wählbar sind webp, jpg und png sowie eine Ausgabequalität von 0 bis 100; bei png-Ausgabe wirkt der Qualitätsparameter nicht.
Reproduzierbare Generierung und Detailanpassung: fester seed reproduziert Ergebnisse, prompt_upsampling kann Prompts automatisch umschreiben, safety_tolerance lässt sich für eine lockerere Inhaltsfreigabe anpassen.
Anwendungsfälle
- Batch-Generierung von Marketing- und Werbematerial – Betriebs- und Marketingteams geben Kampagnentexte ein und erzeugen Werbebilder in mehreren Formaten für Werbekanäle und Landingpages.
- Produktvisualisierung als Szenenbilder – E-Commerce-Teams nutzen Produktbeschreibungen oder Referenzbilder als Eingabe und erzeugen Produktszenenbilder für Detailseiten und Präsentationsmaterial.
- Bebilderung für Content-Creator – Creator geben Prompts zum Artikelthema ein und erzeugen stilistisch einheitliche Bebilderungen für Text-Bild-Inhalte und Social-Media-Veröffentlichungen.
- Visuelle Darstellung von Design-Prototypen – Designer geben Konzeptbeschreibungen oder Referenzbilder ein und erzeugen schnell Entwürfe für die Abstimmung von Lösungen und die Festlegung der Prototyprichtung.
- Bildgenerierungs-Knoten in automatisierten Workflows – Engineering-Teams binden die Schnittstelle in Pipelines ein und erzeugen mit festen Parametern und seed stabile Bilder für die skalierte Content-Produktion.
Einschränkungen und Auswahlhinweise
Es werden ausschließlich statische Bilder ausgegeben, keine Videos oder andere Modalitäten; die Generierungsqualität hängt von der Prompt-Qualität ab, und komplexe oder sehr spezifische Anforderungen erfordern mehrere Optimierungsrunden. Die maximale Breite und Höhe beträgt 1440 Pixel, benutzerdefinierte Größen werden auf 32 Pixel ausgerichtet; Anforderungen über diese Größe hinaus müssen separat behandelt werden. Die Ausgabequalität wird vor allem über webp/jpg geregelt, bei png wirkt der Qualitätsparameter nicht. Eine niedrige Sicherheitstoleranz kann die Durchsatzrate der Bildausgabe beeinträchtigen. Wenn eine Aufgabe Videogenerierung oder eine Batch-Steuerung über ein einzelnes Bild hinaus erfordert, sollte ein Modell der entsprechenden Modalität verwendet werden.
Häufige Fragen
Alle Fragen ansehen →-
Für welche Aufgaben eignet sich FLUX1.1 [pro] hauptsächlich?
Geeignet für realistische Fotografie, Architektur, Food, Natur und kommerzielle Visuals, mit Unterstützung für benutzerdefinierte Größen und Prompt-Enhanced-Steuerung.
-
Unterstützt FLUX1.1 [pro] Referenzbilder?
Der aktuelle Pfad ist reine Text-zu-Bild-Generierung und akzeptiert keine Referenzbilder.
-
Welche Ausgabeformate werden unterstützt?
Die aktuelle Seite zeigt Custom width / height sowie Custom, 1:1, 16:9, 9:16; die endgültig verfügbaren Optionen richten sich nach den Playground-Parametern.
-
Wie wird FLUX1.1 [pro] abgerechnet?
Die Abrechnung erfolgt nach der Anzahl erfolgreich generierter Bilder; etwaige Unterschiede bei verschiedenen Auflösungen oder Qualitätsstufen werden im Echtzeitpreis auf der Seite angezeigt.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer 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-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
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
modelstringPflichtAktueller Festwert: flux-1.1-pro
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für flux-1.1-pro und Route default — siehe Parametertabelle unten.
seedintegerOptionalZufälliger Seed zur Erzeugung reproduzierbarer Ergebnisse; bei gleichem Seed und identischen übrigen Parametern lässt sich dieselbe Generierung reproduzieren.
widthintegerOptionalmin 256max 1440Benutzerdefinierte Bildbreite, nur verwendet, wenn aspect_ratio auf custom gesetzt ist; der Wert wird auf das nächste Vielfache von 32 gerundet.
heightintegerOptionalmin 256max 1440Benutzerdefinierte Bildhöhe, nur verwendet, wenn aspect_ratio auf custom gesetzt ist; der Wert wird auf das nächste Vielfache von 32 gerundet.
promptstringPflichtText-Prompt für die Bilderzeugung.
aspect_ratiostringOptionalStandard: "1:1"Seitenverhältnis des generierten Bildes, Standard ist 1:1.
custom1:116:93:22:34:55:49:16Alle anzeigen (2)
3:44:3image_promptstringOptionalOptionale Referenzbild-URL, Format muss jpeg, png, gif oder webp sein.
output_formatstringOptionalStandard: "webp"Format des Ausgabebildes, Standard ist webp.
webpjpgpngoutput_qualityintegerOptionalStandard: 80min 0max 100Qualität beim Speichern des Ausgabebildes, ganzzahliger Wert von 0 bis 100, Standard ist 80; ohne Wirkung bei png-Ausgabe.
safety_toleranceintegerOptionalStandard: 2min 1max 6Sicherheitstoleranz, Wertebereich 1 bis 6, 1 ist am strengsten, 6 am lockersten, Standard ist 2.
prompt_upsamplingbooleanOptionalStandard: falseOb der Prompt automatisch umgeschrieben wird, um die Kreativität der Generierung zu erhöhen, Standard ist false.
callbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
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.
urlstringPflichtPflicht, 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.
finalstoragestringOptionalStandard: "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.
temppersistentAnfragebeispiele
# 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.1-pro",
"input": {
"prompt": "…",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"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.1-pro",
input: {
"prompt": "…",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"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.1-pro",
"input": {
"prompt": "…",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"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
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelö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.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
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.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-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
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
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"
}
}
} Artikel
Alle Artikel ansehen →-
Tutorial
So nutzt du kling-4.0/text-to-video über die HiAPI-API: curl, Python und ein lauffähiges Anforderungsbeispiel
Ein praxisnaher Leitfaden für Entwickler: filmische Prompts, synchrones Audio, asynchrones Polling und Download der Ausgabe
-
Tutorial
So rufen Sie hailuo-2.3-fast/image-to-video über die HiAPI API auf: curl und Python in der Praxis
Die erste lauffähige Anfrage für die schnelle, kostengünstige Bild-zu-Video-Stufe – von der Modell-ID bis zum heruntergeladenen MP4
-
Tutorial
kandinsky-6.0-pro/image-to-video auf HiAPI: Tutorial mit curl und Python
Eine funktionierende Bild-zu-Video-Anfrage auf HiAPI ausführen: vom Upload des ersten Frames über asynchrones Polling bis zum finalen Download
-
Tutorial
Kandinsky 6.0 Pro Text-zu-Video auf HiAPI: curl- und Python-Tutorial
Eine anfrageorientierte praktische Demonstration: Aufbau des Aufrufs vom Prompt zum Videoclip, Absenden der Anfrage, Abfragen des Fertigstellungsstatus und Herunterladen des Ergebnisses
-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
GPT Image 2.5 OpenAI $0.017 /Bild -
Seedream 4.5 ByteDance $0.045 /Bild -
Grok Imagine xAI $0.011 /Sekunde -
Recraft Crisp Upscale Recraft $0.004 /Bild -
Krea 2 Medium Turbo Krea $0.021 /Bild -
Nano Banana Google $0.021 /Bild -
FLUX.1 Schnell Black Forest Labs $0.005 /Bild -
Ideogram V3 Character Ideogram $0.090 /Bild -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /Bild -
Qwen Image 2.0 Alibaba $0.042 /Bild -
Nano Banana 2 Lite Google $0.033 /Bild -
FLUX.2 Black Forest Labs $0.035 /Bild
Gleicher Anbieter
-
FLUX.2 Klein 4B Black Forest Labs $0.0004 /Bild -
FLUX 3 Image Black Forest Labs $0.041 /Bild -
FLUX.1 Fill Pro Black Forest Labs $0.071 /Bild -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /Bild -
FLUX.1 Schnell Black Forest Labs $0.005 /Bild -
FLUX.1 Kontext Max Black Forest Labs $0.071 /Bild -
FLUX.2 Black Forest Labs $0.035 /Bild -
FLUX 3 Video Black Forest Labs $0.090 /Sekunde -
FLUX 3 Max Black Forest Labs $0.061 /Sekunde










