Black Forest Labs: FLUX.2 Max

FLUX.2 [max] je obrazový model Black Forest Labs pro náročné finální materiály a konzistentní úpravy. Jeho dokumentovaný profil spojuje vizuální reference, podrobné ovládání scény a webové ukotvení pro aktuální témata s výstupem až 4 megapixely.

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

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

FLUX.2 [max] je člen rodiny Black Forest Labs pro generování a úpravy obrázků FLUX.2 s nejvyšší kvalitou. Výrobce jej určuje pro náročné finální materiály, důsledné dodržování složitého zadání a konzistenci napříč úpravami. Vytváří obrázek z písemného popisu nebo používá dodané obrázky jako vizuální reference. Jeho rozlišující schopností v rodině je vyhledávání pro ukotvení v reálných informacích: požadavek může využívat aktuální informace místo spoléhání jen na scénu popsanou v promptu.

Informace z reálného světa a vizuální zadání

Výrobce dokumentuje webové vyhledávání pro témata jako aktuální počasí, nedávná sportovní událost nebo historické prostředí. Určete skutečné místo, událost a čas důležité pro obrázek a výtvarné zpracování popište samostatně. Koncept karty počasí s faktickým ukotvením může určit město, zobrazovaný stav, přesný nadpis a rozvržení. Vyhledávání informuje generování; i atraktivní ilustrace vyžaduje kontrolu viditelných faktů proti příslušnému zdroji, než se stane faktickým sdělením.

Tato schopnost vyhledávání patří v publikovaném srovnání FLUX.2 variantě [max]. Ostatní pojmenovaní členové mají vlastní role: [pro] pro produkci, [flex] pro nastavitelné vzorkování a typografii a [klein] pro kompaktní interaktivní generování. Název zvoleného modelu uchovejte u výsledku, aby pozdější úprava bez upozornění nenahradila profil s faktickým ukotvením jinou edicí.

Reference pro náročné úpravy

Dokumentovaný profil požadavku přijímá až osm referenčních obrázků; interaktivní rozhraní výrobce samostatně dovoluje deset. Každé referenci přiřaďte roli, například vzhled postavy, design produktu, oděv, místnost nebo vizuální styl. Kompozice může spojit židli z jednoho obrázku s místností z jiného při zachování siluety a materiálu židle. U existující scény určete předmět ke změně a detaily k zachování včetně směru světla a okolní geometrie.

Příklady rodiny zahrnují změny pozadí, nahrazování předmětů, kompozice nábytku, úpravy textu a konzistentní postavy. Vlastní zadání finálního materiálu může umístit dodané hodinky na tmavou skládanou látku, zachovat design ciferníku a řemínku a změnit jen osvětlení na měkké boční světlo. Pojmenujte zdroj každé vlastnosti a společně zkontrolujte výsledný ciferník, značení, materiál i odlesky. Pokyn k zachování stanovuje cíl; vrácený obrázek je důkazem pro porovnání s ním.

Text, barvy a interpretace promptu

Příručka FLUX.2 doporučuje strukturu objekt–děj–styl–kontext s důležitými prvky na začátku. Navrhuje 10–30 slov pro rychlé koncepty, 30–80 pro běžné projekty a delší popisy složitých scén. Jde o doporučení pro psaní, nikoli pevné limity kontextu. Přirozený jazyk i popisy scén strukturované jako JSON jsou dokumentovanými způsoby uspořádání objektů, umístění, světla a stylu. Strukturovaný prompt je obrazovým zadáním, nikoli příslibem strukturované textové odpovědi.

U viditelného písma uveďte přesné znění v uvozovkách, určete polohu a popište typografickou hierarchii. Každou hexadecimální barvu spojte s konkrétním objektem nebo textovým prvkem; kód barvy bez pojmenovaného cíle je nejednoznačný. Příručka výrobce používá pozitivní popisy místo mechanismu negativního promptu. U produktové scény s volným místem pro nadpis přímo popište prázdnou oblast a její zamýšlenou polohu.

Konkrétní specifikace požadavku [max] ve výchozím stavu používá rozšíření promptu. Ovládání disable_pup jej vypíná, má-li se pečlivě napsané zadání použít v dodané podobě. To se liší od tvrzení, že se každé slovo objeví ve finálním obrázku beze změny. Při hodnocení, zda nečekané vizuální rozhodnutí vzniklo z pokynu či jeho interpretace, uchovejte u výsledku skutečné zadání a zvolené nastavení.

Výstup a užitečný finální materiál

Příručka rodiny dokumentuje obrázky až do 4 megapixelů s explicitními rozměry alespoň 64×64 a v násobcích 16. Pro běžné použití doporučuje do 2 megapixelů. Konkrétní profil [max] uvádí JPEG, PNG a WebP s výchozím JPEG a volitelným náhodným seedem. Výstupní formát zvolte podle zamýšleného umístění před sestavením kompozice. Generování obrázku modelem je oddělené od změny velikosti již hotového materiálu.

Při výběru finální verze uchovejte obrázek, reference, prompt, rozměry a identitu modelu. Příručka FLUX.2 výrobce upozorňuje na dočasnost podepsaného odkazu na výsledek s desetiminutovým intervalem pro načtení. V zamýšlené velikosti zobrazení prohlédněte drobný text, identitu objektu, rozvržení, světlo a fakta převzatá z vyhledávání. Užitečným výstupem je zvolený vizuál s dostatkem kontextu pro přesnou další úpravu, ne scéna, jejíž důležité detaily nebyly se zadáním nikdy porovnány.

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

Přijímané vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metody

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

Vstup: text, image
Výstup: image

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity black-forest-labs/flux.2-max	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Minimální délka: 1	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Výchozí—
Pole`output_format`	Typ`string`	PožadavekVolitelné	Hodnoty a limity png, jpeg	Výchozí—
Pole`n`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 1	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 8	Výchozí—
Pole`provider`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Životní cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Účtovací jednotka	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
Konfiguracemegapixel výstupního obrázku	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza megapixel výstupního obrázku	Poplatek Výstup · megapixel výstupního obrázku · Odhad pouze pro srovnání $0.14 za megapixel výstupního obrázku
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Účtovací jednotka—	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.14 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

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

Přijímání a ukládání výsledků

Ailoot Ultra · Obrázky

Stáhněte každý vrácený obrázek nebo 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}

Další načtení obsahu

Načíst existující soubory, které vám patří

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.

Uchovejte všechny dokončené výsledky

Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.

Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.

Pokud je nutné ověřit původní odpověď

Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.

Pole odpovědi

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

Aliasy

Aliasy modelu

Ailoot Ultra black-forest-labs/flux.2-max

Aliasy cest metod

/v1/images

Související ID modelů

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

Jaké vstupy a výsledky jsou dostupné?: POST /v1/images/generations · black-forest-labs/flux.2-max: text, image → image
Jaká pole požadavek používá?: POST /v1/images/generations · black-forest-labs/flux.2-max: model, prompt, aspect_ratio, output_format, n, input_references, provider
Jaké limity platí?: POST /v1/images/generations · black-forest-labs/flux.2-max: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Max