Black Forest Labs: FLUX.2 Pro

A FLUX.2 [pro] a Black Forest Labs éles munkára szánt képmodellje szöveges alkotáshoz és referenciák vezérelte szerkesztéshez. Dokumentált profilja fotórealisztikus részleteket, szöveg- és színvezérlést egyesít referencia/kimeneti pixelkerettel és legfeljebb 4 megapixeles képekkel.

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

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 [pro] a Black Forest Labs éles felhasználásra összpontosító képgeneráló és -szerkesztő modellje. A gyártó a legtöbb FLUX.2 vizuális feladathoz alapértelmezett választásként mutatja be: készíts új képet szövegből, vagy módosíts jelenetet vizuális referenciákkal. A család képességei között fotórealisztikus anyagok és világítás, olvasható szöveg, pontos színutasítások és kapcsolódó szerkesztéseken át következetes témák szerepelnek. A visszaadott alkotás termékjelenetben, szerkesztőségi kompozícióban, dizájnkoncepcióban vagy vizuális kommunikációban használható kép.

Éles felhasználásra szánt leírás előkészítése

Indulj a témából, annak cselekvéséből vagy elrendezéséből, a stílusból és a környezetből vagy fényből. A gyártó promptútmutatója nagyobb hangsúlyt ad a korai szavaknak, és a lényegi téma és cselekvés dekoratív részletek elé helyezését ajánlja. Gyors koncepciókhoz 10–30, szokásos projektekhez 30–80 szót javasol, összetett jelenethez hosszabb leírással. Ezek promptírási ajánlások, nem a szövegkontextus korlátai.

Egy eredeti katalógusleírás melegszürke asztallapon álló szálcsiszolt acéllámpát mutathat háromnegyedes nézetben, hogy a kapcsoló és a búra látható legyen. Add meg a terméket felismerhetővé tevő felületet, világítást és nézőpontot. Infografikánál vagy marketingképnél először véglegesítsd a látható szöveget és hierarchiáját; idézd a pontos címet, jelöld helyét, és nevezd meg a betűk stílusát és méretét. A címkéket, mennyiségeket és termékrészleteket a végleges megjelenítési méretben vizsgáld meg.

A család útmutatója természetes nyelvű és JSON-struktúrájú promptot is dokumentál. A strukturált jelenetleírás külön mezőben tarthatja a témát, hátteret, fényt és kompozíciót, így egy-egy követelmény világosan módosítható. Hexadecimális színleírást is támogat: a kódot rendeld konkrét tárgyhoz vagy szöveghez. A kívánt megjelenést pozitívan írd le, mert a dokumentált FLUX.2 promptfolyamat nem biztosít negatív promptot.

Szerkesztés referenciákkal és közös pixelkerettel

A pontos [pro] kérésprofil nyolc referenciaképhelyet kínál; a gyártó interaktív felülete ettől külön tízet támogat. Rendelj minden képhez szerepet, például téma megjelenése, ruházat, termékdizájn, szoba vagy stílus. Meglévő jelenetnél add meg a változtatandó elemet, valamint a megtartandó kompozíciót, környezetet és vizuális részleteket. A közzétett példák bútorkompozitokat, háttér- vagy időjárás-változtatást, tárgycserét és szövegmódosítást tartalmaznak.

A referenciakapacitás a kimenet méretétől is függ. A gyártó [pro] útmutatója összesen 9 megapixeles keretet határoz meg bemenetre és kimenetre együtt. Példái 1 megapixeles kimenet mellett nyolc, 2 megapixeles mellett hét referenciát engednek, és a nagyobb kért eredmény csökkenti a referenciakapacitást. A forráskészletet és kimenetet együtt tervezd meg, ne tekintsd a maximális helyszámot minden kimeneti méretnél elérhetőnek. A szükséges információt rögzítő referenciákat használd, és nevezd meg tervezett hozzájárulásukat.

Termékkompozitnál az első kép adhatja a terméket, a második a szobát, a harmadik pedig az anyag kidolgozását. Magyarázd el, hogyan álljanak össze egyetlen összefüggő jelenetté. Ha az eredmény megváltoztatja a megtartandó alakot, jelölést vagy azonosságot, a következő kérésben ezt a problémát célozd a teljes leírás lecserélése helyett. A gyakorlati eredmény a módosított kép, amelyen a referenciahűséget és a konkrét változást a bemenetekhez kell mérni.

Promptbővítés, rögzített és előzetes profilok

A pontos [pro] specifikáció alapértelmezetten engedélyezi a prompt upsamplinget. A disable_pup vezérlő leállítja ezt a bővítést, ha a gondosan megírt utasítást változatlanul kell használni. Verziók összevetésekor tartsd meg a választott beállítást, mert ugyanaz a rövid koncepció és annak kibővített leírása eltérő generálási bemenet. Ez gyártói profilvezérlő, nem garancia minden kért részlet helyes megjelenésére.

A dokumentáció a sima [pro] végpontot rögzített pillanatképként különbözteti meg a [pro] Preview-tól, amelybe későbbi modellfejlesztések kerülnek. Kérés- és válaszszerkezetük azonos, mögöttes súlyaik eltérnek. A pontosan kiválasztott profilt őrizd meg a képpel és referenciákkal. Ha a módosítás ugyanazon dokumentált modellválasztástól függ, a külön Preview címke ne helyettesítse észrevétlenül a sima [pro] választást.

Méretek, formátumok és a kiválasztott kép

A család útmutatója legfeljebb 4 megapixeles kimenetet dokumentál, legalább 64×64-es konkrét mérettel és 16 többszöröseivel. A legtöbb felhasználáshoz legfeljebb 2 megapixelt ajánl. A szélesség és magasság rögzíti a kívánt képkivágást; a négyzetes termékkép, álló elrendezés és széles szerkesztőségi jelenet eltérően osztja fel a teret. A pontos kérés JPEG, PNG és WebP kimenetet sorol fel, alapértelmezetten JPEG-gel és opcionális seeddel.

A [max] profil külön kereséses megalapozással rendelkezik, a [flex] mintavételi lépéseket és guidance-ot tesz elérhetővé, a [klein] pedig kisebb, négyreferenciás profilt használ. A kiadást a szükséges munka alapján válaszd, e vezérlők [pro]-ba átemelése helyett. A kiválasztott eredményhez őrizd meg a tényleges képet, végső promptot, referenciákat, méreteket és modellcímkét. A gyártó aláírt FLUX.2 eredménylinkjei tíz perc után lejárnak, ezért töltsd le a képet, ne ideiglenes helyére támaszkodj. Ügyfélnek szánt anyagba illesztés előtt ellenőrizd a téma azonosságát, színeket, szöveget, kompozíciót és szerkesztett részleteket.

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

black-forest-labs/flux.2-pro

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

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-pro	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á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.06 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.06 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-pro', '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-pro

Metódusútvonalak álnevei

/v1/images

Kapcsolódó modellazonosítók

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

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

Black Forest Labs: FLUX.2 Pro