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.
Ú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.
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.
Az elrendezési prompt képleírást és elemsorokat tartalmazó JSON-tömböt egyesít. A leírás például <cup_1> 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.
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.
", "aboutText": "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.\n\n### Jelenet készítése vagy szerkesztési utasítás megadása\n\nÚ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.\n\nSzerkeszté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.\n\n### Referenciaképek egyesítése és előkészítése\n\nA 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.\n\nAz 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.\n\n### Elemek elhelyezése befoglaló téglalapokkal\n\nAz elrendezési prompt képleírást és elemsorokat tartalmazó JSON-tömböt egyesít. A leírás példáulblack-forest-labs/flux-3-imageA 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.
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.
Ú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.
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.
Az elrendezési prompt képleírást és elemsorokat tartalmazó JSON-tömböt egyesít. A leírás például <cup_1> 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.
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.
POST /v1/images/generationstext, imageimage| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok black-forest-labs/flux-3-image | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 768, 1K, 1.5K, 2K, 4K | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | 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ípusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 1 | Alapértelmezett— |
Mezőinput_references | Típusarray | KövetelményOpcionális | Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 10 | Alapértelmezett— |
Mezőprovider | Típusobject | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paramétermaterial_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}
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nTöltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nMentsen 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.
Ő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.
| Mező | Típus |
|---|---|
Mezőcreated | Típus |
Meződata[].url | Típus |
Meződata[].b64_json | Típus |
Mezőusage | Típus |
Ailoot Ultra black-forest-labs/flux-3-image
/v1/images