Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] je produkční obrazový model Black Forest Labs pro tvorbu z textu a úpravy vedené referencemi. Jeho dokumentovaný profil spojuje fotorealistické detaily, ovládání textu a barev se společným pixelovým rozpočtem referencí a výstupu a obrázky až do 4 megapixelů.

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

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 [pro] je model Black Forest Labs pro generování a úpravy obrázků zaměřený na produkční práci. Výrobce jej představuje jako výchozí volbu pro většinu vizuálních úloh FLUX.2: vytvoření nového obrázku z textu nebo přepracování scény pomocí vizuálních referencí. Schopnosti rodiny zahrnují fotorealistické materiály a osvětlení, čitelný text, pokyny k přesné barvě a konzistentní objekty napříč souvisejícími úpravami. Vráceným výstupem je obrázek pro produktovou scénu, redakční kompozici, návrhový koncept nebo vizuální komunikaci.

Připravte produkční zadání

Začněte objektem, tím, co dělá nebo jak je uspořádán, stylem a prostředím či světlem. Příručka promptů výrobce věnuje větší pozornost počátečním slovům a doporučuje uvést zásadní objekt a děj před ozdobnými detaily. Navrhuje 10–30 slov pro rychlé koncepty a 30–80 pro běžné projekty, s delšími popisy složitých scén. Tyto rozsahy jsou doporučením pro psaní promptů, nikoli limitem textového kontextu.

Vlastní katalogové zadání může ukazovat lampu z kartáčované oceli na teple šedé desce stolu ve tříčtvrtečním pohledu odhalujícím vypínač a stínidlo. Určete povrch, osvětlení a úhel pohledu, díky nimž bude produkt rozpoznatelný. U infografiky či marketingového obrázku nejprve stanovte viditelné znění a hierarchii; přesný nadpis uveďte v uvozovkách, určete jeho umístění a pojmenujte styl i velikost písma. Popisky, množství a detaily produktu kontrolujte v konečné velikosti zobrazení.

Příručka rodiny dokumentuje prompty v přirozeném jazyce i strukturované jako JSON. Strukturované zadání scény může vést objekt, pozadí, světlo a kompozici v samostatných polích, aby se jeden požadavek dal jasně upravit. Podporuje také popisy barev pomocí hexadecimálních kódů: kód spojte s konkrétním objektem nebo textem, který se má obarvit. Požadovaný vzhled popište pozitivně, protože dokumentovaný postup promptování FLUX.2 neposkytuje negativní prompty.

Úpravy pomocí referencí a společného pixelového rozpočtu

Konkrétní profil požadavku [pro] nabízí osm pozic pro referenční obrázky; interaktivní rozhraní výrobce samostatně podporuje deset. Každému obrázku přiřaďte roli, například vzhled objektu, oděv, design produktu, místnost či styl. U existující scény uveďte prvek ke změně a kompozici, okolí i vizuální detaily k zachování. Publikované příklady zahrnují kompozice nábytku, změny pozadí či počasí, náhradní předměty a úpravy textu.

Kapacita referencí závisí také na velikosti výstupu. Příručka výrobce pro [pro] určuje celkový rozpočet 9 megapixelů pro vstup a výstup. Její příklady dovolují osm referencí při výstupu 1 megapixel a sedm při 2 megapixelech; s růstem požadovaného výsledku se kapacita referencí snižuje. Zdrojovou sadu a výstup plánujte společně místo předpokladu, že maximální počet pozic je dostupný při každé výstupní velikosti. Používejte reference poskytující nutné informace a určete jejich zamýšlený přínos.

U produktové kompozice může první obrázek dodat produkt, druhý místnost a třetí povrchovou úpravu materiálu. Vysvětlete, jak se mají spojit do jedné souvislé scény. Pokud výsledek změní tvar, značení nebo identitu, které měly zůstat, v dalším kroku se zaměřte na tuto chybu místo nahrazení celého zadání. Praktickým výsledkem je upravený obrázek, u něhož se věrnost referencím a konkrétní změna porovnávají se vstupy.

Rozšíření promptu a pevné či náhledové profily

Konkrétní specifikace [pro] ve výchozím stavu zapíná rozšíření promptu. Ovládání disable_pup toto rozšíření zastaví, pokud se má pečlivě napsaný pokyn použít v dodané podobě. Při porovnávání verzí zachovejte zvolené nastavení, protože stejný krátký koncept a rozšířený popis jsou odlišnými vstupy generování. Jde o ovládání profilu výrobce, nikoli záruku, že se každý požadovaný detail objeví správně.

Dokumentace rozlišuje prostý endpoint [pro] jako pevný snímek modelu a [pro] Preview, do kterého přicházejí následná zlepšení. Struktury požadavků a odpovědí jsou stejné, základní váhy se však liší. U obrázku a referencí uchovejte přesný zvolený profil. Samostatný štítek Preview nemá bez upozornění nahradit prostou volbu [pro], pokud úprava závisí na stejné dokumentované volbě modelu.

Rozměry, formáty a vybraný výstup

Příručka rodiny dokumentuje výstup až 4 megapixely s explicitními rozměry alespoň 64×64 a v násobcích 16. Pro většinu použití doporučuje do 2 megapixelů. Šířka a výška určují zamýšlené rámování; čtvercový produktový obrázek, rozvržení na výšku a široká redakční scéna rozdělují prostor odlišně. Konkrétní požadavek uvádí výstup JPEG, PNG a WebP s výchozím JPEG a volitelným seedem.

Profil [max] má samostatnou funkci vyhledávání pro ukotvení v reálných informacích, [flex] zpřístupňuje kroky vzorkování a guidance a [klein] má menší profil se čtyřmi referencemi. Edici vybírejte podle potřebné práce místo přenášení těchto ovládacích prvků do [pro]. U vybraného výstupu uchovejte samotný obrázek, konečný prompt, reference, rozměry a označení modelu. Podepsané odkazy na výsledky FLUX.2 výrobce vyprší po deseti minutách, proto obrázek načtěte místo spoléhání na dočasnou adresu. Před vložením výsledku do materiálu pro zákazníky zkontrolujte identitu objektu, barvy, text, kompozici a upravené detaily.

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

black-forest-labs/flux.2-pro

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

Ú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-pro	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.06 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.06 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-pro', '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-pro

Aliasy cest metod

/v1/images

Související ID modelů

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

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

Black Forest Labs: FLUX.2 Pro