Black Forest Labs: FLUX.2 Klein 4B

FLUX.2 [klein] 4B yra kompaktiškas Black Forest Labs vaizdų modelis su distiliuotu generavimo žingsnių skaičiumi, skirtas kūrimui iš teksto ir redagavimui su iki keturių orientyrų. Keturių žingsnių sandara palaiko interaktyvų vaizdinį darbą, išlaikydama atskirą tapatybę nuo nedistiliuotos Base 4B versijos.

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

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

FLUX.2 [klein] 4B yra kompaktiškas Black Forest Labs modelis vaizdui kurti iš tekstinio aprašymo ir vaizdams redaguoti su vaizdiniais orientyrais. Jo keturių milijardų parametrų ištiesinto srauto transformeris sujungia generavimą ir redagavimą vienoje architektūroje. Įvardyta 4B versija turi distiliuotą žingsnių skaičių, o gamintojo pavyzdys naudoja keturis inferencijos žingsnius.

Modelio vaidmuo – interaktyvus vaizdinis juodraštis arba pataisa: ieškoti produkto scenos, keisti personažo aprangą, derinti objektą su aplinka arba tikslinti iliustracijos išvaizdą. Pradėkite nuo svarbaus įvykio arba kompozicijos, tada aprašykite objektą, medžiagą, apšvietimą ir žiūros tašką. Konkreti užduotis gali padėti matinį mėlyną keraminį puodelį ant šviesaus ąžuolo stalo, stambiame šonine šviesa apšviestame plane, išlaikant matomą jo ąselę ir glazūrą. Rezultatas – vaizdas, kurį reikia patikrinti pagal šiuos sprendimus.

Redagavimas su nedideliu orientyrų rinkiniu

Dokumentuotas 4B profilis priima iki keturių įvesties vaizdų. Kiekvienam priskirkite aiškų vaidmenį: produkto išvaizdą, personažą, aplinką arba stilių. Jei vienas vaizdas yra redaguotina scena, įvardykite jį ir nurodykite pakeitimą bei išsaugotinas detales. Pavyzdžiui, išsaugokite puodelio siluetą ir paviršių iš pirmo vaizdo, naudokite kambarį iš antro ir pakeiskite tik stalo užtiesalą. Orientyrų tvarka ir tikslus pakeitimo nurodymas suteikia pataisai aiškesnį tikslą nei bendras prašymas pagerinti.

Gamintojas šį kompaktišką orientyrų limitą skiria nuo didesnių FLUX.2 variantų. Jis taip pat nurodo, kad [klein] neturi užklausos išplėtimo. Svarbią aprašomąją informaciją pateikite patys, įskaitant ryšį tarp orientyrinių objektų, užuot pasikliovę automatiniu trumpos žymos išplėtimu. Serijai išlaikykite tą patį objekto orientyrą bei vaizdinius reikalavimus, vienu metu keisdami vieną scenos sprendimą.

Išvesties nustatymai ir versijų ribos

Konkretus gamintojo 4B profilis nurodo JPEG, PNG ir WebP išvestį, numatytasis – JPEG. Aiškios pločio ir aukščio reikšmės dokumentuotos su mažiausiai 64 pikseliais kiekvienai; modelio kortelės pavyzdys naudoja 1024×1024 vaizdą. Šis pavyzdys yra generavimo konfigūracija, o ne teiginys, kad kiekviena užduotis turi būti kvadratinė arba kad 1024 pikseliai yra modelio maksimumas. Prieš ruošdami vaizdinę užduotį pasirinkite norimą iškirpimą ir rodymo formą, tada tokiu dydžiu palyginkite smulkius užrašus bei detales.

Paskelbtas keturių žingsnių pavyzdys naudoja guidance_scale 1.0. Šią distiliuotą versiją atskirkite nuo FLUX.2 [klein] Base 4B, kurio nedistiliuotas mokymo signalas skirtas pritaikymui, LoRA mokymui ir tyrimams. Base 4B bei 9B modeliai yra atskiri pasirinkimai, turintys skirtingus paruošimo ir generavimo aspektus. Kompaktiško modelio standartiniai valdikliai taip pat skiriasi nuo [flex] reguliuojamų žingsnių bei nurodymų laikymosi stiprumo; [max] turi atskirą informacija grindžiančios paieškos galimybę.

Detalės, kurias reikia patikrinti vaizde

Konkreti modelio kortelė sako, kad šis modelis nėra faktinės informacijos šaltinis. Vaizde parašytas tekstas gali būti netikslus ar iškraipytas, o sugeneruota scena gali nukrypti nuo užklausos. Užklausos stilius stipriai veikia laikymąsi. Patikrinkite rašybą, kiekius, etiketes, objekto tapatumą ir konkrečius daiktus, kurie turėjo išlikti; patraukli kompozicija nepatvirtina, kad produkto savybė ar iliustruotas faktas teisingi. Gamintojas taip pat pažymi, kad statistiniai rezultatai gali atspindėti mokymo duomenų šališkumus.

Peržiūrėtam failui kartu su vaizdu laikykite pradinius orientyrus, galutinę formuluotę ir pasirinkto modelio tapatybę. Leidimo dokumentacija skiria pavyzdinį pikselių lygmens vandens ženklinimą pavyzdiniame kode nuo C2PA kilmės metaduomenų, taikomų gamintojo talpinamų rezultatų eigoje. Grąžintos kilmės informacijos išsaugojimas padeda paaiškinti failo kilmę; tai atskira nuo patikros, ar prašytas vaizdinis pakeitimas pavyko.

Ailoot Ultra · Vaizdai 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

Pradžia

Leidžiamos įvestys: Tekstas · Vaizdai
Rezultatai: Vaizdai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdai POST /v1/images/generations

Įvestis: text, image
Išvestis: image

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos black-forest-labs/flux.2-klein-4b	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`aspect_ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Numatyta—
Laukas`output_format`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos png, jpeg	Numatyta—
Laukas`n`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 1	Numatyta—
Laukas`input_references`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 4	Numatyta—
Laukas`provider`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, prompt
Parametras`material_types`	Specifikacijatext, image

Gyvavimo ciklas: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Apskaitos vienetas	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Apskaitos vienetas—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
Konfigūracijaišvesties vaizdo megapikselis	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetasuž išvesties vaizdo megapikselį	Mokestis Išvestis · išvesties vaizdo megapikselis · Įvertis tik palyginimui $0.028 už išvesties vaizdo megapikselį
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Apskaitos vienetas—	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.028 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdai

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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdai

Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį

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

Kito turinio skaitymas

Skaityti esamą jums priklausančią medžiagą

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.

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.

Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.

Atsakymo laukai

Laukas	Tipas
Laukas`created`	Tipas
Laukas`data[].url`	Tipas
Laukas`data[].b64_json`	Tipas
Laukas`usage`	Tipas

Pseudonimai

Modelių pseudonimai

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

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

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

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

Kokios įvestys ir rezultatai prieinami?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: text, image → image
Kokius laukus naudoja užklausa?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: model, prompt, aspect_ratio, output_format, n, input_references, provider
Kokie apribojimai taikomi?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Klein 4B