Black Forest Labs: FLUX.2 Flex

FLUX.2 [flex] sa špecializuje na typografiu v obrázkoch a malé vizuálne detaily, s nastaviteľnými krokmi vzorkovania a guidance. Textové a obrazové referencie použite na tvorbu plagátov, produktových rozložení alebo presných revízií pri vyvažovaní dodržiavania pokynov a realizmu.

Ailoot Ultra · Obrázky POST /v1/images/generations black-forest-labs/flux.2-flex

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.2 [flex] je edícia Black Forest Labs na generovanie a úpravu obrázkov, špecializovaná na typografiu, vykresľovanie textu a zachovanie malých detailov. Na vytvorenie obrázka používa písané pokyny pre scénu a obrazové referencie. Jej určujúcim ovládaním je nastaviteľné vzorkovanie: dokumentovaný profil sprístupňuje inferenčné kroky aj guidance, čo umožňuje spresňovať vizuálne zadanie nastaveniami aj slovami.

Písmo a jemné detaily

Typografická úloha má začať skutočným textom. Každý riadok dajte do úvodzoviek, určte jeho miesto a odlíšte nadpis, podporný text a štítok. Štýl, mierku a farbu písma opíšte vo vzťahu ku scéne. Pôvodné zadanie plagátu môže zobrazovať kobaltovomodrý bicykel vo svetlom štúdiu s veľkým nadpisom nad rámom a menším riadkom špecifikácie pod ním. Obrázok musí spoločne objasniť produkt aj poradie čítania.

Pri podrobnom produktovom vizuáli určte časti rozhodujúce o užitočnosti výsledku: ciferník, označenie ovládania, šev, okraj materiálu alebo označenie obalu. Dodajte čitateľnú referenciu a vysvetlite, ktorú vlastnosť určuje. Všeobecne podobná scéna môže stále zmeniť rozhodujúci znak či komponent, preto vygenerovaný detail porovnajte pri zamýšľanej veľkosti zobrazenia. Špecializácia modelu je dôvodom na presné požiadavky, nie zárukou, že korektúra či vizuálna kontrola prestanú byť potrebné.

Kroky a guidance slúžia rôznym účelom

Presný profil výrobcu prijíma jeden až päťdesiat inferenčných krokov, s predvolenými päťdesiatimi. Jeho opis spája viac krokov s väčším množstvom detailov a realizmom. Guidance sa pohybuje od 1.5 do 10, s predvolenou hodnotou 5. Vyššia guidance posilňuje dodržiavanie zadania, ale môže znížiť realizmus. Obrázok s presnými dizajnovými pokynmi a obrázok požadujúci prirodzený fotografický vzhľad preto môžu vyžadovať odlišné voľby v tomto profile.

Pri porovnávaní zmeny nastavenia zachovajte znenie, referencie a tvar výstupu. Sledujte vlastnosť, ktorá zmenu vyvolala: tvary písmen, umiestnenie predmetu alebo textúru materiálu. Nastavenie meňte z konkrétneho vizuálneho dôvodu namiesto automatického považovania väčšieho čísla za lepšie. Ide o ovládanie vzorkovania výrobcu; štvorkrokový destilovaný profil [klein] a štandardné ovládanie [pro] či [max] predstavujú odlišné voľby modelu.

Rozšírenie zadania je v špecifikácii [flex] predvolene zapnuté a možno ho vypnúť jeho vlastným ovládaním prompt_upsampling. To umožňuje ponechať podrobné zadanie ako dodaný text, keď je to vhodné. Spoločný návod výrobcu odporúča umiestniť hlavný subjekt a dôležitú akciu pred druhotnú dekoráciu a popri zadaniach v prirodzenom jazyku opisuje aj zadania štruktúrované v JSON. Použite štruktúru, ktorá umožňuje najľahšie určiť potrebné vzťahy.

Revízie vedené referenciami

