Black Forest Labs: FLUX.2 Flex
FLUX.2 [flex] spezialisiert sich auf Typografie im Bild und kleine Bilddetails, mit einstellbaren Sampling-Schritten und Guidance. Entwickeln Sie mit Text und Bildreferenzen Poster, Produktlayouts oder präzise Überarbeitungen und stimmen Sie dabei Anweisungstreue und Realismus aufeinander ab.
Ü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 [flex] ist die auf Typografie, Textdarstellung und Bewahrung kleiner Details spezialisierte Ausgabe von Black Forest Labs für Bildgenerierung und -bearbeitung. Sie erzeugt ein Bild anhand geschriebener Szenenanweisungen und Bildreferenzen. Ihre kennzeichnende Steuerung ist einstellbares Sampling: Das dokumentierte Profil stellt sowohl Inferenzschritte als auch Guidance bereit, sodass sich ein Bildbriefing durch Einstellungen ebenso wie durch Worte verfeinern lässt.
Schrift und feine Details
Eine Typografieaufgabe sollte mit dem tatsächlichen Text beginnen. Setzen Sie jede Zeile in Anführungszeichen, bestimmen Sie ihren Ort und unterscheiden Sie Überschrift, Begleittext und Beschriftung. Beschreiben Sie Schriftstil, Größe und Farbe in Bezug zur Szene. Ein eigenständiges Posterbriefing könnte ein kobaltblaues Fahrrad in einem hellen Studio zeigen, mit einem großen Titel über dem Rahmen und einer kleineren Spezifikationszeile darunter. Das Bild muss Produkt und Lesereihenfolge gemeinsam verständlich machen.
Benennen Sie für eine detaillierte Produktvisualisierung die Teile, die über den Nutzen des Ergebnisses entscheiden: Zifferblatt, Bedienbeschriftung, Naht, Materialkante oder Verpackungskennzeichnung. Stellen Sie eine lesbare Referenz bereit und erläutern Sie, welches Merkmal sie festlegt. Eine allgemein ähnlich aussehende Szene kann dennoch ein entscheidendes Zeichen oder Bauteil verändern. Vergleichen Sie daher das erzeugte Detail in seiner vorgesehenen Darstellungsgröße. Die Spezialisierung des Modells ist ein Grund für genaue Anforderungen, keine Garantie dafür, dass Korrekturlesen oder Bildprüfung entfallen.
Schritte und Guidance erfüllen unterschiedliche Zwecke
Das konkrete Herstellerprofil akzeptiert ein bis fünfzig Inferenzschritte, standardmäßig fünfzig. Seine Beschreibung verbindet mehr Schritte mit höherer Detailtreue und größerem Realismus. Guidance reicht von 1,5 bis 10, mit 5 als Standard. Höhere Guidance verstärkt die Treue zum Prompt, kann aber den Realismus verringern. Ein Bild mit exakten Designanweisungen und eines mit dem Ziel einer natürlichen fotografischen Erscheinung können deshalb innerhalb dieses Profils unterschiedliche Einstellungen verlangen.
Halten Sie Wortlaut, Referenzen und Ausgabeformat konstant, wenn Sie eine Einstellungsänderung vergleichen. Betrachten Sie das Merkmal, das zur Änderung führte: Buchstabenformen, Objektplatzierung oder Materialtextur. Ändern Sie eine Einstellung aus einem konkreten visuellen Grund, statt eine hohe Zahl automatisch für besser zu halten. Dies sind Sampling-Steuerungen des Anbieters; das destillierte Vier-Schritte-Profil [klein] und die Standardsteuerungen von [pro] oder [max] sind andere Modelloptionen.
Prompt-Upsampling ist in der [flex]-Spezifikation standardmäßig aktiv und lässt sich über die eigene Steuerung prompt_upsampling deaktivieren. So bleibt ein detailliertes Briefing bei Bedarf der bereitgestellte Text. Der gemeinsame Herstellerleitfaden empfiehlt, Hauptmotiv und wichtige Handlung vor zweitrangiger Dekoration zu nennen, und beschreibt JSON-strukturierte Prompts neben natürlichsprachlichen Briefings. Nutzen Sie die Struktur, in der sich die erforderlichen Beziehungen am leichtesten festlegen lassen.
Referenzgestützte Überarbeitungen
Das konkrete Anfrageprofil enthält acht Positionen für Referenzbilder. Der interaktive Herstellerablauf erlaubt separat bis zu zehn Bilder; diese Zahlen beschreiben unterschiedliche Schnittstellen. Legen Sie fest, ob ein Bild die zu bearbeitende Szene, ein Produkt, eine Figur, Kleidung oder einen Stil liefert. Benennen Sie für eine Überarbeitung Objekt und Änderung sowie die umgebende Komposition, Materialien oder das Licht, die erhalten bleiben sollen.
Eine eigenständige Verpackungsaufgabe könnte den Karton aus dem ersten Bild und das Finish aus einem zweiten verwenden, das vordere Etikett durch den freigegebenen Wortlaut ersetzen und die Kartonproportionen bewahren. Eine Gruppenkomposition kann jedem Motiv eine eigene Referenz zuweisen und diese Zuordnungen konstant halten. Die Familienbeispiele umfassen Objekt- und Hintergrundänderungen, Compositing, Textbearbeitung und Stilumwandlungen. Fordern Sie eine zusammenhängende Überarbeitung mit klarem Ziel an und vergleichen Sie danach sowohl den bearbeiteten Bereich als auch die Teile, die stabil bleiben sollen.
Größe, Farbe und das zurückgegebene Bild
Der FLUX.2-Leitfaden dokumentiert mindestens 64×64 Pixel, Abmessungen in Vielfachen von 16 und Ausgaben bis zu 4 Megapixeln, wobei bis zu 2 Megapixel für gewöhnliche Nutzung empfohlen werden. Die konkrete [flex]-Spezifikation nennt JPEG, PNG und WebP, standardmäßig JPEG. Sie bietet außerdem einen optionalen Zufalls-Seed. Bewahren Sie tatsächliches Modell, Seed und Sampling-Einstellungen mit den Quellreferenzen auf, wenn Sie Versionen vergleichen; ein Familienname allein benennt nicht die vollständige Generierungskonfiguration.
Ordnen Sie für farbkritische Arbeit jeden Hex-Code einem benannten Objekt oder Textelement zu. Legen Sie für die Komposition das gewünschte Seitenverhältnis über die Bildabmessungen fest und lassen Sie ausreichend Platz für lesbare Schrift. Der gemeinsame Leitfaden hat keinen Mechanismus für negative Prompts. Beschreiben Sie deshalb das gewünschte Aussehen positiv: scharfer Fokus, sauberer Hintergrund oder eine deutlich freie Fläche für Text. Seine mehrsprachigen Beispiele unterstützen ein kulturell spezifisches Briefing in der passenden Sprache, begründen aber keine Garantie für eine feste Anzahl unterstützter Sprachen.
Der FLUX.2-Ablauf des Anbieters liefert nach Verarbeitung ein Bild und verwendet temporäre signierte Links mit einem Abruffenster von zehn Minuten. Bewahren Sie das eigentliche Bild und das Briefing gemeinsam auf. Prüfen Sie Typografie, feine Details, Referenzidentität und visuelle Gestaltung, bevor Sie das Asset in ein Layout einsetzen. Das endgültige Ergebnis kann ein ausgewähltes Poster, Produktbild oder eine bearbeitete Komposition sein, deren genaue Einstellungen für die nächste Überarbeitung erhalten bleiben.
Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux.2-flex
black-forest-labs/flux.2-flexStart
FLUX.2 [flex] spezialisiert sich auf Typografie im Bild und kleine Bilddetails, mit einstellbaren Sampling-Schritten und Guidance. Entwickeln Sie mit Text und Bildreferenzen Poster, Produktlayouts oder präzise Überarbeitungen und stimmen Sie dabei Anweisungstreue und Realismus aufeinander ab.
- 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-flex | 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 Eingabebildes | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Megapixel des Eingabebildes | Gebühr Eingabe · Megapixel des Eingabebildes · Schätzung nur zum Vergleich $0.12 pro Megapixel des Eingabebildes |
| KonfigurationMegapixel des Ausgabebildes | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Megapixel des Ausgabebildes | Gebühr Ausgabe · Megapixel des Ausgabebildes · Schätzung nur zum Vergleich $0.12 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.12 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-flex', '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-flex
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Black Forest Labs: FLUX.2 Flex
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·black-forest-labs/flux.2-flex:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·black-forest-labs/flux.2-flex:model,prompt,aspect_ratio,output_format,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·black-forest-labs/flux.2-flex:n.minimum:1;n.maximum:1