Source: https://ailoot.ai/models/hu/black-forest-labs-flux-3-image/ Canonical: https://ailoot.ai/models/hu/black-forest-labs-flux-3-image/ Language: hu # Black Forest Labs: FLUX.3 Image [Markdown](https://ailoot.ai/models/hu/black-forest-labs-flux-3-image/index.md) · [JSON](https://ailoot.ai/models/hu/black-forest-labs-flux-3-image/facts.json) ## [Black Forest Labs: FLUX.3 Image](https://ailoot.ai/models/hu/black-forest-labs-flux-3-image/) A FLUX 3 Image írott leírásból és legfeljebb tíz referenciából készít és szerkeszt képeket. Promptalapú befoglaló téglalapokat ad a kompozícióhoz és helyi változtatásokhoz, webes és képi megalapozást, valamint öt felbontási osztályt. - [**Ailoot Ultra · Képek** `POST /v1/images/generations` `black-forest-labs/flux-3-image`](https://ailoot.ai/models/hu/black-forest-labs-flux-3-image/#method-0) 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 3 Image a Black Forest Labs képgeneráló és -szerkesztő modellje, kifejezett kompozícióvezérléssel. Szövegleírás új jelenetet készíthet; megadott képek témát, módosítandó jelenetet vagy több egyesítendő elemet rögzíthetnek. Befoglaló téglalapokkal a leírás megadhatja az egyes elemek helyét és a meglévő kép változtatandó részeit. Az eredmény a kért jelenetet, szöveget és elrendezést tartalmazó, ellenőrizhető kép. #### Jelenet készítése vagy szerkesztési utasítás megadása Új képhez írd le a témát, cselekvést vagy pózt, környezetet, fényt és képkivágást. A képen belüli pontos szöveget tedd idézőjelbe, és add meg megjelenési helyét. Eredeti termékleírás mutathat piros kempingbögrét világos kőfelületen, fölötte nagy címsorral és a fület kiemelő lágy reggeli fénnyel. Határozd meg a címsor, termék és háttér kapcsolatát, egymástól független stílusszavak helyett. Szerkesztésnél azonosítsd a konkrét tárgyat és változást: bögre átszínezése, címkecsere, figura elmozdítása vagy jelenet újrastilizálása. Egyetlen szerkesztés nem igényel kézzel rajzolt téglalapot. A dokumentált folyamat generálás előtt kibővíti az utasítást, megkeresheti a megnevezett elemet és automatikusan hozzáadhat egy téglalapot. A visszaadott kibővített prompt rögzíti ezt az értelmezést, ami hasznos, ha az utasítás rossz tárgyat jelöl ki vagy nem kívánt részletet vezet be. #### Referenciaképek egyesítése és előkészítése A pontos gyártói profil egy–tíz referenciát fogad kép-URL-ként vagy kódolt képadatként. Mindegyik legalább 256×256 pixeles és legfeljebb 16 megapixeles legyen. Pozíciójával vagy látható tartalmával nevezd meg a referenciát, majd magyarázd el szerepét: az Image 1 személye, az Image 2 kabátja és az Image 3 szobája. A képreferencia vizuális információforrás, nem utasítás minden benne lévő, független részlet másolására. Az oldalarány-beállítás alapértelmezése auto. A kérési specifikációban a promptban kért arány elsőbbséget élvez; egyébként az első referencia határozza meg a képkivágást, és ha sem referencia, sem kért forma nem adja meg, négyzetes kimenet az alapértelmezett tartalék. Kompozitnál a kívánt jelenetreferenciát tedd elsőre, vagy válaszd ki az arányt kifejezetten. A forrásképeket és sorrendjüket őrizd meg az eredménnyel, hogy későbbi módosítás ugyanabból a vizuális kiindulópontból induljon. #### Elemek elhelyezése befoglaló téglalapokkal Az elrendezési prompt képleírást és elemsorokat tartalmazó JSON-tömböt egyesít. A leírás például \ jelölővel nevez meg egy elemet; a sor id, bbox és desc mezőt tartalmaz. A koordináták 0–1000 közötti egészek \[top, left, bottom, right\] sorrendben, a bal felső saroktól mérve. Például \[0, 0, 500, 500\] a bal felső negyedet írja le a kép pixelméretétől függetlenül. Az elrendezéshez tervezett oldalarányt használd, mert a koordinátarács a képkivágással nyúlik. A szerkesztési sor ehelyett from, src\_bbox és tgt\_bbox mezőt használ az azonosító és leírás mellett. A ref\_image\_0 az első megadott képet jelenti. Egyező forrás- és céltéglalap rögzíti az elemet; eltérő téglalap mozgatja vagy átméretezi. Forrás nélküli új sor a célhelyre generálja leírását, lehetővé téve hozzáadást, cserét vagy átszínezést. Cél nélküli forrássor eltávolítja az elemet. A hozzáadásokat és eltávolításokat az írott utasításban és sorokban is add meg, a helyben tartandó részletekhez pedig őrizd meg a rögzítő sorokat. A felirat kapjon saját téglalapot, pontos szövege idézve szerepeljen a desc mezőben. A téglalapok az elhelyezést és méretet irányítják; nem vágómaszkok, ezért az elem túlnyúlhat rajtuk. A gyártó beszámolója szerint példáiban a nagyjából 40×25 pixeles téglalapok új tárgyai gyakran nem jelentek meg. Hagyj elegendő látható helyet, és ellenőrizd a szerkesztett határokat. A célterületen kívüli pixelek rendszerint stabilak maradnak, de az árnyékok, tükröződések és közeli világítás változhat. #### Megalapozás, kimeneti osztályok és hasznos nyilvántartás A dokumentált profil alapértelmezetten engedélyezi a megalapozást, így webes és képkeresés segítheti a generálást. Ez kikapcsolható, ha a leírás csak saját szövegét és referenciáit használhatja. Valós témánál világosan azonosítsd a helyszínt, eseményt vagy tárgyat, és különítsd el a tényszerű tartalmat a művészi megoldástól. A kereséssel segített képet is hiteles anyaghoz kell mérni, ha egy címkének, tárgynak vagy ábrázolt eseménynek pontosnak kell lennie. Az öt felbontási osztály 768sq, 1k, 1.5k, 2k és 4k, alapértelmezetten 1k. Ezek azonos pixelterületű szinteket jelentenek, ezért a pontos szélesség és magasság a választott aránytól függ. Tizenöt rögzített arány terjed 21:9-től négyzetes és álló formákon át 9:21-ig. E modell profilja aránnyal és felbontással szabályozza a méretet; nem teszi elérhetővé a FLUX.2 kérésprofilok seed, width vagy height mezőit. Dokumentált verzióválasztója jelenleg változó kiadást nevez meg, nem dátumozott egyezést a beszállítói súlyokkal. A gyártói folyamat aszinkron feldolgozás után képet és kibővített promptot ad vissza. Az aláírt képletöltési link egy óráig érvényes. Ideiglenes link helyett őrizd meg magát a képet, végső promptot és referenciákat. Ellenőrzött kép esetén a kért szöveget, tárgyelhelyezést, referenciaazonosságot és módosított területet a tervezett megjelenítési méretben hasonlítsd össze. A befejezett generálás e vizuális követelmények ellenőrzésének kiindulópontja. **Ailoot Ultra · Képek** `POST /v1/images/generations` `black-forest-labs/flux-3-image` [`black-forest-labs/flux-3-image`](https://ailoot.ai/models/hu/#m=black-forest-labs%2Fflux-3-image&route=Ultra&caller=black-forest-labs%2Fflux-3-image&fmt=images) Black Forest Labs /`black-forest-labs/flux-3-image` ### Kezdő lépések A FLUX 3 Image írott leírásból és legfeljebb tíz referenciából készít és szerkeszt képeket. Promptalapú befoglaló téglalapokat ad a kompozícióhoz és helyi változtatásokhoz, webes és képi megalapozást, valamint öt felbontási osztályt. 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-3-image | Alapértelmezett— | | Mező`prompt` | Típus`string` | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— | | Mező`resolution` | Típus`string` | KövetelményOpcionális | Értékek és korlátok 768, 1K, 1.5K, 2K, 4K | Alapértelmezett— | | Mező`aspect_ratio` | Típus`string` | KövetelményOpcionális | Értékek és korlátok 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto | 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: 10 | 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 | Díj | | --- | --- | --- | --- | | BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyisé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ásA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra **$0.082** 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 →](https://ailoot.ai/docs/hu/billing/reserve/) ### Példakérések #### Ailoot Ultra · Képek curl ```bash 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-3-image', '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"