Black Forest Labs: FLUX.2 Max
FLUX.2 [max] ist Black Forest Labs’ Bildmodell für anspruchsvolle fertige Motive und konsistente Bearbeitungen. Sein dokumentiertes Profil verbindet visuelle Referenzen, detaillierte Szenensteuerung und Web-Quellenbezug für aktuelle Themen 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 das auf höchste Qualität ausgerichtete Mitglied von Black Forest Labs’ FLUX.2-Familie zur Bildgenerierung und -bearbeitung. Der Hersteller positioniert es für anspruchsvolle fertige Motive, genaue Umsetzung komplexer Briefings und Konsistenz über Bearbeitungen hinweg. Es erstellt Bilder aus einer schriftlichen Beschreibung oder nutzt bereitgestellte Bilder als visuelle Referenzen. Seine besondere Familienfunktion ist die quellenbasierte Suche: Eine Anfrage kann aktuelle Informationen einbeziehen, statt sich ausschließlich auf die im Prompt beschriebene Szene zu stützen.
Reale Informationen und das visuelle Briefing
Der Hersteller dokumentiert Websuche für Themen wie aktuelles Wetter, ein jüngstes Sportereignis oder eine historische Umgebung. Benennen Sie den tatsächlichen Ort, das Ereignis und den relevanten Zeitpunkt und beschreiben Sie die künstlerische Gestaltung separat. Ein quellenbasiertes Wetterkartenkonzept könnte Stadt, darzustellende Wetterlage, genauen Titel und Layout vorgeben. Die Suche liefert Informationen für die Generierung; prüfen Sie die sichtbaren Fakten einer attraktiven Illustration dennoch anhand der relevanten Quelle, bevor Sie sie als sachliche Information verwenden.
Diese Suchfunktion gehört im veröffentlichten FLUX.2-Vergleich zu [max]. Die anderen benannten Mitglieder haben eigene Rollen: [pro] für Produktion, [flex] für anpassbares Sampling und Typografie und [klein] für kompakte interaktive Generierung. Bewahren Sie den gewählten Modellnamen mit dem Ergebnis auf, damit eine spätere Überarbeitung das Profil mit Quellenbezug nicht unbemerkt durch eine andere Ausgabe ersetzt.
Referenzen für anspruchsvolle Bearbeitungen
Das dokumentierte Anfrageprofil nimmt bis zu acht Referenzbilder; die interaktive Herstelleroberfläche erlaubt separat zehn. Weisen Sie jeder Referenz eine Rolle zu, etwa Figurenaussehen, 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 in einer vorhandenen Szene das zu ändernde Objekt und zu erhaltende Details einschließlich Lichtrichtung und umgebender Geometrie.
Die Familienbeispiele umfassen Hintergrundänderungen, Objektaustausch, Möbelkompositionen, Textbearbeitung und konsistente Figuren. Ein eigenes Briefing für ein fertiges Motiv könnte eine bereitgestellte Uhr auf dunklem gefaltetem Stoff platzieren, Zifferblatt- und Armbanddesign beibehalten und nur das Licht zu weichem Seitenlicht ä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 den Vergleichsnachweis.
Text, Farben und Prompt-Auslegung
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ürlichsprachliche und JSON-strukturierte Szenenbeschreibungen sind dokumentierte Möglichkeiten, Motive, Platzierung, Licht und Stil zu ordnen. Ein strukturierter Prompt ist ein Bildbriefing und kein Versprechen einer strukturierten Textantwort.
Setzen Sie sichtbaren Wortlaut in Anführungszeichen, nennen Sie seine Position und beschreiben Sie die typografische Hierarchie. Ordnen Sie jede Hex-Farbe einem bestimmten Objekt oder Textelement zu; ein Farbcode ohne benanntes Ziel ist mehrdeutig. Der Herstellerleitfaden nutzt 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 verwendet standardmäßig Prompt-Upsampling. disable_pup schaltet die Erweiterung aus, wenn ein sorgfältig formuliertes Briefing unverändert eingesetzt werden soll. Das ist von der Behauptung zu unterscheiden, jedes Wort erscheine unverändert im fertigen Bild. Bewahren Sie tatsächliches Briefing und gewählte Einstellung mit dem Ergebnis auf, um unerwartete Bildentscheidungen der Anweisung oder ihrer Interpretation zuordnen zu können.
Ausgabe und ein brauchbares fertiges Motiv
Der Familienleitfaden dokumentiert Bilder bis 4 Megapixel mit ausdrücklichen Abmessungen von mindestens 64×64 und Vielfachen von 16. Für gewöhnliche Anwendungen empfiehlt er bis 2 Megapixel. Das genaue [max]-Profil nennt JPEG, PNG und WebP, standardmäßig JPEG, sowie einen optionalen Zufalls-Seed. Wählen Sie das Ausgabeformat für den Einsatzort vor der Komposition. Die Bildgenerierung des Modells ist vom Skalieren eines bereits fertigen Motivs getrennt.
Bewahren Sie Bild, Referenzen, Prompt, Abmessungen und Modellidentität bei der Auswahl der fertigen Version auf. Der FLUX.2-Leitfaden des Herstellers warnt vor dem temporären signierten Ergebnislink mit zehnminütigem Abruffenster. Prüfen Sie feinen Text, Objektidentität, Layout, Licht und aus der Suche übernommene Fakten in der vorgesehenen Anzeigegröße. Das nutzbare Ergebnis ist das gewählte Motiv mit genügend Kontext für eine genaue Fortsetzung der Überarbeitung, nicht eine 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 Motive und konsistente Bearbeitungen. Sein dokumentiertes Profil verbindet visuelle Referenzen, detaillierte Szenensteuerung und Web-Quellenbezug für aktuelle Themen 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 |
|---|---|---|---|---|
| KonfigurationBasistarife für Tokens | 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 · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationMegapixel des Ausgabebildes | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Megapixel des Ausgabebildes | Gebühr Ausgabe · Megapixel des Ausgabebildes · Schätzung nur zum Vergleich $0.14 pro Megapixel des Ausgabebildes |
| KonfigurationGeschätzte Generierungskosten | 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 abschließenden 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