Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] ist das Produktionsbildmodell von Black Forest Labs für textgestützte Erstellung und referenzgeführte Bearbeitung. Sein dokumentiertes Profil verbindet fotorealistische Details, Text- und Farbsteuerung mit einem gemeinsamen Pixelbudget für Referenzen und Ausgabe sowie Bildern mit bis zu 4 Megapixeln.

Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux.2-pro

Ü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 [pro] ist das auf Produktion ausgerichtete Modell von Black Forest Labs für Bildgenerierung und -bearbeitung. Der Hersteller stellt es als Standardwahl für die meisten visuellen FLUX.2-Aufgaben vor: ein neues Bild aus Text erstellen oder eine Szene anhand visueller Referenzen überarbeiten. Zu den Fähigkeiten der Familie gehören fotorealistische Materialien und Beleuchtung, lesbarer Text, genaue Farbanweisungen und konsistente Motive über zusammengehörige Bearbeitungen hinweg. Das zurückgegebene Artefakt ist ein Bild für eine Produktszene, redaktionelle Komposition, ein Designkonzept oder visuelle Kommunikation.

Ein Produktionsbriefing vorbereiten

Beginnen Sie mit dem Motiv, seiner Handlung oder Anordnung, dem Stil sowie Umgebung oder Licht. Der Prompt-Leitfaden des Herstellers gewichtet frühe Wörter stärker und empfiehlt, wesentliches Motiv und Handlung vor dekorativen Details zu nennen. Er schlägt 10–30 Wörter für schnelle Konzepte und 30–80 für gewöhnliche Projekte vor, mit längeren Beschreibungen für komplexe Szenen. Diese Bereiche sind Hinweise zum Verfassen von Prompts und keine Textkontextgrenze.

Ein eigenständiges Katalogbriefing könnte eine Lampe aus gebürstetem Stahl auf einer warmgrauen Tischfläche zeigen, in einer Dreiviertelansicht, die Schalter und Schirm sichtbar macht. Legen Sie Oberfläche, Beleuchtung und Blickwinkel so fest, dass das Produkt erkennbar ist. Klären Sie bei einer Infografik oder einem Marketingbild zuerst sichtbaren Wortlaut und Hierarchie. Setzen Sie den genauen Titel in Anführungszeichen, geben Sie seine Platzierung an und benennen Sie Schriftstil und -größe. Prüfen Sie Beschriftungen, Mengen und Produktdetails in der endgültigen Darstellungsgröße.

Der Familienleitfaden dokumentiert sowohl natürlichsprachliche als auch JSON-strukturierte Prompts. Ein strukturiertes Szenenbriefing kann Motiv, Hintergrund, Licht und Komposition in getrennten Feldern halten, damit sich eine Anforderung klar überarbeiten lässt. Es unterstützt außerdem Beschreibungen mit Hex-Farben: Ordnen Sie den Code dem konkreten einzufärbenden Objekt oder Text zu. Beschreiben Sie das gewünschte Erscheinungsbild positiv, denn der dokumentierte FLUX.2-Promptablauf bietet keine negativen Prompts.

Mit Referenzen und einem gemeinsamen Pixelbudget bearbeiten

Das konkrete Anfrageprofil von [pro] bietet acht Positionen für Referenzbilder; die interaktive Herstellerschnittstelle unterstützt separat zehn. Weisen Sie jedem Bild eine Rolle zu, etwa Motiverscheinung, Kleidung, Produktdesign, Raum oder Stil. Geben Sie bei einer bestehenden Szene das zu ändernde Element an und welche Komposition, Umgebung und Bilddetails erhalten bleiben sollen. Die veröffentlichten Beispiele umfassen Möbelmontagen, Hintergrund- oder Wetteränderungen, Austauschobjekte und Textüberarbeitungen.

Die Referenzkapazität hängt außerdem von der Ausgabegröße ab. Der [pro]-Leitfaden des Anbieters nennt ein Gesamtbudget von 9 Megapixeln für Eingabe und Ausgabe. Seine Beispiele erlauben acht Referenzen bei 1 Megapixel Ausgabe und sieben bei 2 Megapixeln; die Referenzkapazität sinkt mit wachsender Ergebnisgröße. Planen Sie Quellmaterial und Ausgabe gemeinsam, statt die maximale Zahl von Positionen für jede Ausgabegröße vorauszusetzen. Nutzen Sie Referenzen, die notwendige Informationen liefern, und benennen Sie ihren beabsichtigten Beitrag.

Bei einer Produktmontage könnte das erste Bild das Produkt und das zweite einen Raum liefern, während ein drittes ein Materialfinish festlegt. Erläutern Sie, wie daraus eine stimmige Szene werden soll. Verändert das Ergebnis eine Form, Kennzeichnung oder Identität, die erhalten bleiben sollte, richten Sie die Folgeanweisung darauf, statt das gesamte Briefing zu ersetzen. Das praktische Ergebnis ist das überarbeitete Bild, dessen Referenztreue und konkrete Änderung mit seinen Eingaben verglichen werden.

