Black Forest Labs: FLUX.2 Flex

FLUX.2 [flex] se specializuje na obrazovou typografii a drobné vizuální detaily s nastavitelnými kroky vzorkování a guidance. Používejte text a obrazové reference pro plakáty, produktová rozvržení či přesné úpravy a vyvažujte dodržování zadání s realističností.

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

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 [flex] je edice Black Forest Labs pro generování a úpravy obrázků specializovaná na typografii, vykreslování textu a zachování drobných detailů. Používá písemné pokyny ke scéně a obrazové reference k vytvoření obrázku. Jejím určujícím ovládáním je nastavitelné vzorkování: dokumentovaný profil zpřístupňuje inferenční kroky i guidance a umožňuje doladit vizuální zadání nastaveními i slovy.

Písmo a jemné detaily

Typografická úloha má začít skutečným textem. Každý řádek uveďte v uvozovkách, určete jeho umístění a odlište nadpis, podpůrný text a popisek. Styl, velikost a barvu písma popište ve vztahu ke scéně. Vlastní zadání plakátu může ukazovat kobaltově modré kolo ve světlém studiu s velkým titulkem nad rámem a menším řádkem specifikací pod ním. Obrázek musí společně objasňovat produkt i pořadí čtení.

U podrobného produktového vizuálu určete části rozhodující o užitečnosti výsledku: ciferník, popisek ovládacího prvku, šev, hranu materiálu či značení obalu. Dodejte čitelnou referenci a vysvětlete, kterou vlastnost určuje. I obecně podobná scéna může změnit zásadní znak nebo součást, proto generovaný detail porovnejte v zamýšlené velikosti zobrazení. Specializace modelu je důvodem pro přesné požadavky, nikoli zárukou, že korektura či vizuální kontrola přestává být nutná.

Kroky a guidance slouží různým účelům

Konkrétní profil výrobce přijímá jeden až padesát inferenčních kroků s výchozí hodnotou padesát. Popis spojuje více kroků s většími detaily a realističností. Guidance má rozsah 1,5 až 10 s výchozí hodnotou 5. Vyšší guidance posiluje dodržování promptu, ale může snížit realističnost. Obrázek s přesnými designovými pokyny a obrázek usilující o přirozený fotografický vzhled proto mohou vyžadovat odlišné volby v rámci tohoto profilu.

Při porovnávání změny nastavení ponechte znění, reference a formát výstupu stejné. Sledujte vlastnost, která změnu vyvolala: tvary písmen, umístění objektu nebo texturu materiálu. Nastavení měňte z konkrétního vizuálního důvodu místo předpokladu, že velké číslo je automaticky lepší. Jde o ovládání vzorkování výrobce; čtyřkrokový destilovaný profil [klein] a standardní ovládání [pro] či [max] jsou jinými volbami modelu.

Rozšíření promptu je ve specifikaci [flex] ve výchozím stavu zapnuté a lze je vypnout vlastním ovládáním prompt_upsampling. To umožňuje v případě potřeby ponechat podrobné zadání jako dodaný text. Sdílená příručka výrobce doporučuje umístit hlavní objekt a důležitý děj před druhotnou výzdobu a vedle zadání v přirozeném jazyce popisuje také prompty strukturované jako JSON. Použijte strukturu, v níž se potřebné vztahy určují nejsnáze.

Úpravy vedené referencemi

Konkrétní profil požadavku obsahuje osm pozic pro referenční obrázky. Interaktivní postup výrobce samostatně dovoluje až deset obrázků; tyto počty popisují různá rozhraní. Určete, zda obrázek dodává scénu k úpravě, produkt, postavu, oděv nebo styl. U úpravy označte objekt a změnu a poté pojmenujte okolní kompozici, materiály či světlo, které mají zůstat.

Vlastní úloha návrhu obalu může použít krabici z prvního obrázku a povrch z druhého, nahradit přední etiketu schváleným zněním a zachovat proporce krabice. Skupinová kompozice může každému objektu přiřadit samostatnou referenci a tato přiřazení udržet konzistentní. Příklady rodiny pokrývají změny předmětů a pozadí, kompozice, úpravy textu a stylové transformace. Požadujte jednu souvislou úpravu s jasným cílem a poté porovnejte upravenou oblast i části, které měly zůstat stabilní.

Velikost, barva a vrácený obrázek

Příručka FLUX.2 dokumentuje minimum 64×64 pixelů, rozměry v násobcích 16 a výstup do 4 megapixelů, přičemž pro běžné použití doporučuje do 2 megapixelů. Konkrétní specifikace [flex] uvádí JPEG, PNG a WebP s výchozím JPEG. Poskytuje také volitelný náhodný seed. Při porovnávání verzí uchovejte se zdrojovými referencemi skutečný model, seed a nastavení vzorkování; samotná pojmenovaná rodina neurčuje úplnou konfiguraci generování.

Při práci citlivé na barvy spojte každý hexadecimální kód s pojmenovaným objektem nebo textovým prvkem. Pro kompozici určete zamýšlený poměr stran prostřednictvím rozměrů obrázku a ponechte dostatek místa pro čitelné písmo. Sdílená příručka nemá mechanismus negativního promptu, proto požadovaný vzhled popisujte pozitivně: ostré zaostření, čisté pozadí či jasně prázdná oblast pro text. Její vícejazyčné příklady podporují psaní kulturně specifického zadání ve vhodném jazyce, aniž by stanovovaly záruku pevného počtu jazyků.

Postup FLUX.2 výrobce vrací obrázek po zpracování a používá dočasné podepsané odkazy s desetiminutovým intervalem pro načtení. Samotný obrázek a zadání uchovejte společně. Před vložením materiálu do rozvržení zkontrolujte typografii, jemné detaily, identitu referencí a vizuální zpracování. Konečným výstupem může být vybraný plakát, produktový obrázek nebo upravená kompozice s přesnými nastaveními uchovanými pro další revizi.

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

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-flex	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 vstupního obrázku	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza megapixel vstupního obrázku	Poplatek Vstup · megapixel vstupního obrázku · Odhad pouze pro srovnání $0.12 za megapixel vstupního obrázku
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.12 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.12 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-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

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-flex

Aliasy cest metod

/v1/images

Související ID modelů

black-forest-labs/flux.2-flex

FAQ · Black Forest Labs: FLUX.2 Flex

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

Black Forest Labs: FLUX.2 Flex