Black Forest Labs: FLUX.2 Flex

A FLUX.2 [flex] a képi tipográfiára és apró vizuális részletekre specializálódik, állítható mintavételi lépésekkel és guidance-szal. Szöveggel és képreferenciákkal készíts plakátokat, termékelrendezéseket vagy pontos módosításokat, az utasításkövetés és realizmus egyensúlyát beállítva.

Ailoot Ultra · Képek POST /v1/images/generations black-forest-labs/flux.2-flex

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

A FLUX.2 [flex] a Black Forest Labs tipográfiára, szövegmegjelenítésre és apró részletek megőrzésére specializált képgeneráló és -szerkesztő kiadása. Írott jelenetutasításokból és képreferenciákból készít képet. Meghatározó vezérlője az állítható mintavétel: a dokumentált profil inferencialépéseket és guidance-ot egyaránt elérhetővé tesz, így a vizuális leírás beállításokkal és szavakkal is finomítható.

Feliratok és finom részletek

A tipográfiai feladat a tényleges szöveggel kezdődjön. Idézz minden sort, határozd meg helyét, és különböztesd meg a címsort, kiegészítő szöveget és címkét. A betűstílust, méretet és színt a jelenethez viszonyítva írd le. Egy eredeti plakátleírás kobaltkék kerékpárt mutathat világos stúdióban, a váz fölött nagy címmel, alatta kisebb műszaki sorral. A kép együtt tegye egyértelművé a terméket és az olvasási sorrendet.

Részletes termékvizuálnál nevezd meg a hasznosságot meghatározó részeket: számlap, kezelőszerv-felirat, varrás, anyagszél vagy csomagjelölés. Adj olvasható referenciát, és magyarázd el, melyik jellemzőt rögzíti. Egy általánosságban hasonló jelenet is megváltoztathat lényeges karaktert vagy összetevőt, ezért a generált részletet a kívánt megjelenítési méretben hasonlítsd össze. A modell specializációja indok a pontos követelményekre, nem garancia a korrektúra vagy vizuális ellenőrzés fölöslegességére.

A lépések és a guidance különböző célt szolgálnak

A pontos gyártói profil egy–ötven inferencialépést fogad, alapértelmezetten ötvenet. Leírása több lépéshez nagyobb részletességet és realizmust társít. A guidance 1.5–10 közötti, alapértelmezése 5. Magasabb guidance erősíti a prompt követését, de csökkentheti a realizmust. A pontos dizájnutasítású kép és a természetes fotografikus megjelenésre törekvő kép ezért eltérő választást igényelhet e profilon belül.

Beállításváltozás összevetésekor a szöveg, referenciák és kimeneti forma maradjon állandó. A változást indokoló jellemzőt vizsgáld: betűalak, tárgyelhelyezés vagy anyagtextúra. Konkrét vizuális okból változtass beállítást, ne tekintsd a nagyobb számot automatikusan jobbnak. Ezek gyártói mintavételi vezérlők; a négylépéses desztillált [klein] profil és a [pro] vagy [max] szokásos vezérlői eltérő modellválasztások.

A [flex] specifikációjában a prompt upsampling alapértelmezetten be van kapcsolva, és saját prompt_upsampling vezérlőjével kikapcsolható. Ez megfelelő esetben lehetővé teszi, hogy a részletes leírás a megadott szöveg maradjon. A gyártó közös útmutatója a fő téma és fontos cselekvés másodlagos díszítés elé helyezését ajánlja, és természetes nyelvű leírások mellett JSON-struktúrájú promptot is bemutat. A szükséges kapcsolatokat legkönnyebben kifejező szerkezetet használd.

Referenciák vezérelte módosítások

A pontos kérésprofil nyolc referenciaképhelyet tartalmaz. A gyártó interaktív munkafolyamata külön legfeljebb tíz képet enged; ezek a számok eltérő felületekre vonatkoznak. Határozd meg, hogy egy kép a szerkesztendő jelenetet, terméket, karaktert, ruházatot vagy stílust adja-e. Módosításnál azonosítsd a tárgyat és a változást, majd nevezd meg a megtartandó környező kompozíciót, anyagokat vagy fényt.

Egy eredeti csomagolási feladat használhatja az első kép dobozát és a második felületi kidolgozását, lecserélheti az elülső címkét a jóváhagyott szövegre, és megőrizheti a doboz arányait. Csoportkompozícióban minden témához külön referencia rendelhető, következetesen megtartva a hozzárendelést. A család példái tárgy- és háttérváltoztatást, kompozitkészítést, szövegszerkesztést és stílusátalakítást fednek le. Egyetlen összefüggő, világos célú módosítást kérj, majd a szerkesztett területet és a stabilnak szánt részeket egyaránt vesd össze.

Méret, szín és a visszaadott kép

A FLUX.2 útmutató legalább 64×64 pixelt, 16 többszöröseiből álló méreteket és legfeljebb 4 megapixeles kimenetet dokumentál; szokásos használatra legfeljebb 2 megapixelt ajánl. A pontos [flex] specifikáció JPEG, PNG és WebP kimenetet sorol fel, alapértelmezett JPEG-gel. Opcionális véletlen seedet is biztosít. Verziók összevetésekor a forrásreferenciák mellett őrizd meg a tényleges modellt, seedet és mintavételi beállításokat; a család neve önmagában nem azonosítja a teljes generálási konfigurációt.

