Black Forest Labs: FLUX.2 Klein 4B

FLUX.2 [klein] 4B on Black Forest Labsin kompakti, askelmäärältään tislattu kuvamalli tekstipohjaiseen luomiseen ja muokkaukseen enintään neljällä viitteellä. Sen neljän askeleen rakenne tukee interaktiivista visuaalista työtä, ja malli on erillinen tislaamattomasta Base 4B -versiosta.

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

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

FLUX.2 [klein] 4B on Black Forest Labsin kompakti malli kuvan luomiseen tekstikuvauksesta ja kuvien muokkaamiseen visuaalisilla viitteillä. Sen neljän miljardin parametrin rectified-flow-transformer yhdistää generoinnin ja muokkauksen samaan arkkitehtuuriin. Nimetty 4B-versio on askelmäärältään tislattu, ja valmistajan viite-esimerkki käyttää neljää päättelyaskelta.

Mallin tehtävä on interaktiivinen visuaalinen luonnos tai muutos: kokeile tuotenäkymää, vaihda hahmon vaatteita, yhdistä kohde ympäristöön tai tarkenna kuvituksen ulkoasua. Aloita tärkeästä tapahtumasta tai sommittelusta ja kuvaile sitten kohde, materiaali, valaistus ja näkökulma. Konkreettinen ohje voi sijoittaa mattasinisen keraamisen kupin vaalealle tammipöydälle sivuvalaistuun lähikuvaan, jossa kahva ja lasite näkyvät. Tuloksena on kuva, jota tarkastellaan näitä valintoja vasten.

Muokkaus pienellä viitejoukolla

Dokumentoitu 4B-profiili hyväksyy enintään neljä syötekuvaa. Anna jokaiselle selkeä rooli: tuotteen ulkonäkö, hahmo, ympäristö tai tyyli. Jos yksi kuva on muokattava kohtaus, yksilöi se ja kerro sekä muutos että säilytettävät yksityiskohdat. Säilytä esimerkiksi ensimmäisen kuvan kupin siluetti ja pinta, käytä toisen kuvan huonetta ja korvaa vain pöydän päällyste. Viitejärjestys ja täsmällinen muutosohje antavat muokkaukselle selkeämmän tavoitteen kuin yleinen parannuspyyntö.

Valmistaja erottaa tämän kompaktin viitebudjetin suuremmista FLUX.2-muunnelmista. Se myös kertoo, ettei [klein] laajenna kehotetta. Anna tärkeät kuvailevat tiedot itse, myös viitattujen esineiden suhde, sen sijaan että luottaisit lyhyen nimikkeen automaattiseen laajennukseen. Säilytä sarjassa sama kohdeviite ja visuaaliset vaatimukset ja muuta yhtä kohtausvalintaa kerrallaan.

Tulosasetukset ja versiorajat

Valmistajan nimenomainen 4B-profiili luettelee JPEG-, PNG- ja WebP-tulokset, oletuksena JPEG:n. Täsmällisille leveys- ja korkeusarvoille dokumentoidaan vähintään 64 pikseliä kummallekin; viitemallikortin esimerkki käyttää 1024×1024-kuvaa. Esimerkki on näytteistysasetus, ei väite siitä, että kaikkien tehtävien tulisi olla neliöitä tai että 1024 pikseliä olisi mallin enimmäiskoko. Valitse haluttu rajaus ja näyttömuoto ennen visuaalisen ohjeen valmistelua ja vertaa sitten pientä tekstiä ja yksityiskohtia siinä koossa.

Julkaistu neljän askeleen esimerkki käyttää guidance_scale-arvoa 1.0. Pidä tämä tislattu versio erillään FLUX.2 [klein] Base 4B:stä, jonka tislaamaton koulutussignaali on tarkoitettu mukauttamiseen, LoRA-koulutukseen ja tutkimukseen. Base 4B ja 9B-mallit ovat erillisiä valintoja, joilla on erilaiset valmistelu- ja näytteistysnäkökohdat. Kompaktin mallin vakioasetukset eroavat myös [flex]:n säädettävistä askelista ja ohjausvoimakkuudesta; [max]:llä on oma tietoon perustava hakukykynsä.