Prompt-Erweiterung und feste gegenüber Preview-Profilen

Die konkrete [pro]-Spezifikation aktiviert Prompt-Upsampling standardmäßig. Die Steuerung disable_pup stoppt diese Erweiterung, wenn eine sorgfältig formulierte Anweisung unverändert verwendet werden soll. Behalten Sie die gewählte Einstellung bei Versionsvergleichen bei, denn dasselbe kurze Konzept und eine erweiterte Beschreibung sind unterschiedliche Generierungseingaben. Dies ist eine Steuerung des Herstellerprofils und keine Garantie, dass jedes angeforderte Detail korrekt erscheint.

Die Dokumentation unterscheidet den einfachen [pro]-Endpunkt als festen Snapshot von [pro] Preview, in das spätere Modellverbesserungen einfließen. Anfrage- und Antwortstrukturen sind gleich, die zugrunde liegenden Gewichte unterscheiden sich jedoch. Bewahren Sie das genau gewählte Profil zusammen mit Bild und Referenzen auf. Die separate Preview-Bezeichnung darf eine einfache [pro]-Auswahl nicht stillschweigend ersetzen, wenn eine Überarbeitung von derselben dokumentierten Modellwahl abhängt.

Abmessungen, Formate und das ausgewählte Asset

Der Familienleitfaden dokumentiert Ausgaben bis 4 Megapixel, mit ausdrücklichen Abmessungen von mindestens 64×64 und Vielfachen von 16. Für die meisten Anwendungen empfiehlt er bis zu 2 Megapixel. Breite und Höhe legen den gewünschten Bildausschnitt fest; ein quadratisches Produktbild, ein Hochformatlayout und eine breite redaktionelle Szene verteilen Raum unterschiedlich. Die konkrete Anfrage nennt JPEG, PNG und WebP als Ausgabe, standardmäßig JPEG, sowie einen optionalen Seed.

Das Profil [max] besitzt eine separate Funktion zur Fundierung per Suche, [flex] stellt Sampling-Schritte und Guidance bereit, und [klein] hat ein kleineres Profil mit vier Referenzen. Wählen Sie die Ausgabe anhand der benötigten Arbeit, statt diese Steuerungen in [pro] zu übertragen. Bewahren Sie für das ausgewählte Asset das eigentliche Bild, den endgültigen Prompt, Referenzen, Abmessungen und die Modellbezeichnung auf. Die signierten FLUX.2-Ergebnislinks des Anbieters laufen nach zehn Minuten ab. Rufen Sie deshalb das Bild ab, statt sich auf seine temporäre Adresse zu verlassen. Prüfen Sie Motividentität, Farben, Text, Komposition und bearbeitete Details, bevor Sie das Ergebnis in kundenorientiertes Material einsetzen.

Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux.2-pro

black-forest-labs/flux.2-pro

Black Forest Labs /black-forest-labs/flux.2-pro

Start

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
Feld`model`	Typ`string`	AnforderungErforderlich	Werte und Limits black-forest-labs/flux.2-pro	Standard—
Feld`prompt`	Typ`string`	AnforderungErforderlich	Werte und Limits Mindestlänge: 1	Standard—
Feld`aspect_ratio`	Typ`string`	AnforderungOptional	Werte und Limits 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Standard—
Feld`output_format`	Typ`string`	AnforderungOptional	Werte und Limits png, jpeg	Standard—
Feld`n`	Typ`integer`	AnforderungOptional	Werte und Limits Minimum: 1 Maximum: 1	Standard—
Feld`input_references`	Typ`array`	AnforderungOptional	Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 8	Standard—
Feld`provider`	Typ`object`	AnforderungOptional	Werte und Limits	Standard—

Methodenparameter und Lebenszyklus

Parameter	Vertrag
Parameter`content_type`	Vertragapplication/json
Parameter`required`	Vertragmodel, prompt
Parameter`material_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.06 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.06 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

curl

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-pro', '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}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Abrufe anderer Inhalte

Vorhandene eigene Dateien abrufen

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
Feld`created`	Typ
Feld`data[].url`	Typ
Feld`data[].b64_json`	Typ
Feld`usage`	Typ

Aliasnamen

Modellaliasnamen

Ailoot Ultra black-forest-labs/flux.2-pro

Aliasnamen für Methodenpfade

/v1/images

Zugehörige Aufrufer-IDs

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

Welche Eingaben und Ergebnisse sind verfügbar?: POST /v1/images/generations · black-forest-labs/flux.2-pro: text, image → image
Welche Felder verwendet die Anfrage?: POST /v1/images/generations · black-forest-labs/flux.2-pro: model, prompt, aspect_ratio, output_format, n, input_references, provider
Welche Grenzen gelten?: POST /v1/images/generations · black-forest-labs/flux.2-pro: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Pro