Black Forest Labs: FLUX.2 Klein 4B

FLUX.2 [klein] 4B är Black Forest Labs kompakta, stegdestillerade bildmodell för textstyrt skapande och redigering med upp till fyra referenser. Dess fyrstegsdesign stöder interaktivt visuellt arbete och behåller en separat identitet från den odestillerade utgåvan Base 4B.

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

Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

FLUX.2 [klein] 4B är Black Forest Labs kompakta modell för att skapa en bild från en textbeskrivning och redigera bilder med visuella referenser. Dess rectified-flow-transformer med fyra miljarder parametrar samlar generering och redigering i en arkitektur. Den namngivna utgåvan 4B är stegdestillerad och tillverkarens referensexempel använder fyra inferenssteg.

Modellens roll är ett interaktivt visuellt utkast eller en revidering: utforska en produktscen, ändra en karaktärs kläder, kombinera ett motiv med en miljö eller förfina en illustrations utseende. Börja med händelsen eller kompositionen som spelar roll och beskriv sedan motiv, material, belysning och synvinkel. En konkret instruktion kan placera en matt blå keramikkopp på ett bord av ljus ek, med en sidobelyst närbild som håller handtag och glasyr synliga. Resultatet är en bild att granska mot dessa beslut.

Redigering med en liten referensuppsättning

Den dokumenterade profilen 4B tar emot upp till fyra indatabilder. Ge varje bild en tydlig roll: produktutseende, karaktär, miljö eller stil. Om en bild är scenen som ska redigeras identifierar du den och anger både ändringen och detaljerna som ska bevaras. Behåll till exempel koppens silhuett och yta från första bilden, använd rummet från den andra och byt bara överdraget på bordet. Referensordning och en precis ändringsinstruktion ger revideringen ett tydligare mål än en begäran om allmän förbättring.

Tillverkaren skiljer denna kompakta referensbudget från de större FLUX.2-varianterna. Den anger även att [klein] saknar promptutökning. Ange själv den viktiga beskrivande informationen, inklusive relationen mellan refererade föremål, i stället för att förlita dig på automatisk utökning av en kort etikett. För en serie behåller du samma motivreferens och visuella krav medan du ändrar ett scenbeslut åt gången.

Utdatainställningar och gränser mellan utgåvor

Tillverkarens specifika profil 4B listar JPEG, PNG och WebP som utdata, med JPEG som standard. Uttrycklig bredd och höjd dokumenteras med minst 64 pixlar vardera; modellkortets referensexempel använder en bild på 1024×1024. Exemplet är en samplingskonfiguration, inte ett påstående att varje uppgift måste vara kvadratisk eller att 1024 pixlar är modellens maxgräns. Välj avsedd beskärning och visningsform innan den visuella instruktionen förbereds och jämför sedan fin text och små detaljer i den storleken.

Det publicerade fyrstegsexemplet använder guidance_scale 1.0. Håll denna destillerade utgåva åtskild från FLUX.2 [klein] Base 4B, vars odestillerade träningssignal är avsedd för anpassning, LoRA-träning och forskning. Base 4B och modellerna 9B är separata val, med olika överväganden för förberedelse och sampling. Den kompakta modellens standardkontroller skiljer sig även från [flex]s justerbara steg och guidance; [max] har en egen funktion för informationsförankrande sökning.

Detaljer att kontrollera i bilden

Det specifika modellkortet säger att modellen inte är en källa till faktainformation. Skriven text i en bild kan vara felaktig eller förvrängd och den genererade scenen kan avvika från förfrågan. Promptstilen har stor påverkan på följsamheten. Kontrollera stavning, mängder, etiketter, motividentitet och de specifika föremål som skulle bevaras; en attraktiv komposition bevisar inte att en produktfunktion eller illustrerad uppgift är korrekt. Tillverkaren påpekar även att statistiska utdata kan återspegla snedvridningar i träningsdata.