Színérzékeny munkánál minden hexakódot rendelj megnevezett tárgyhoz vagy szövegelemhez. Kompozíciónál a képméretekkel add meg a kívánt oldalarányt, és hagyj elegendő helyet olvasható feliratoknak. A közös útmutatóban nincs negatívprompt-mechanizmus, ezért pozitívan írd le a kívánt megjelenést: éles fókusz, tiszta háttér vagy egyértelműen üres terület a szövegnek. Többnyelvű példái támogatják a kulturálisan specifikus leírás megfelelő nyelven való megírását, rögzített nyelvszám-garancia nélkül.

A gyártó FLUX.2 folyamata feldolgozás után képet ad vissza, ideiglenes aláírt linkekkel és tízperces letöltési időablakkal. Őrizd meg együtt a tényleges képet és leírást. Elrendezésbe illesztés előtt ellenőrizd a tipográfiát, finom részleteket, referenciaazonosságot és vizuális megoldást. A végleges eredmény kiválasztott plakát, termékkép vagy szerkesztett kompozíció lehet, a következő módosításhoz megőrzött pontos beállításokkal.

Ailoot Ultra · Képek POST /v1/images/generations black-forest-labs/flux.2-flex

black-forest-labs/flux.2-flex

Black Forest Labs /black-forest-labs/flux.2-flex

Kezdő lépések

Elfogadott bemenetek: Szöveg · Képek
Eredmények: Képek

Elérhető az Ailootban · bemenetek és metódusok

Ailoot Ultra · Képek POST /v1/images/generations

Bemenet: text, image
Kimenet: image

Mező	Típus	Követelmény	Értékek és korlátok	Alapértelmezett
Mező`model`	Típus`string`	KövetelményKötelező	Értékek és korlátok black-forest-labs/flux.2-flex	Alapértelmezett—
Mező`prompt`	Típus`string`	KövetelményKötelező	Értékek és korlátok Minimális hossz: 1	Alapértelmezett—
Mező`aspect_ratio`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Alapértelmezett—
Mező`output_format`	Típus`string`	KövetelményOpcionális	Értékek és korlátok png, jpeg	Alapértelmezett—
Mező`n`	Típus`integer`	KövetelményOpcionális	Értékek és korlátok Minimum: 1 Maximum: 1	Alapértelmezett—
Mező`input_references`	Típus`array`	KövetelményOpcionális	Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 8	Alapértelmezett—
Mező`provider`	Típus`object`	KövetelményOpcionális	Értékek és korlátok	Alapértelmezett—

Metódus paraméterei és életciklusa

Paraméter	Szerződés
Paraméter`content_type`	Szerződésapplication/json
Paraméter`required`	Szerződésmodel, prompt
Paraméter`material_types`	Szerződéstext, image

Életciklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Díjcsomagok

A végső díj számítása

A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.

A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.

Gyors mód: Nincs megadva Ha a gyors mód van kiválasztva
Flex mód: Nincs megadva Ha a flex mód van kiválasztva
Maximális gondolkodási ráfordítás: Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik

Becsült díjak összehasonlításhoz

Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

Beállítás	Díjtáblázat	Előre jelzett mennyiség	Elszámolási egység	Díj
BeállításTokenek alapdíjai	DíjtáblázatAlapdíj	Előre jelzett mennyiség—	Elszámolási egység—	Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token
Beállításbemeneti kép megapixele	Díjtáblázat—	Előre jelzett mennyiség—	Elszámolási egységa bemeneti kép minden megapixelje után	Díj Bemenet · bemeneti kép megapixele · Becslés, csak összehasonlításra $0.12 a bemeneti kép minden megapixelje után
Beállításkimeneti kép megapixele	Díjtáblázat—	Előre jelzett mennyiség—	Elszámolási egységa kimeneti kép minden megapixelje után	Díj Kimenet · kimeneti kép megapixele · Becslés, csak összehasonlításra $0.12 a kimeneti kép minden megapixelje után
BeállításA generálás becsült költsége	Díjtáblázat—	Előre jelzett mennyiségbecslés egy generálásra	Elszámolási egység—	Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.12 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra.

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →

Példakérések

Ailoot Ultra · Képek

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-flex', '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

Eredmények fogadása és mentése

Ailoot Ultra · Képek

Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat

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

További tartalomlekérések

A meglévő, Önhöz tartozó médiafájlok lekérése

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.

Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.

Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.

Ha az eredeti választ ellenőrizni kell

Őrizze meg a visszaadott X-Client-Request-ID értéket az egyeztetéshez. Csak a ténylegesen visszaadott task_id/asset_id értékekkel kérdezzen le, vagy használja a saját médiatárat; soha ne állítson össze feladat-URL-t a műveletazonosítóból, és soha ne küldje be újra a létrehozási kérést.

Válaszmezők

Mező	Típus
Mező`created`	Típus
Mező`data[].url`	Típus
Mező`data[].b64_json`	Típus
Mező`usage`	Típus

Álnevek

Modell álnevei

Ailoot Ultra black-forest-labs/flux.2-flex

Metódusútvonalak álnevei

/v1/images

Kapcsolódó modellazonosítók

black-forest-labs/flux.2-flex

FAQ · Black Forest Labs: FLUX.2 Flex

Milyen bemenetek és eredmények érhetők el?: POST /v1/images/generations · black-forest-labs/flux.2-flex: text, image → image
Mely mezőket használja a kérés?: POST /v1/images/generations · black-forest-labs/flux.2-flex: model, prompt, aspect_ratio, output_format, n, input_references, provider
Milyen korlátok érvényesek?: POST /v1/images/generations · black-forest-labs/flux.2-flex: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Flex