Kuvasta tarkistettavat yksityiskohdat

Nimenomainen mallikortti sanoo, ettei malli ole faktatiedon lähde. Kuvan teksti voi olla epätarkkaa tai vääristynyttä, ja generoitu kohtaus voi poiketa pyynnöstä. Kehotteen tyyli vaikuttaa merkittävästi noudattamiseen. Tarkista oikeinkirjoitus, määrät, nimikkeet, kohteen identiteetti ja nimenomaiset säilytettävät esineet; houkutteleva sommittelu ei osoita tuotepiirteen tai kuvitetun faktan oikeellisuutta. Valmistaja huomauttaa myös, että tilastolliset tulokset voivat heijastaa koulutusaineiston vinoumia.

Säilytä arvioidun kuvan mukana lähdeviitteet, lopullinen sanamuoto ja valittu mallin identiteetti. Julkaisudokumentaatio erottaa viitekoodin esimerkin pikselitason vesileiman valmistajan isännöidyssä tulostyönkulussa käytettävistä C2PA-alkuperämetatiedoista. Palautetun alkuperätiedon säilyttäminen auttaa selittämään kuvan alkuperää; se on eri asia kuin pyydetyn visuaalisen muutoksen onnistumisen tarkistaminen.

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

Aloitus

Hyväksytyt syötteet: Teksti · Kuvat
Tulokset: Kuvat

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Kuvat POST /v1/images/generations

Syötetyypit: text, image
Tulostyypit: image

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat black-forest-labs/flux.2-klein-4b	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Vähimmäispituus: 1	Oletus—
Kenttä`aspect_ratio`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Oletus—
Kenttä`output_format`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat png, jpeg	Oletus—
Kenttä`n`	Tyyppi`integer`	VaatimusValinnainen	Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 1	Oletus—
Kenttä`input_references`	Tyyppi`array`	VaatimusValinnainen	Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 4	Oletus—
Kenttä`provider`	Tyyppi`object`	VaatimusValinnainen	Arvot & rajat	Oletus—

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`content_type`	Sopimusapplication/json
Parametri`required`	Sopimusmodel, prompt
Parametri`material_types`	Sopimustext, image

Elinkaari: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila: Ei määritetty Kun nopea tila on valittu
Flex-tila: Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho: Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

Asetukset	Hinnasto	Ennustettu määrä	Laskutusyksikkö	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	Laskutusyksikkö—	Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
Asetuksetkuvatulosteen megapikseli	Hinnasto—	Ennustettu määrä—	Laskutusyksikkötuloskuvan megapikseliä kohden	Veloitus Tuloste · kuvatulosteen megapikseli · Arvio vain vertailua varten $0.028 tuloskuvan megapikseliä kohden
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Laskutusyksikkö—	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.028 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot Ultra · Kuvat

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

Vastaanota ja tallenna tulokset

Ailoot Ultra · Kuvat

Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö

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

Muut sisällön lukukerrat

Lue olemassa olevat omistamasi aineistot

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.

Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.

Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.

Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu X-Client-Request-ID täsmäytystä varten. Tee lukukyselyt vain todellisuudessa palautetuilla task_id/asset_id-arvoilla tai käytä omistamaasi mediakirjastoa; älä koskaan rakenna tehtävän URL-osoitetta operaation ID:n perusteella äläkä lähetä luontipyyntöä uudelleen.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`created`	Tyyppi
Kenttä`data[].url`	Tyyppi
Kenttä`data[].b64_json`	Tyyppi
Kenttä`usage`	Tyyppi

Aliakset

Mallin aliakset

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

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

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

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

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: text, image → image
Mitä kenttiä pyyntö käyttää?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: model, prompt, aspect_ratio, output_format, n, input_references, provider
Mitä rajoja sovelletaan?: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Klein 4B