Black Forest Labs: FLUX.2 Max
FLUX.2 [max] ist das Bildmodell von Black Forest Labs für anspruchsvolle fertige Assets und konsistente Bearbeitungen. Sein dokumentiertes Profil verbindet visuelle Referenzen, detaillierte Szenensteuerung und Webfundierung für aktuelle Motive mit Ausgaben bis zu 4 Megapixeln.
Ü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 qualitativ höchstrangige Mitglied der FLUX.2-Familie von Black Forest Labs für Bildgenerierung und -bearbeitung. Der Hersteller positioniert es für anspruchsvolle fertige Assets, starke Treue zu einem komplexen Briefing und Konsistenz über Bearbeitungen hinweg. Es erstellt ein Bild aus einer geschriebenen Beschreibung oder nutzt bereitgestellte Bilder als visuelle Referenzen. Seine besondere Fähigkeit innerhalb der Familie ist die Fundierung durch Suche: Eine Anfrage kann auf aktuelle Informationen zurückgreifen, statt sich nur auf die im Prompt beschriebene Szene zu stützen.
Informationen aus der realen Welt und das Bildbriefing
Der Hersteller dokumentiert Websuche für Themen wie aktuelles Wetter, ein kürzliches Sportereignis oder einen historischen Schauplatz. Benennen Sie tatsächlichen Ort, Ereignis und den für das Bild relevanten Zeitpunkt und beschreiben Sie die künstlerische Gestaltung getrennt. Ein suchgestütztes Konzept für eine Wetterkarte könnte Stadt, zu visualisierende Bedingung, genauen Titel und Layout festlegen. Die Suche informiert die Generierung; bei einer attraktiven Illustration müssen die sichtbaren Fakten dennoch anhand der passenden Quelle geprüft werden, bevor sie als sachliche Kommunikation dient.
Diese Suchfähigkeit gehört im veröffentlichten FLUX.2-Vergleich zu [max]. Die anderen benannten Mitglieder haben eigene Rollen: [pro] für Produktion, [flex] für einstellbares 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 fundierbare Profil nicht stillschweigend durch eine andere Ausgabe ersetzt.
Referenzen für anspruchsvolle Bearbeitungen
Das dokumentierte Anfrageprofil akzeptiert bis zu acht Referenzbilder; die interaktive Herstellerschnittstelle 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 eines anderen verbinden und dabei Silhouette und Material des Stuhls bewahren. Benennen Sie bei einer bestehenden Szene das zu ändernde Objekt und die zu erhaltenden Details, einschließlich Lichtrichtung und umgebender Geometrie.
Die Beispiele der Familie umfassen Hintergrundänderungen, Objektaustausch, Möbelkompositionen, Textbearbeitungen und konsistente Figuren. Ein eigenständiges Briefing für ein fertiges Asset könnte eine bereitgestellte Uhr auf dunklen, gefalteten Stoff legen, Zifferblatt- und Armbanddesign bewahren und nur die Beleuchtung in weiches Seitenlicht ändern. Benennen Sie, welche Quelle jede Eigenschaft liefert, und prüfen Sie resultierendes Zifferblatt, Kennzeichnungen, Material und Reflexionen gemeinsam. Eine Erhaltungsanweisung definiert das Ziel; das zurückgegebene Bild ist der Nachweis zum Vergleich damit.
Text, Farben und Prompt-Interpretation
Der FLUX.2-Leitfaden empfiehlt eine Struktur aus Motiv, Handlung, Stil und 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 festen Kontextgrenzen. Natürliche Sprache und JSON-strukturierte Szenenbeschreibungen sind beide dokumentierte Wege zur Organisation von Motiven, Platzierung, Licht und Stil. Ein strukturierter Prompt ist ein Bildbriefing und kein Versprechen einer strukturierten Textantwort.
Setzen Sie sichtbaren Wortlaut in Anführungszeichen, geben Sie seine Position an und beschreiben Sie die typografische Hierarchie. Ordnen Sie jede Hexadezimalfarbe einem bestimmten 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 für eine Produktszene mit freiem Platz für eine Überschrift diese freie Fläche und ihre gewünschte Position direkt.
Die konkrete Anfragespezifikation von [max] nutzt standardmäßig Prompt-Upsampling. Die Steuerung disable_pup schaltet die Erweiterung aus, wenn ein sorgfältig formuliertes Briefing unverändert verwendet werden soll. Dies ist von der Behauptung zu trennen, jedes Wort erscheine im endgültigen Bild unverändert. Bewahren Sie tatsächliches Briefing und gewählte Einstellung mit dem Ergebnis auf, um zu beurteilen, ob eine unerwartete Bildentscheidung aus der Anweisung oder ihrer Interpretation entstand.
Ausgabe und ein brauchbares fertiges Asset
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 zu 2 Megapixel. Das konkrete Profil [max] nennt JPEG, PNG und WebP, standardmäßig JPEG, sowie einen optionalen Zufalls-Seed. Wählen Sie das Ausgabeformat für die beabsichtigte Platzierung, bevor Sie die Komposition anordnen. Die Bildgenerierung des Modells ist von der Größenänderung eines bereits fertigen Assets getrennt.
Bewahren Sie Bild, Referenzen, Prompt, Abmessungen und Modellidentität auf, wenn Sie die endgültige Version auswählen. Der FLUX.2-Leitfaden des Anbieters warnt, dass der signierte Ergebnislink mit einem Abruffenster von zehn Minuten nur vorübergehend verfügbar ist. Prüfen Sie feinen Text, Objektidentität, Layout, Licht und alle aus der Suche übernommenen Fakten in der vorgesehenen Darstellungsgröße. Das nutzbare Artefakt ist das gewählte Bild mit genügend 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-maxStart
FLUX.2 [max] ist das Bildmodell von Black Forest Labs für anspruchsvolle fertige Assets und konsistente Bearbeitungen. Sein dokumentiertes Profil verbindet visuelle Referenzen, detaillierte Szenensteuerung und Webfundierung für aktuelle Motive mit Ausgaben bis zu 4 Megapixeln.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabetypen
text,image- Ausgabetypen
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 Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| 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