Black Forest Labs: FLUX.2 Klein 4B
FLUX.2 [klein] 4B ist das kompakte, schrittdestillierte Bildmodell von Black Forest Labs für textgestützte Erstellung und Bearbeitung mit bis zu vier Referenzen. Sein Vier-Schritte-Design unterstützt interaktive Bildarbeit und bleibt zugleich eine eigene Ausgabe gegenüber der nicht destillierten Variante Base 4B.
Ü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 [klein] 4B ist das kompakte Modell von Black Forest Labs zur Erstellung eines Bilds aus einer Textbeschreibung und zur Bildbearbeitung mit visuellen Referenzen. Sein Rectified-Flow-Transformer mit vier Milliarden Parametern vereint Generierung und Bearbeitung in einer Architektur. Die benannte 4B-Ausgabe ist schrittdestilliert, und das Referenzbeispiel des Herstellers nutzt vier Inferenzschritte.
Das Modell dient einem interaktiven Bildentwurf oder einer Überarbeitung: eine Produktszene erkunden, Kleidung einer Figur ändern, ein Motiv mit einer Umgebung kombinieren oder das Aussehen einer Illustration verfeinern. Beginnen Sie mit dem entscheidenden Ereignis oder der Komposition und beschreiben Sie anschließend Motiv, Material, Beleuchtung und Blickwinkel. Ein konkretes Briefing könnte eine mattblaue Keramiktasse auf einen hellen Eichentisch stellen, in einer seitlich beleuchteten Nahansicht, die Griff und Glasur sichtbar hält. Das Ergebnis ist ein Bild, das anhand dieser Entscheidungen geprüft werden kann.
Mit einem kleinen Referenzsatz bearbeiten
Das dokumentierte Profil 4B akzeptiert bis zu vier Eingabebilder. Weisen Sie jedem eine klare Rolle zu: Produkterscheinung, Figur, Umgebung oder Stil. Ist ein Bild die zu bearbeitende Szene, benennen Sie es und geben Sie sowohl Änderung als auch zu bewahrende Details an. Bewahren Sie beispielsweise Silhouette und Oberfläche der Tasse aus dem ersten Bild, verwenden Sie den Raum aus dem zweiten und tauschen Sie nur die Tischdecke aus. Referenzreihenfolge und eine genaue Änderungsanweisung geben der Überarbeitung ein klareres Ziel als die Bitte um eine allgemeine Verbesserung.
Der Hersteller unterscheidet dieses kompakte Referenzbudget von den größeren FLUX.2-Varianten. Er erklärt außerdem, dass [klein] kein Prompt-Upsampling besitzt. Liefern Sie wichtige beschreibende Informationen selbst, einschließlich der Beziehung zwischen referenzierten Objekten, statt sich auf die automatische Erweiterung einer kurzen Bezeichnung zu verlassen. Behalten Sie für eine Serie dieselbe Motivreferenz und dieselben visuellen Anforderungen bei und ändern Sie jeweils eine Szenenentscheidung.
Ausgabeeinstellungen und Grenzen zwischen Ausgaben
Das konkrete Profil 4B des Anbieters nennt JPEG, PNG und WebP als Ausgabe, standardmäßig JPEG. Ausdrückliche Breiten- und Höhenwerte sind jeweils mit mindestens 64 Pixeln dokumentiert; das Referenzbeispiel der Modellkarte verwendet ein Bild mit 1024×1024. Dieses Beispiel ist eine Sampling-Konfiguration und keine Aussage, dass jede Aufgabe quadratisch sein muss oder 1024 Pixel die Modellhöchstgrenze darstellen. Wählen Sie gewünschten Zuschnitt und Darstellungsformat vor dem Bildbriefing und vergleichen Sie anschließend feine Schrift und kleine Merkmale in dieser Größe.
Das veröffentlichte Vier-Schritte-Beispiel nutzt guidance_scale 1.0. Halten Sie diese destillierte Ausgabe von FLUX.2 [klein] Base 4B getrennt, dessen nicht destilliertes Trainingssignal für Anpassung, LoRA-Training und Forschung vorgesehen ist. Base 4B und die 9B-Modelle sind eigene Optionen mit anderen Überlegungen zu Vorbereitung und Sampling. Die Standardsteuerungen des kompakten Modells unterscheiden sich außerdem von den einstellbaren Schritten und der Guidance von [flex]; [max] hat seine eigene Fähigkeit zur Fundierung durch Suche.
Im Bild zu prüfende Details
Die konkrete Modellkarte erklärt, dass dieses Modell keine Quelle für Sachinformationen ist. Geschriebener Text im Bild kann ungenau oder verzerrt sein, und die generierte Szene kann von der Anfrage abweichen. Der Prompt-Stil beeinflusst die Anweisungstreue erheblich. Prüfen Sie Schreibweise, Mengen, Beschriftungen, Motividentität und die konkreten Objekte, die erhalten bleiben sollen. Eine attraktive Komposition belegt weder die Richtigkeit eines Produktmerkmals noch einer illustrierten Tatsache. Der Hersteller weist zudem darauf hin, dass statistische Ausgaben Verzerrungen aus den Trainingsdaten widerspiegeln können.
Bewahren Sie für ein geprüftes Asset Quellreferenzen, endgültigen Wortlaut und gewählte Modellidentität mit dem Bild auf. Die Veröffentlichungsdokumentation unterscheidet beispielhafte Wasserzeichen auf Pixelebene im Referenzcode von C2PA-Herkunftsmetadaten, die im gehosteten Ausgabeablauf des Herstellers angebracht werden. Die Bewahrung zurückgegebener Herkunftsnachweise hilft, den Ursprung eines Assets zu erklären; sie ist von der Prüfung zu trennen, ob die angeforderte Bildänderung gelungen ist.
Ailoot Ultra · Bilder POST /v1/images/generations black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4bStart
FLUX.2 [klein] 4B ist das kompakte, schrittdestillierte Bildmodell von Black Forest Labs für textgestützte Erstellung und Bearbeitung mit bis zu vier Referenzen. Sein Vier-Schritte-Design unterstützt interaktive Bildarbeit und bleibt zugleich eine eigene Ausgabe gegenüber der nicht destillierten Variante Base 4B.
- 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-klein-4b | 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: 4 | 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.028 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.028 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-klein-4b', '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-klein-4b
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Black Forest Labs: FLUX.2 Klein 4B
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:model,prompt,aspect_ratio,output_format,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:n.minimum:1;n.maximum:1