Black Forest Labs: FLUX.3 Image

FLUX 3 Image vytvára a upravuje obrázky z písaného zadania a až desiatich referencií. Pridáva ohraničujúce rámčeky zadávané textom pre kompozíciu a lokálne zmeny, ukotvenie vo webových a obrazových zdrojoch a päť tried rozlíšenia.

Ailoot Ultra · Obrázky POST /v1/images/generations black-forest-labs/flux-3-image

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

FLUX 3 Image je model Black Forest Labs na generovanie a úpravu obrázkov s explicitným ovládaním kompozície. Textový opis môže vytvoriť novú scénu; dodané obrázky môžu určiť subjekt, scénu na revíziu alebo viaceré prvky na spojenie. Ohraničujúce rámčeky umožňujú zadaním určiť miesto každého prvku aj časti existujúceho obrázka, ktoré sa majú zmeniť. Výsledkom je obrázok s požadovanou scénou, textom a rozložením na kontrolu.

Vytvorte scénu alebo zadajte pokyn na úpravu

Pri novom obrázku opíšte subjekt, akciu alebo pózu, prostredie, svetlo a rámovanie. Presné znenie textu v obrázku dajte do úvodzoviek a určte, kde sa zobrazí. Pôvodné produktové zadanie môže zobrazovať červený kempingový hrnček na svetlom kamennom povrchu s veľkým nadpisom nad ním a jemným ranným svetlom odhaľujúcim uško. Určte vzťah nadpisu, produktu a pozadia namiesto nesúvisiacich štýlových slov.

Pri úpravách identifikujte konkrétny predmet a zmenu: prefarbite hrnček, nahraďte štítok, presuňte postavu alebo zmeňte štýl scény. Jedna úprava nevyžaduje ručne nakreslený rámček. Dokumentovaný postup rozšíri pokyn pred generovaním a môže pomenovaný prvok nájsť aj automaticky pridať rámček. Vrátené rozšírené zadanie zaznamenáva túto interpretáciu, čo je užitočné, keď pokyn vyberie nesprávny objekt alebo zavedie nežiaduci detail.

Kombinujte a pripravte referenčné obrázky

Presný profil výrobcu prijíma jednu až desať referencií dodaných ako URL obrázkov alebo zakódované obrazové dáta. Každá musí mať aspoň 256×256 pixelov a najviac 16 megapixelov. Referenciu pomenujte podľa pozície alebo viditeľného obsahu a potom vysvetlite jej úlohu: osoba z Image 1, bunda z Image 2 a miestnosť z Image 3. Obrazová referencia je zdrojom vizuálnych informácií, nie pokynom kopírovať každý nesúvisiaci detail, ktorý obsahuje.

Nastavenie pomeru strán má predvolenú hodnotu auto. V špecifikácii požiadavky má prednosť pomer požadovaný v zadaní; inak rámovanie určí prvá referencia, so štvorcovým výstupom ako záložnou voľbou, keď ho neposkytuje referencia ani požadovaný formát. Pri kompozitnej zostave umiestnite zamýšľanú referenciu scény ako prvú alebo pomer vyberte explicitne. Zdrojové obrázky a ich poradie uchovajte s výsledkom, aby neskoršia revízia používala rovnaký vizuálny východiskový bod.

Umiestňujte prvky pomocou ohraničujúcich rámčekov

Zadanie rozloženia spája opis s poľom JSON obsahujúcim riadky prvkov. Opis pomenuje prvok pomocou značky ako <cup_1>; riadok obsahuje id, bbox a desc. Súradnice sú celé čísla od 0 do 1000 v poradí [top, left, bottom, right], merané od ľavého horného rohu. Napríklad [0, 0, 500, 500] opisuje ľavú hornú štvrtinu nezávisle od pixelových rozmerov obrázka. Použite pomer strán, pre ktorý bolo rozloženie navrhnuté, pretože súradnicová mriežka sa naťahuje s rámom.

