models

Black Forest Labs: FLUX.2 Pro

Markdown · JSON

Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] ist Black Forest Labs’ Produktionsbildmodell für textgestützte Erstellung und referenzgesteuerte Bearbeitung. Sein dokumentiertes Profil verbindet fotorealistische Details, Text- und Farbsteuerung mit einem Pixelkontingent für Referenzen und Ausgabe sowie Bildern 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 [pro] ist Black Forest Labs’ auf Produktion ausgerichtetes Modell für Bildgenerierung und -bearbeitung. Der Hersteller präsentiert es als Standardwahl für die meisten visuellen FLUX.2-Aufgaben: ein neues Bild aus Text erstellen oder eine Szene anhand visueller Referenzen überarbeiten. Zu den Familienfähigkeiten gehören fotorealistische Materialien und Beleuchtung, lesbare Schrift, exakte Farbanweisungen und konsistente Motive über verwandte Bearbeitungen hinweg. Das zurückgegebene Ergebnis ist ein Bild für eine Produktszene, redaktionelle Komposition, Designidee oder visuelle Kommunikation.

Ein Produktionsbriefing vorbereiten

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

Ein eigenes Katalogbriefing könnte eine Lampe aus gebürstetem Stahl auf einer warmgrauen Tischplatte zeigen, in einer Dreiviertelansicht mit sichtbarem Schalter und Schirm. Bestimmen Sie Oberfläche, Beleuchtung und Blickwinkel, die das Produkt erkennbar machen. Legen Sie für Infografiken oder Marketingbilder sichtbaren Wortlaut und Hierarchie zuerst fest; zitieren Sie den genauen Titel, bestimmen Sie seine Position und nennen Sie Schriftstil und -grösse. Prüfen Sie Beschriftungen, Mengen und Produktdetails in der endgültigen Anzeigegrösse.

Der Familienleitfaden dokumentiert Prompts in natürlicher Sprache und in JSON-Struktur. Ein strukturiertes Szenenbriefing kann Motiv, Hintergrund, Licht und Komposition in getrennten Feldern führen, damit sich eine Anforderung klar ändern lässt. Es unterstützt auch Hex-Farbbeschreibungen: Ordnen Sie den Code dem konkreten zu färbenden Objekt oder Text zu. Beschreiben Sie die gewünschte Erscheinung positiv, da der dokumentierte FLUX.2-Prompt-Ablauf keine negativen Prompts vorsieht.

Mit Referenzen und gemeinsamem Pixelkontingent bearbeiten

Das genaue [pro]-Anfrageprofil bietet acht Referenzbildpositionen; die interaktive Herstelleroberfläche unterstützt separat zehn. Weisen Sie jedem Bild eine Rolle zu, etwa Motiverscheinung, Kleidung, Produktdesign, Raum oder Stil. Nennen Sie bei einer vorhandenen Szene das zu ändernde Element sowie die Komposition, Umgebung und Bilddetails, die erhalten bleiben sollen. Veröffentlichte Beispiele umfassen Möbelmontagen, Hintergrund- oder Wetterwechsel, Ersatzobjekte und Textänderungen.

Die Referenzkapazität hängt auch von der Ausgabegrösse ab. Der [pro]-Leitfaden des Herstellers nennt ein Gesamtbudget von 9 Megapixeln für Eingabe und Ausgabe. Seine Beispiele erlauben acht Referenzen bei 1-Megapixel-Ausgabe und sieben bei 2-Megapixel-Ausgabe; mit wachsendem Ergebnis sinkt die Referenzkapazität. Planen Sie Quellen und Ausgabe gemeinsam, statt die maximale Anzahl Plätze für jede Ausgabegrösse vorauszusetzen. Nutzen Sie Referenzen mit den notwendigen Informationen und benennen Sie ihren vorgesehenen Beitrag.

Bei einer Produktmontage könnte das erste Bild das Produkt, das zweite einen Raum und das dritte ein Materialfinish liefern. Erklären Sie, wie daraus eine zusammenhängende Szene werden soll. Verändert das Ergebnis eine zu erhaltende Form, Kennzeichnung oder Identität, zielen Sie in der Folgekorrektur auf dieses Problem, statt das gesamte Briefing zu ersetzen. Das praktische Ergebnis ist das überarbeitete Bild, dessen Referenztreue und konkrete Änderung mit den Eingaben verglichen werden.

Prompt-Erweiterung sowie feste und Preview-Profile

Die genaue [pro]-Spezifikation aktiviert Prompt-Upsampling standardmässig. Die Steuerung disable_pup stoppt diese Erweiterung, wenn eine sorgfältig formulierte Anweisung unverändert verwendet werden soll. Behalten Sie die gewählte Einstellung beim Versionsvergleich bei, denn dasselbe kurze Konzept und eine erweiterte Beschreibung sind unterschiedliche Generierungseingaben. Dies ist eine Steuerung des Herstellerprofils, keine Garantie für die korrekte Darstellung jedes angeforderten Details.

