models

Black Forest Labs: FLUX.3 Image

Markdown · JSON

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 /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ípusKövetelményÉrtékek és korlátokAlapértelmezett
MezőmodelTípusstringKövetelményKötelezőÉrtékek és korlátok
black-forest-labs/flux-3-image
Alapértelmezett—
MezőpromptTípusstringKövetelményKötelezőÉrtékek és korlátok
Minimális hossz: 1
Alapértelmezett—
MezőresolutionTípusstringKövetelményOpcionálisÉrtékek és korlátok
768, 1K, 1.5K, 2K, 4K
Alapértelmezett—
Mezőaspect_ratioTípusstringKö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őnTípusintegerKövetelményOpcionálisÉrtékek és korlátok
Minimum: 1
Maximum: 1
Alapértelmezett—
Mezőinput_referencesTípusarrayKövetelményOpcionálisÉrtékek és korlátok
Minimális elemszám: 0
Maximális elemszám: 10
Alapértelmezett—
MezőproviderTípusobjectKövetelményOpcionálisÉrtékek és korlátokAlapértelmezett—
Metódus paraméterei és életciklusa
ParaméterSzerződés
Paramétercontent_typeSzerződésapplication/json
ParaméterrequiredSzerződésmodel, prompt
Paramétermaterial_typesSzerző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ásDíjtáblázatElőre jelzett mennyiségDíj
BeállításTokenek alapdíjaiDíjtáblázatAlapdíjElő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égeDíjtáblázat—Előre jelzett mennyiségbecslés egy generálásraDí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

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-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}/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őcreatedTípus
Meződata[].urlTípus
Meződata[].b64_jsonTípus
MezőusageTípus

Álnevek

Modell álnevei

Ailoot Ultra black-forest-labs/flux-3-image

Metódusútvonalak álnevei

/v1/images

Kapcsolódó modellazonosítók

black-forest-labs/flux-3-image

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

További részletek

Csatlakoztassa az Ailootot a Claude Code-hoz, OpenCode-hoz, Hermeshez vagy saját alkalmazásához.

A vállalat és projektportfóliója

A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.

Vásároljon tokeneket kedvezménnyel.

Előfizetési kedvezmény rendszeres munkához. Promókódok — akár 50% tokenvásárlási kedvezmény.

Előfizetés
Válasszon kedvezményes tarifát a rendszeres kéréseihez.
Promókód akár 50%-ig
Vásárláskor adja meg a kódot. Az ár az érvényes akció szerint újraszámolódik.
Költségek az előzményekben
Minden kéréshez megmarad a modell, a tokenek és az összeg.

Előfizetés kiválasztása · Modellárak megtekintése

Csatlakoztassa az API-t az értékesített termékéhez.

SaaS, alkalmazások és botok — az Ailoot ajánlati feltételei és licencszerződése alapján. Viszonteladáshoz kérjen viszonteladói licencet.

Kereskedelmi alkalmazás
Építsen szöveg-, kép-, videó- és hanggenerálást szolgáltatása fizetős funkcióiba.
Viszonteladói licenc
Küldje el a projekt leírását és a hozzáférés módját. Kérjen írásos használati és viszonteladási feltételeket.
Dokumentumok a weboldalon
Az ajánlati feltételek, licencszerződés és adatkezelési szabályzat már a csatlakoztatás előtt elérhető.

Viszonteladói licenc kérése · Ajánlati feltételek és licencszerződés