Black Forest Labs: FLUX.2 Max

FLUX.2 [max] je obrazový model Black Forest Labs pre náročné konečné vizuály a konzistentné úpravy. Jeho dokumentovaný profil spája vizuálne referencie, podrobné ovládanie scény a ukotvenie v webových zdrojoch pre aktuálne subjekty, s výstupom do 4 megapixelov.

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

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 [max] je člen rodiny modelov Black Forest Labs na generovanie a úpravu obrázkov FLUX.2 s najvyššou kvalitou. Výrobca ho určuje pre náročné konečné vizuály, dôsledné dodržiavanie zložitého zadania a konzistentnosť pri úpravách. Vytvára obrázok z písaného opisu alebo používa dodané obrázky ako vizuálne referencie. Jeho odlišujúcou schopnosťou v rámci rodiny je vyhľadávanie na ukotvenie v zdrojoch: požiadavka môže čerpať z aktuálnych informácií namiesto spoliehania sa iba na scénu opísanú v zadaní.

Informácie zo skutočného sveta a vizuálne zadanie

Výrobca dokumentuje webové vyhľadávanie pre subjekty ako aktuálne počasie, nedávne športové podujatie alebo historické prostredie. Určte skutočné miesto, udalosť a čas relevantné pre obrázok a umelecké spracovanie opíšte samostatne. Koncept karty počasia ukotvený v zdrojoch môže určiť mesto, podmienku na vizualizáciu, presný nadpis a rozloženie. Vyhľadávanie informuje generovanie; príťažlivá ilustrácia stále vyžaduje kontrolu viditeľných faktov voči relevantnému zdroju pred použitím vo faktickej komunikácii.

Táto vyhľadávacia schopnosť patrí v publikovanom porovnaní FLUX.2 k [max]. Ostatní pomenovaní členovia majú vlastné úlohy: [pro] pre produkciu, [flex] pre nastaviteľné vzorkovanie a typografiu a [klein] pre kompaktné interaktívne generovanie. Názov zvoleného modelu uchovajte s výsledkom, aby neskoršia revízia potichu nenahradila profil podporujúci zdrojové ukotvenie inou edíciou.

Referencie pre náročné úpravy

Dokumentovaný profil požiadavky prijíma až osem referenčných obrázkov; interaktívne rozhranie výrobcu samostatne povoľuje desať. Každej referencii priraďte úlohu, napríklad vzhľad postavy, dizajn produktu, odev, miestnosť alebo vizuálny štýl. Kompozícia môže spojiť stoličku z jedného obrázka s miestnosťou z druhého a zachovať pritom siluetu aj materiál stoličky. Pri existujúcej scéne určte objekt na zmenu a detaily na zachovanie vrátane smeru svetla a okolitej geometrie.

Príklady rodiny zahŕňajú zmeny pozadia, nahradenie predmetov, nábytkové kompozície, úpravy textu a konzistentné postavy. Pôvodné zadanie konečného vizuálu môže umiestniť dodané hodinky na tmavú poskladanú látku, zachovať dizajn ciferníka a remienka a zmeniť iba osvetlenie na jemné bočné svetlo. Pomenujte, ktorý zdroj poskytuje každú vlastnosť, a spoločne kontrolujte výsledný ciferník, označenia, materiál a odrazy. Pokyn na zachovanie stanovuje cieľ; vrátený obrázok je dôkazom na porovnanie s týmto cieľom.

Text, farby a interpretácia zadania

Návod FLUX.2 odporúča štruktúru subjekt–akcia–štýl–kontext s dôležitými prvkami na začiatku. Navrhuje 10–30 slov pre rýchle koncepty, 30–80 pre bežné projekty a dlhšie opisy pre zložitú scénu. Ide o odporúčania pri písaní, nie pevné kontextové limity. Prirodzený jazyk aj opisy scén štruktúrované v JSON sú dokumentované spôsoby usporiadania subjektov, umiestnenia, svetla a štýlu. Štruktúrované zadanie je zadanie obrázka, nie prísľub štruktúrovanej textovej odpovede.

Pri viditeľných nápisoch znenie dajte do úvodzoviek, určte jeho polohu a opíšte typografickú hierarchiu. Každú hexadecimálnu farbu priraďte ku konkrétnemu objektu alebo textovému prvku; farebný kód bez pomenovaného cieľa je nejednoznačný. Návod výrobcu používa pozitívne opisy namiesto mechanizmu negatívneho zadania. Pri produktovej scéne s prázdnym priestorom pre nadpis opíšte priamo túto prázdnu oblasť a jej zamýšľanú polohu.

Presná špecifikácia požiadavky [max] predvolene používa rozšírenie zadania. Ovládanie disable_pup ho vypne, keď sa má starostlivo napísané zadanie použiť v dodanej podobe. To sa líši od tvrdenia, že každé slovo sa v konečnom obrázku zobrazí nezmenené. Skutočné zadanie a zvolené nastavenie uchovajte s výsledkom pri posudzovaní, či nečakané vizuálne rozhodnutie pochádzalo z pokynu alebo jeho interpretácie.

Výstup a užitočný konečný vizuál

Návod rodiny dokumentuje obrázky do 4 megapixelov s explicitnými rozmermi aspoň 64×64 a násobkami 16. Pre bežné použitie odporúča najviac 2 megapixely. Presný profil [max] uvádza JPEG, PNG a WebP s predvoleným JPEG a voliteľným náhodným seedom. Tvar výstupu vyberte pre zamýšľané umiestnenie pred usporiadaním kompozície. Generovanie obrázkov modelom je oddelené od zmeny veľkosti už dokončeného vizuálu.

Pri výbere konečnej verzie uchovajte obrázok, referencie, zadanie, rozmery a identitu modelu. Návod výrobcu FLUX.2 upozorňuje, že podpísaný odkaz na výsledok je dočasný, s desaťminútovým oknom na načítanie. Pri zamýšľanej veľkosti zobrazenia kontrolujte drobný text, identitu objektov, rozloženie, svetlo a všetky fakty získané vyhľadávaním. Užitočným výstupom je vybraný vizuál s dostatočným kontextom na pokračovanie presnej revízie, nie scéna, ktorej dôležité detaily sa nikdy neporovnali so zadaním.

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

black-forest-labs/flux.2-max

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

Ú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-max	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 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.14 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.14 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-max', '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-max

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

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

Black Forest Labs: FLUX.2 Max