Black Forest Labs: FLUX.2 Klein 4B
FLUX.2 [klein] 4B is het compacte, via stapdistillatie ontwikkelde afbeeldingsmodel van Black Forest Labs voor creatie vanuit tekst en bewerking met maximaal vier referenties. Het ontwerp met vier stappen ondersteunt interactief visueel werk en behoudt een afzonderlijke identiteit ten opzichte van de niet-gedistilleerde Base 4B-editie.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
FLUX.2 [klein] 4B is het compacte model van Black Forest Labs om een afbeelding vanuit een tekstbeschrijving te maken en afbeeldingen met visuele referenties te bewerken. De rectified-flow-transformer met vier miljard parameters combineert generatie en bewerking in één architectuur. De benoemde 4B-editie is via stapdistillatie ontwikkeld en het referentievoorbeeld van de fabrikant gebruikt vier inferentiestappen.
De rol van het model is een interactief visueel concept of een revisie: verken een productscène, verander de kleding van een personage, combineer een onderwerp met een omgeving of verfijn het uiterlijk van een illustratie. Begin met de gebeurtenis of compositie die telt en beschrijf daarna onderwerp, materiaal, belichting en standpunt. Een concrete briefing kan een matblauwe keramische kop op een licht eiken tafel plaatsen, met een close-up in zijlicht waarin oor en glazuur zichtbaar blijven. Het resultaat is een afbeelding om aan die beslissingen te toetsen.
Bewerken met een kleine referentieset
Het gedocumenteerde 4B-profiel accepteert maximaal vier invoerafbeeldingen. Geef elke afbeelding een duidelijke rol: productuiterlijk, personage, omgeving of stijl. Benoem de afbeelding als een ervan de te bewerken scène is en geef zowel de wijziging als de te behouden details aan. Behoud bijvoorbeeld het silhouet en oppervlak van de kop uit de eerste afbeelding, gebruik de kamer uit de tweede en vervang alleen de tafelbedekking. Referentievolgorde en een precieze wijzigingsinstructie geven de revisie een duidelijker doel dan een algemene verbetering vragen.
De fabrikant onderscheidt dit compacte referentiebudget van de grotere FLUX.2-varianten. Ook vermeldt de fabrikant dat [klein] geen prompt upsampling heeft. Lever de belangrijke beschrijvende informatie zelf aan, inclusief de relatie tussen gerefereerde objecten, in plaats van op automatische uitbreiding van een kort label te vertrouwen. Behoud voor een reeks dezelfde onderwerpreferentie en visuele eisen terwijl je telkens één scènebeslissing verandert.
Uitvoerinstellingen en grenzen tussen edities
Het specifieke 4B-profiel van de producent vermeldt JPEG-, PNG- en WebP-uitvoer, met standaard JPEG. Expliciete waarden voor breedte en hoogte zijn gedocumenteerd met elk minimaal 64 pixels; het referentievoorbeeld op de modelkaart gebruikt een afbeelding van 1024×1024. Dat voorbeeld is een samplingconfiguratie en geen bewering dat elke taak vierkant moet zijn of dat 1024 pixels het modelmaximum is. Kies de gewenste uitsnede en weergavevorm voordat je de visuele briefing voorbereidt en vergelijk daarna kleine letters en kenmerken op dat formaat.
Het gepubliceerde voorbeeld met vier stappen gebruikt guidance_scale 1.0. Houd deze gedistilleerde editie gescheiden van FLUX.2 [klein] Base 4B, waarvan het niet-gedistilleerde trainingssignaal bedoeld is voor aanpassing, LoRA-training en onderzoek. Base 4B en de 9B-modellen zijn afzonderlijke keuzes, met andere overwegingen voor voorbereiding en sampling. De standaardinstellingen van het compacte model verschillen ook van de instelbare stappen en guidance van [flex]; [max] heeft een eigen grounding-zoekfunctie.
Details om in de afbeelding te controleren
De specifieke modelkaart zegt dat dit model geen bron van feitelijke informatie is. Geschreven tekst in een afbeelding kan onjuist of vervormd zijn en de gegenereerde scène kan afwijken van de aanvraag. Promptstijl heeft veel invloed op het volgen van instructies. Controleer spelling, hoeveelheden, labels, onderwerpidentiteit en de specifieke objecten die behouden moesten blijven; een aantrekkelijke compositie bewijst niet dat een productkenmerk of geïllustreerd feit klopt. De maker merkt ook op dat statistische uitvoer vooroordelen uit de trainingsdata kan weerspiegelen.
Bewaar voor een beoordeeld beeld de bronreferenties, definitieve formulering en gekozen modelidentiteit bij de afbeelding. De releasedocumentatie onderscheidt voorbeeldwatermerken op pixelniveau in referentiecode van C2PA-herkomstmetadata die in de gehoste uitvoerprocedure van de fabrikant wordt toegepast. Bewaren van geretourneerde herkomstinformatie helpt de oorsprong van een beeld uit te leggen; dit staat los van controleren of de gevraagde visuele wijziging is geslaagd.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4bAan de slag
FLUX.2 [klein] 4B is het compacte, via stapdistillatie ontwikkelde afbeeldingsmodel van Black Forest Labs voor creatie vanuit tekst en bewerking met maximaal vier referenties. Het ontwerp met vier stappen ondersteunt interactief visueel werk en behoudt een afzonderlijke identiteit ten opzichte van de niet-gedistilleerde Base 4B-editie.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoertypen
text,image- Uitvoertypen
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten black-forest-labs/flux.2-klein-4b | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standaard— |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten png, jpeg | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 4 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| Configuratiemegapixel van een uitvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper megapixel van de uitvoerafbeelding | Kosten Uitvoer · megapixel van een uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.028 per megapixel van de uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.028 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Afbeeldingen
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
Resultaten ophalen en opslaan
Ailoot Ultra · Afbeeldingen
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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 voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra black-forest-labs/flux.2-klein-4b
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Black Forest Labs: FLUX.2 Klein 4B
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:model,prompt,aspect_ratio,output_format,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:n.minimum:1;n.maximum:1