Presný profil požiadavky obsahuje osem pozícií referenčných obrázkov. Interaktívny postup výrobcu samostatne povoľuje až desať obrázkov; tieto počty opisujú rôzne rozhrania. Určte, či obrázok poskytuje scénu na úpravu, produkt, postavu, odev alebo štýl. Pri revízii identifikujte objekt a zmenu a potom pomenujte okolitú kompozíciu, materiály či svetlo, ktoré majú zostať.

Pôvodná úloha s obalom môže použiť škatuľu z prvého obrázka a povrchovú úpravu z druhého, nahradiť predný štítok schváleným textom a zachovať proporcie škatule. Skupinová kompozícia môže každému subjektu priradiť samostatnú referenciu a tieto priradenia udržiavať konzistentné. Príklady rodiny zahŕňajú zmeny objektov a pozadia, kompozitné zostavy, úpravy textu a premeny štýlu. Požadujte jednu súvisiacu revíziu s jasným cieľom a potom porovnajte upravenú oblasť aj časti určené na zachovanie stability.

Veľkosť, farba a vrátený obrázok

Návod FLUX.2 dokumentuje minimum 64×64 pixelov, rozmery v násobkoch 16 a výstup do 4 megapixelov, pričom pre bežné použitie odporúča najviac 2 megapixely. Presná špecifikácia [flex] uvádza výstup JPEG, PNG a WebP s predvoleným JPEG. Poskytuje aj voliteľný náhodný seed. Pri porovnávaní verzií uchovajte skutočný model, seed a nastavenia vzorkovania so zdrojovými referenciami; samotný názov rodiny neidentifikuje úplnú konfiguráciu generovania.

Pri práci citlivej na farby priraďte každý hexadecimálny kód k pomenovanému objektu alebo textovému prvku. Pri kompozícii určte zamýšľaný pomer strán prostredníctvom rozmerov obrázka a nechajte dosť priestoru na čitateľné nápisy. Spoločný návod nemá mechanizmus negatívneho zadania, preto požadovaný vzhľad opisujte pozitívne: ostré zaostrenie, čisté pozadie alebo jasne prázdna oblasť pre text. Jeho viacjazyčné príklady podporujú písanie kultúrne špecifického zadania v príslušnom jazyku bez stanovenia zaručeného pevného počtu jazykov.

Postup FLUX.2 výrobcu vracia obrázok po spracovaní a používa dočasné podpísané odkazy s desaťminútovým oknom na načítanie. Uchovajte samotný obrázok aj zadanie spoločne. Pred vložením vizuálu do rozloženia skontrolujte typografiu, jemné detaily, referenčnú identitu a vizuálne spracovanie. Konečným výstupom môže byť vybraný plagát, produktový obrázok alebo upravená kompozícia s presnými nastaveniami uchovanými pre ďalšiu revíziu.

Ailoot Ultra · Obrázky POST /v1/images/generations black-forest-labs/flux.2-flex

black-forest-labs/flux.2-flex

Black Forest Labs /black-forest-labs/flux.2-flex

Ú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.2-flex	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Predvolené—
Pole`output_format`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity png, jpeg	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: 8	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	Účtovacia jednotka	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Účtovacia jednotka—	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áciamegapixel vstupného obrázka	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza megapixel vstupného obrázka	Poplatok Vstup · megapixel vstupného obrázka · Odhad iba na porovnanie $0.12 za megapixel vstupného obrázka
Konfiguráciamegapixel výstupného obrázka	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza megapixel výstupného obrázka	Poplatok Výstup · megapixel výstupného obrázka · Odhad iba na porovnanie $0.12 za megapixel výstupného obrázka
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Účtovacia jednotka—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.12 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.2-flex', '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.2-flex

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

black-forest-labs/flux.2-flex

FAQ · Black Forest Labs: FLUX.2 Flex

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

Black Forest Labs: FLUX.2 Flex