Black Forest Labs: FLUX.2 Max
FLUX.2 [max] ist Black Forest Labs’ Bildmodell für anspruchsvolle fertige Ergebnisse und konsistente Bearbeitungen. Sein dokumentiertes Profil verbindet visuelle Referenzen, detaillierte Szenensteuerung und Web-Fundierung für aktuelle Motive mit Ausgaben bis 4 Megapixel.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
FLUX.2 [max] ist Black Forest Labs’ Mitglied mit höchstem Qualitätsanspruch in der FLUX.2-Familie für Bildgenerierung und -bearbeitung. Der Hersteller positioniert es für anspruchsvolle fertige Ergebnisse, starke Befolgung komplexer Briefings und Konsistenz über Bearbeitungen hinweg. Es erstellt ein Bild aus einer schriftlichen Beschreibung oder verwendet bereitgestellte Bilder als visuelle Referenzen. Seine besondere Familienfähigkeit ist die fundierende Suche: Eine Anfrage kann aktuelle Informationen einbeziehen, statt sich nur auf die im Prompt beschriebene Szene zu stützen.
Reale Informationen und visuelles Briefing
Der Hersteller dokumentiert Websuche für Themen wie aktuelles Wetter, ein kürzliches Sportereignis oder eine historische Umgebung. Benennen Sie tatsächlichen Ort, Ereignis und bildrelevanten Zeitpunkt und beschreiben Sie die künstlerische Gestaltung separat. Ein fundiertes Wetterkartenkonzept könnte Stadt, darzustellende Wetterlage, exakten Titel und Layout festlegen. Die Suche informiert die Generierung; auch eine attraktive Illustration muss vor faktischer Kommunikation hinsichtlich sichtbarer Fakten mit der relevanten Quelle verglichen werden.
Diese Suchfähigkeit gehört im veröffentlichten FLUX.2-Vergleich zu [max]. Die anderen benannten Mitglieder haben eigene Aufgaben: [pro] für Produktion, [flex] für verstellbares Sampling und Typografie und [klein] für kompakte interaktive Generierung. Halten Sie den gewählten Modellnamen mit dem Ergebnis fest, damit eine spätere Überarbeitung das fundierbare Profil nicht stillschweigend durch eine andere Edition ersetzt.
Referenzen für anspruchsvolle Bearbeitungen
Das dokumentierte Anfrageprofil verwendet bis zu acht Referenzbilder; die interaktive Herstelleroberfläche erlaubt separat zehn. Weisen Sie jeder Referenz eine Rolle zu, etwa Figurenerscheinung, Produktdesign, Kleidung, Raum oder Bildstil. Eine Komposition kann den Stuhl aus einem Bild mit dem Raum aus einem anderen verbinden und dabei Silhouette und Material des Stuhls erhalten. Benennen Sie bei einer bestehenden Szene das zu ändernde Objekt und zu erhaltende Details, einschliesslich Lichtrichtung und umgebender Geometrie.
Die Familienbeispiele umfassen Hintergrundwechsel, Objektersatz, Möbelkompositionen, Textbearbeitung und konsistente Figuren. Ein eigenes Briefing für ein fertiges Bild könnte eine bereitgestellte Uhr auf dunkel gefalteten Stoff legen, Zifferblatt- und Armbanddesign erhalten und nur das Licht in eine weiche seitliche Beleuchtung ändern. Benennen Sie die Quelle jedes Merkmals und prüfen Sie Zifferblatt, Kennzeichnungen, Material und Reflexionen gemeinsam. Eine Erhaltungsanweisung legt das Ziel fest; das zurückgegebene Bild liefert die Vergleichsgrundlage.
Text, Farben und Prompt-Interpretation
Der FLUX.2-Leitfaden empfiehlt die Struktur Motiv–Handlung–Stil–Kontext mit wichtigen Elementen zuerst. Er schlägt 10–30 Wörter für schnelle Konzepte, 30–80 für gewöhnliche Projekte und längere Beschreibungen für komplexe Szenen vor. Dies sind Schreibempfehlungen, keine harten Kontextgrenzen. Natürliche Sprache und JSON-strukturierte Szenenbeschreibungen sind beide dokumentierte Wege, Motive, Platzierung, Licht und Stil zu ordnen. Ein strukturierter Prompt ist ein Bildbriefing und kein Versprechen einer strukturierten Textantwort.
Zitieren Sie für sichtbare Schrift den Wortlaut, geben Sie seine Position an und beschreiben Sie die typografische Hierarchie. Ordnen Sie jede Hexadezimalfarbe einem konkreten Objekt oder Textelement zu; ein Farbcode ohne benanntes Ziel ist mehrdeutig. Der Herstellerleitfaden verwendet positive Beschreibungen statt eines Mechanismus für negative Prompts. Beschreiben Sie bei einer Produktszene mit Freiraum für eine Überschrift den leeren Bereich und seine gewünschte Position direkt.
Die genaue [max]-Anfragespezifikation wendet Prompt-Upsampling standardmässig an. Die Steuerung disable_pup schaltet diese Erweiterung aus, wenn ein sorgfältig formuliertes Briefing unverändert verwendet werden soll. Das bedeutet nicht, dass jedes Wort unverändert im fertigen Bild erscheint. Bewahren Sie tatsächliches Briefing und gewählte Einstellung mit dem Ergebnis auf, wenn Sie beurteilen, ob eine unerwartete Bildentscheidung aus der Anweisung oder ihrer Interpretation stammt.
Ausgabe und ein brauchbares fertiges Bild
Der Familienleitfaden dokumentiert Bilder bis 4 Megapixel mit ausdrücklichen Abmessungen von mindestens 64×64 und Vielfachen von 16. Für gewöhnliche Nutzung empfiehlt er bis 2 Megapixel. Das genaue [max]-Profil nennt JPEG, PNG und WebP, standardmässig JPEG, sowie einen optionalen Zufalls-Seed. Wählen Sie die Ausgabeform passend zur Platzierung vor der Kompositionsplanung. Bildgenerierung des Modells ist von der Grössenänderung eines bereits fertigen Bildes getrennt.
Bewahren Sie bei der Auswahl der endgültigen Version Bild, Referenzen, Prompt, Abmessungen und Modellidentität auf. Der FLUX.2-Leitfaden des Herstellers warnt vor dem temporären signierten Ergebnislink mit einem Abruffenster von zehn Minuten. Prüfen Sie feine Schrift, Objektidentität, Layout, Licht und alle aus der Suche stammenden Fakten in der vorgesehenen Anzeigegrösse. Das brauchbare Ergebnis ist das gewählte Bild mit ausreichend Kontext für eine genaue weitere Überarbeitung, statt einer Szene, deren wichtige Details nie mit dem Briefing verglichen wurden.
Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux.2-max
black-forest-labs/flux.2-maxEinstieg
FLUX.2 [max] ist Black Forest Labs’ Bildmodell für anspruchsvolle fertige Ergebnisse und konsistente Bearbeitungen. Sein dokumentiertes Profil verbindet visuelle Referenzen, detaillierte Szenensteuerung und Web-Fundierung für aktuelle Motive mit Ausgaben bis 4 Megapixel.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabe
text,image- Ausgabe
image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits black-forest-labs/flux.2-max | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standard— |
Feldoutput_format | Typstring | AnforderungOptional | Werte und Limits png, jpeg | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 1 | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 8 | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext, image |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Gebühr |
|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationMegapixel des Ausgabebilds | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Megapixel des Ausgabebildes | Gebühr Ausgabe · Megapixel des Ausgabebilds · Schätzung nur zum Vergleich $0.14 pro Megapixel des Ausgabebildes |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.14 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Bilder
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux.2-max', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Bilder
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Die zurückgegebene X-Client-Request-ID zum Abgleich aufbewahren. Nur tatsächlich zurückgegebene task_id-/asset_id-Werte oder die eigene Medienbibliothek abfragen; niemals eine Aufgaben-URL aus der Vorgangs-ID bilden und die Erstellung niemals erneut anfordern.
Antwortfelder
| Feld | Typ |
|---|---|
Feldcreated | Typ |
Felddata[].url | Typ |
Felddata[].b64_json | Typ |
Feldusage | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra black-forest-labs/flux.2-max
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Black Forest Labs: FLUX.2 Max
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·black-forest-labs/flux.2-max:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·black-forest-labs/flux.2-max:model,prompt,aspect_ratio,output_format,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·black-forest-labs/flux.2-max:n.minimum:1;n.maximum:1