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.
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 <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.
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
black-forest-labs/flux-3-imageKezdő 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í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— |
Metódus paraméterei és életciklusa
| 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}
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 →
Példakérések
Ailoot Ultra · Képek
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"<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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
További tartalomlekérések
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-3-image
Metódusútvonalak álnevei
/v1/images
Kapcsolódó modellazonosítók
FAQ · Black Forest Labs: FLUX.3 Image
- Milyen bemenetek és eredmények érhetők el?
POST /v1/images/generations·black-forest-labs/flux-3-image:text,image→image- Mely mezőket használja a kérés?
POST /v1/images/generations·black-forest-labs/flux-3-image:model,prompt,resolution,aspect_ratio,n,input_references,provider- Milyen korlátok érvényesek?
POST /v1/images/generations·black-forest-labs/flux-3-image:n.minimum:1;n.maximum:1