Riadok úpravy naopak používa from, src_bbox a tgt_bbox spolu s identifikátorom a opisom. ref_image_0 znamená prvý dodaný obrázok. Zhodné zdrojové a cieľové rámčeky ukotvujú prvok; odlišné ho presúvajú alebo menia jeho veľkosť. Nový riadok bez zdroja generuje obsah podľa svojho opisu na cieľovom mieste a umožňuje pridanie, náhradu alebo prefarbenie. Zdrojový riadok bez cieľa prvok odstráni. Pridania a odstránenia uveďte v písanom pokyne aj riadkoch a zachovajte ukotvujúce riadky pre detaily, ktoré musia zostať na mieste.

Písmu dajte vlastný rámček a jeho presné znenie citujte v desc. Rámčeky usmerňujú umiestnenie a mierku; nie sú orezovými maskami, takže prvok môže presiahnuť obdĺžnik. Výrobca uvádza, že nové objekty v rámčekoch s veľkosťou okolo 40×25 pixelov sa v jeho príkladoch často nezobrazili. Nechajte dostatočný viditeľný priestor a kontrolujte hranice úprav. Pixely mimo cieľa zvyčajne zostávajú stabilné, ale tiene, odrazy a okolité osvetlenie sa môžu meniť.

Ukotvenie v zdrojoch, triedy výstupu a užitočné záznamy

Dokumentovaný profil predvolene zapína ukotvenie v zdrojoch a umožňuje webovému aj obrazovému vyhľadávaniu informovať generovanie. Možno ho vypnúť pri zadaní, ktoré má používať iba dodaný opis a referencie. Pri skutočnom subjekte jasne určte miesto, udalosť alebo predmet a faktický obsah oddeľte od umeleckého spracovania. Obrazy informované vyhľadávaním stále treba porovnať s autoritatívnym materiálom, keď sa vyžaduje presnosť štítka, predmetu alebo zobrazenej udalosti.

Päť tried rozlíšenia je 768sq, 1k, 1.5k, 2k a 4k, s predvolenou 1k. Predstavujú úrovne s rovnakou pixelovou plochou, takže presná šírka a výška závisia od zvoleného pomeru. Pätnásť pevných pomerov siaha od 21:9 cez štvorcové a portrétové formáty po 9:21. Profil tohto modelu ovláda veľkosť cez pomer a rozlíšenie; nesprístupňuje polia seed, width alebo height používané v profiloch požiadaviek FLUX.2. Jeho dokumentovaný výber verzie aktuálne pomenúva priebežne aktualizované vydanie namiesto určenia zhody s dodávateľskými váhami k danému dátumu.

Postup výrobcu vracia obrázok po asynchrónnom spracovaní spolu s rozšíreným zadaním. Podpísaný odkaz na stiahnutie obrázka je platný jednu hodinu. Uchovajte samotný obrázok, konečné zadanie a referencie namiesto spoliehania sa na dočasný odkaz. Pri posúdenom vizuáli porovnajte požadovaný text, umiestnenie objektov, referenčnú identitu a zmenenú oblasť pri zamýšľanej veľkosti zobrazenia. Dokončené generovanie je východiskom na kontrolu týchto vizuálnych požiadaviek.

Ailoot Ultra · Obrázky 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

Úvod

Povolené vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Obrázky POST /v1/images/generations

Vstup: text, image
Výstup: image

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity black-forest-labs/flux-3-image	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`resolution`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 768, 1K, 1.5K, 2K, 4K	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 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	Predvolené—
Pole`n`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 1	Predvolené—
Pole`input_references`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 10	Predvolené—
Pole`provider`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt
Parameter`material_types`	Špecifikáciatext, image

Životný cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.082 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Obrázky

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

Prijať a uložiť výsledky

Ailoot Ultra · Obrázky

Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Čítanie ďalšieho obsahu

Čítať existujúce podklady, ktoré vám patria

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.

Uchovať všetky dokončené výsledky

Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.

Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.

Ak treba overiť pôvodnú odpoveď

Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.

Polia odpovede

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelov

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

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image

Aké vstupy a výsledky sú dostupné?: POST /v1/images/generations · black-forest-labs/flux-3-image: text, image → image
Aké polia používa požiadavka?: POST /v1/images/generations · black-forest-labs/flux-3-image: model, prompt, resolution, aspect_ratio, n, input_references, provider
Aké limity platia?: POST /v1/images/generations · black-forest-labs/flux-3-image: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.3 Image