För ett granskat material behåller du källreferenser, slutlig ordalydelse och vald modellidentitet med bilden. Utgivningsdokumentationen skiljer vattenmärkning på pixelnivå i referenskodens exempel från C2PA-proveniensmetadata som tillämpas i tillverkarens värdbaserade utdataflöde. Bevarad returnerad proveniens hjälper till att förklara materialets ursprung; det är separat från att kontrollera om den begärda visuella ändringen lyckades.

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

black-forest-labs/flux.2-klein-4b

Black Forest Labs /black-forest-labs/flux.2-klein-4b

Start

Godkända indata: Text · Bilder
Resultat: Bilder

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Bilder POST /v1/images/generations

Indatatyper: text, image
Utdatatyper: image

Fält	Typ	Krav	Värden & gränser	Standard
Fält`model`	Typ`string`	KravObligatoriskt	Värden & gränser black-forest-labs/flux.2-klein-4b	Standard—
Fält`prompt`	Typ`string`	KravObligatoriskt	Värden & gränser Minsta längd: 1	Standard—
Fält`aspect_ratio`	Typ`string`	KravValfritt	Värden & gränser 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Standard—
Fält`output_format`	Typ`string`	KravValfritt	Värden & gränser png, jpeg	Standard—
Fält`n`	Typ`integer`	KravValfritt	Värden & gränser Minimum: 1 Maximum: 1	Standard—
Fält`input_references`	Typ`array`	KravValfritt	Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 4	Standard—
Fält`provider`	Typ`object`	KravValfritt	Värden & gränser	Standard—

Metodparametrar och livscykel

Parameter	Avtal
Parameter`content_type`	Avtalapplication/json
Parameter`required`	Avtalmodel, prompt
Parameter`material_types`	Avtaltext, image

Livscykel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Priser

Så beräknas slutavgiften

De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge: Ej angivet När snabbt läge är valt
Flex-läge: Ej angivet När läget flex är valt
Högsta resonemangsnivå: Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Uppskattade priser för jämförelse

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

Konfiguration	Prislista	Prognostiserad mängd	Debiteringsenhet	Avgift
KonfigurationGrundpriser för token	PrislistaGrundpris	Prognostiserad mängd—	Debiteringsenhet—	Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token
Konfigurationmegapixel i utdatabild	Prislista—	Prognostiserad mängd—	Debiteringsenhetper megapixel utdatabild	Avgift Utdata · megapixel i utdatabild · Uppskattning endast för jämförelse $0.028 per megapixel utdatabild
KonfigurationUppskattad genereringskostnad	Prislista—	Prognostiserad mängduppskattning för en generering	Debiteringsenhet—	Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.028 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Exempelbegäranden

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-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

Ta emot och spara resultat

Ailoot Ultra · Bilder

Ladda ned varje returnerad bild eller spara dess Base64-innehåll

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Andra innehållsläsningar

Läs befintliga resurser som tillhör dig

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.

Behåll alla färdiga resultat

Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.

Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.

Om det ursprungliga svaret behöver kontrolleras

Behåll det returnerade värdet för X-Client-Request-ID för avstämning. Läs endast av resultat via de task_id/asset_id-värden som faktiskt returnerades eller via det mediebibliotek som tillhör dig. Bygg aldrig en uppgifts-URL från operations-ID:t och skicka aldrig skapandeförfrågan igen.

Svarsfält

Fält	Typ
Fält`created`	Typ
Fält`data[].url`	Typ
Fält`data[].b64_json`	Typ
Fält`usage`	Typ

Alias

Modellalias

Ailoot Ultra black-forest-labs/flux.2-klein-4b

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

black-forest-labs/flux.2-klein-4b

FAQ · Black Forest Labs: FLUX.2 Klein 4B

Vilka indata och resultat finns?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: text, image → image
Vilka fält använder begäran?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: model, prompt, aspect_ratio, output_format, n, input_references, provider
Vilka gränser gäller?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Klein 4B