Die Dokumentation unterscheidet den normalen [pro]-Endpunkt als festen Snapshot von [pro] Preview, wo spätere Modellverbesserungen eingeführt werden. Anfrage- und Antwortstrukturen sind gleich, ihre zugrunde liegenden Gewichte unterscheiden sich jedoch. Halten Sie das exakt gewählte Profil mit Bild und Referenzen fest. Die separate Preview-Bezeichnung darf eine normale [pro]-Auswahl nicht stillschweigend ersetzen, wenn eine Überarbeitung von derselben dokumentierten Modellwahl abhängt.

Abmessungen, Formate und ausgewähltes Bild

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 bestimmen den Bildrahmen; ein quadratisches Produktbild, Hochformatlayout und eine breite redaktionelle Szene verteilen Raum unterschiedlich. Die genaue Anfrage nennt JPEG, PNG und WebP, standardmässig JPEG, sowie einen optionalen Seed.

Das [max]-Profil hat eine separate Funktion zur fundierenden Suche, [flex] legt Sampling-Schritte und Guidance offen, und [klein] hat ein kleineres Profil mit vier Referenzen. Wählen Sie die Edition nach der benötigten Arbeit, statt diese Steuerungen in [pro] zu übertragen. Bewahren Sie beim ausgewählten Bild die tatsächliche Datei, den endgültigen Prompt, Referenzen, Abmessungen und Modellbezeichnung auf. Signierte FLUX.2-Ergebnislinks des Herstellers laufen nach zehn Minuten ab; rufen Sie daher das Bild ab, statt auf seinen temporären Speicherort zu vertrauen. Prüfen Sie Motividentität, Farben, Text, Komposition und bearbeitete Details vor der Verwendung in kundenorientiertem Material.

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

Einstieg

FLUX.2 [pro] ist Black Forest Labs’ Produktionsbildmodell für textgestützte Erstellung und referenzgesteuerte Bearbeitung. Sein dokumentiertes Profil verbindet fotorealistische Details, Text- und Farbsteuerung mit einem Pixelkontingent für Referenzen und Ausgabe sowie Bildern 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
FeldTypAnforderungWerte und LimitsStandard
FeldmodelTypstringAnforderungErforderlichWerte und Limits
black-forest-labs/flux.2-pro
Standard—
FeldpromptTypstringAnforderungErforderlichWerte und Limits
Mindestlänge: 1
Standard—
Feldaspect_ratioTypstringAnforderungOptionalWerte und Limits
1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto
Standard—
Feldoutput_formatTypstringAnforderungOptionalWerte und Limits
png, jpeg
Standard—
FeldnTypintegerAnforderungOptionalWerte und Limits
Minimum: 1
Maximum: 1
Standard—
Feldinput_referencesTyparrayAnforderungOptionalWerte und Limits
Mindestanzahl Elemente: 0
Maximale Anzahl Elemente: 8
Standard—
FeldproviderTypobjectAnforderungOptionalWerte und LimitsStandard—
Methodenparameter und Lebenszyklus
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, prompt
Parametermaterial_typesVertragtext, 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.

KonfigurationTarifstaffelPrognostizierte MengeAbrechnungseinheitGebühr
KonfigurationToken-BasistarifeTarifstaffelGrundtarifPrognostizierte 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 AusgabebildsTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro Megapixel des AusgabebildesGebühr
Ausgabe · Megapixel des Ausgabebilds · Schätzung nur zum Vergleich $0.06 pro Megapixel des Ausgabebildes
KonfigurationGeschätzte ErzeugungskostenTarifstaffel—Prognostizierte MengeSchätzung für eine GenerierungAbrechnungseinheit—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 abschliessenden 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
FeldTyp
FeldcreatedTyp
Felddata[].urlTyp
Felddata[].b64_jsonTyp
FeldusageTyp

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

Weitere Details

Verbinden Sie Ailoot mit Claude Code, OpenCode, Hermes oder Ihrer eigenen Anwendung.

Das Unternehmen und sein Projektportfolio

Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.

Tokens mit Rabatt kaufen.

Aborabatt für regelmäßige Arbeit. Aktionscodes bieten bis 50% beim Tokenkauf.

Abo
Wählen Sie einen Tarif mit Rabatt für Ihre regelmäßigen Anfragen.
Aktionscode bis 50%
Geben Sie den Code beim Kauf ein. Der Preis wird nach den gültigen Aktionsbedingungen berechnet.
Ausgaben in der Historie
Modell, Tokens und Betrag werden für jede Anfrage gespeichert.

Abo wählen · Modellpreise ansehen

Verbinden Sie die API mit dem Produkt, das Sie verkaufen.

SaaS, Anwendungen und Bots nach dem offiziellen Angebot und Lizenzvertrag von Ailoot. Fordern Sie für den Weiterverkauf eine Reseller-Lizenz an.

Kommerzielle Anwendung
Integrieren Sie Text-, Bild-, Video- und Audioerzeugung in kostenpflichtige Funktionen Ihres Dienstes.
Reseller-Lizenz
Senden Sie Projektbeschreibung und Zugangsmodell. Fordern Sie schriftliche Nutzungs- und Weiterverkaufsbedingungen an.
Dokumente auf der Website
Offizielles Angebot, Lizenzvertrag und Datenschutzerklärung sind vor der Verbindung zugänglich.

Reseller-Lizenz anfordern · Offizielles Angebot und Lizenzvertrag