Black Forest Labs: FLUX.2 Klein 4B
FLUX.2 [klein] 4B je kompaktný obrazový model Black Forest Labs destilovaný na malý počet krokov pre tvorbu vedenú textom a úpravy s najviac štyrmi referenciami. Jeho štvorkrokový návrh podporuje interaktívnu vizuálnu prácu a zachováva samostatnú identitu oproti nedestilovanej edícii Base 4B.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
FLUX.2 [klein] 4B je kompaktný model Black Forest Labs na vytváranie obrázka z textového opisu a úpravu obrázkov s vizuálnymi referenciami. Jeho rectified-flow transformer so štyrmi miliardami parametrov spája generovanie a úpravy v jednej architektúre. Pomenovaná edícia 4B je destilovaná na malý počet krokov a referenčný príklad výrobcu používa štyri inferenčné kroky.
Úlohou modelu je interaktívny vizuálny návrh alebo revízia: preskúmať produktovú scénu, zmeniť odev postavy, spojiť subjekt s prostredím alebo doladiť vzhľad ilustrácie. Začnite dôležitou udalosťou či kompozíciou a potom opíšte subjekt, materiál, osvetlenie a uhol pohľadu. Konkrétne zadanie môže umiestniť matnú modrú keramickú šálku na svetlý dubový stôl, v blízkom pohľade s bočným svetlom, ktorý zachová viditeľné uško a glazúru. Výsledkom je obrázok na porovnanie s týmito rozhodnutiami.
Úpravy s malou zostavou referencií
Dokumentovaný profil 4B prijíma až štyri vstupné obrázky. Každému priraďte jasnú úlohu: vzhľad produktu, postava, prostredie alebo štýl. Ak jeden obrázok predstavuje scénu na úpravu, určte ho a uveďte zmenu aj detaily na zachovanie. Napríklad zachovajte siluetu a povrch šálky z prvého obrázka, použite miestnosť z druhého a nahraďte iba prikrývku stola. Poradie referencií a presný pokyn na zmenu dávajú revízii jasnejší cieľ než žiadosť o všeobecné zlepšenie.
Výrobca rozlišuje tento kompaktný referenčný rozpočet od väčších variantov FLUX.2. Uvádza aj to, že [klein] nemá rozšírenie zadania. Dôležité opisné informácie vrátane vzťahu medzi referenčnými objektmi dodajte sami namiesto spoliehania sa na automatické rozšírenie krátkeho označenia. Pri sérii zachovávajte rovnakú referenciu subjektu a vizuálne požiadavky a meňte vždy jedno rozhodnutie o scéne.
Nastavenia výstupu a hranice edície
Presný profil 4B výrobcu uvádza výstup JPEG, PNG a WebP s predvoleným JPEG. Explicitná šírka a výška sú dokumentované s minimom 64 pixelov pre každú; príklad referenčnej karty modelu používa obrázok 1024×1024. Tento príklad je konfiguráciou vzorkovania, nie tvrdením, že každá úloha musí byť štvorcová alebo že 1024 pixelov je maximum modelu. Zamýšľaný výrez a formát zobrazenia zvoľte pred prípravou vizuálneho zadania a potom pri tejto veľkosti porovnajte jemné písmo a drobné prvky.
Publikovaný štvorkrokový príklad používa guidance_scale 1.0. Túto destilovanú edíciu udržujte oddelenú od FLUX.2 [klein] Base 4B, ktorého nedestilovaný tréningový signál je určený na adaptáciu, tréning LoRA a výskum. Base 4B a modely 9B sú samostatné voľby s odlišnými nárokmi na prípravu a vzorkovanie. Štandardné ovládanie kompaktného modelu sa tiež líši od nastaviteľných krokov a guidance pri [flex]; [max] má vlastnú schopnosť vyhľadávania na ukotvenie v zdrojoch.
Detaily na overenie v obrázku
Presná karta modelu uvádza, že tento model nie je zdrojom faktických informácií. Písaný text v obrázku môže byť nepresný alebo skreslený a generovaná scéna sa môže od požiadavky odchýliť. Štýl zadania významne ovplyvňuje dodržiavanie pokynov. Kontrolujte pravopis, množstvá, štítky, identitu subjektu a konkrétne objekty určené na zachovanie; príťažlivá kompozícia nepotvrdzuje správnosť produktovej vlastnosti ani ilustrovaného faktu. Výrobca tiež poznamenáva, že štatistické výstupy môžu odrážať skreslenia tréningových dát.
Pri posúdenom vizuáli uchovajte zdrojové referencie, konečné znenie a zvolenú identitu modelu spolu s obrázkom. Dokumentácia vydania rozlišuje ukážkové vodoznaky na úrovni pixelov v referenčnom kóde od metadát pôvodu C2PA používaných v hostovanom výstupnom postupe výrobcu. Uchovanie vrátených údajov o pôvode pomáha vysvetliť pôvod vizuálu; je oddelené od overenia, či požadovaná vizuálna zmena uspela.
Ailoot Ultra · Obrázky POST /v1/images/generations black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4bÚvod
FLUX.2 [klein] 4B je kompaktný obrazový model Black Forest Labs destilovaný na malý počet krokov pre tvorbu vedenú textom a úpravy s najviac štyrmi referenciami. Jeho štvorkrokový návrh podporuje interaktívnu vizuálnu prácu a zachováva samostatnú identitu oproti nedestilovanej edícii Base 4B.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Obrázky POST /v1/images/generations
- Vstup
text,image- Výstup
image
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity black-forest-labs/flux.2-klein-4b | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Predvolené— |
Poleoutput_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity png, jpeg | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 1 | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 4 | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parametermaterial_types | Špecifikáciatext, image |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacia jednotka | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| Konfiguráciamegapixel výstupného obrázka | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza megapixel výstupného obrázka | Poplatok Výstup · megapixel výstupného obrázka · Odhad iba na porovnanie $0.028 za megapixel výstupného obrázka |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.028 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · Obrázky
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
Prijať a uložiť výsledky
Ailoot Ultra · Obrázky
Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Čítanie ďalšieho obsahu
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.
Uchovať všetky dokončené výsledky
Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.
Ak treba overiť pôvodnú odpoveď
Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.
Polia odpovede
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Aliasy
Aliasy modelov
Ailoot Ultra black-forest-labs/flux.2-klein-4b
Aliasy ciest metód
/v1/images
Súvisiace ID na volanie
FAQ · Black Forest Labs: FLUX.2 Klein 4B
- Aké vstupy a výsledky sú dostupné?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:text,image→image- Aké polia používa požiadavka?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:model,prompt,aspect_ratio,output_format,n,input_references,provider- Aké limity platia?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:n.minimum:1;n.maximum:1