Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] je produkčný obrazový model Black Forest Labs na tvorbu vedenú textom a úpravy vedené referenciami. Jeho dokumentovaný profil spája fotorealistické detaily, ovládanie textu a farieb s pixelovým rozpočtom pre referencie/výstup a obrázkami do 4 megapixelov.

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

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 [pro] je model Black Forest Labs na generovanie a úpravu obrázkov so zameraním na produkčné použitie. Výrobca ho predstavuje ako predvolenú voľbu pre väčšinu vizuálnych úloh FLUX.2: vytvorenie nového obrázka z textu alebo úpravu scény pomocou vizuálnych referencií. Schopnosti rodiny zahŕňajú fotorealistické materiály a osvetlenie, čitateľný text, pokyny pre presné farby a konzistentné subjekty pri súvisiacich úpravách. Vráteným výstupom je obrázok na použitie v produktovej scéne, redakčnej kompozícii, dizajnovom koncepte alebo vizuálnej komunikácii.

Pripravte produkčné zadanie

Začnite subjektom, tým, čo robí alebo ako je usporiadaný, štýlom a prostredím či svetlom. Návod výrobcu na zadania venuje väčšiu pozornosť úvodným slovám a odporúča uvádzať podstatný subjekt a akciu pred dekoratívnymi detailmi. Navrhuje 10–30 slov pre rýchle koncepty a 30–80 pre bežné projekty, s dlhšími opismi pre zložité scény. Tieto rozsahy sú usmernením pri písaní zadania, nie limitom textového kontextu.

Pôvodné katalógové zadanie môže zobrazovať lampu z brúsenej ocele na teplosivom stole v trojštvrťovom pohľade, ktorý odhaľuje vypínač a tienidlo. Určte povrch, osvetlenie a uhol pohľadu, vďaka ktorým je produkt rozpoznateľný. Pri infografike alebo marketingovom obrázku najprv ustáľte viditeľné znenie a hierarchiu; presný nadpis dajte do úvodzoviek, určte umiestnenie a pomenujte štýl aj veľkosť písma. Štítky, množstvá a produktové detaily kontrolujte pri konečnej veľkosti zobrazenia.

Návod rodiny dokumentuje zadania v prirodzenom jazyku aj štruktúrované v JSON. Štruktúrované zadanie scény môže uchovávať subjekt, pozadie, svetlo a kompozíciu v samostatných poliach, aby sa jedna požiadavka dala jasne upraviť. Podporuje aj opisy hexadecimálnych farieb: kód priraďte ku konkrétnemu objektu alebo textu, ktorý sa má zafarbiť. Požadovaný vzhľad opisujte pozitívne, pretože dokumentovaný postup zadávania FLUX.2 neposkytuje negatívne zadania.

Upravujte s referenciami a spoločným pixelovým rozpočtom

Presný profil požiadavky [pro] ponúka osem pozícií referenčných obrázkov; interaktívne rozhranie výrobcu samostatne podporuje desať. Každému obrázku priraďte úlohu, napríklad vzhľad subjektu, odev, dizajn produktu, miestnosť alebo štýl. Pri existujúcej scéne určte prvok na zmenu a kompozíciu, okolie aj vizuálne detaily, ktoré majú zostať. Publikované príklady zahŕňajú nábytkové kompozície, zmeny pozadia alebo počasia, náhradné predmety a úpravy textu.

Kapacita referencií závisí aj od veľkosti výstupu. Návod výrobcu pre [pro] určuje celkový rozpočet 9 megapixelov pre vstup a výstup. Jeho príklady povoľujú osem referencií pri výstupe 1 megapixel a sedem pri výstupe 2 megapixely, pričom s rastúcim výsledkom znižujú referenčnú kapacitu. Zdrojovú zostavu a výstup plánujte spoločne namiesto predpokladu, že maximálny počet pozícií je dostupný pre každú veľkosť výstupu. Použite referencie poskytujúce potrebné informácie a určte ich zamýšľaný prínos.

Pri produktovej kompozícii môže prvý obrázok poskytovať produkt a druhý miestnosť, zatiaľ čo tretí určuje povrchovú úpravu materiálu. Vysvetlite, ako majú vytvoriť jednu súdržnú scénu. Ak výsledok zmení tvar, označenie alebo identitu, ktoré sa mali zachovať, v ďalšom kroku zacieľte na tento problém namiesto nahradenia celého zadania. Praktickým výsledkom je upravený obrázok s vernosťou referenciám a konkrétnou zmenou porovnanou so vstupmi.

Rozšírenie zadania a pevné verzus ukážkové profily

Presná špecifikácia [pro] predvolene zapína rozšírenie zadania. Ovládanie disable_pup toto rozšírenie zastaví, keď sa má starostlivo napísaný pokyn použiť v dodanej podobe. Pri porovnávaní verzií zachovajte zvolené nastavenie, pretože rovnaký krátky koncept a rozšírený opis sú odlišné vstupy generovania. Ide o ovládanie profilu výrobcu, nie o záruku, že sa každý požadovaný detail zobrazí správne.

Dokumentácia rozlišuje bežný endpoint [pro] ako pevný snapshot od [pro] Preview, do ktorého sa zavádzajú následné zlepšenia modelu. Tvary požiadaviek a odpovedí sú rovnaké, kým podkladové váhy sa líšia. Presný zvolený profil uchovajte s obrázkom a referenciami. Samostatné označenie Preview nemá potichu nahrádzať bežný výber [pro], keď revízia závisí od rovnakej dokumentovanej voľby modelu.

Rozmery, formáty a vybraný vizuál

Návod rodiny dokumentuje výstup do 4 megapixelov s explicitnými rozmermi aspoň 64×64 a násobkami 16. Pre väčšinu použití odporúča najviac 2 megapixely. Šírka a výška určujú zamýšľané rámovanie; štvorcový produktový obrázok, rozloženie na výšku a široká redakčná scéna rozdeľujú priestor odlišne. Presná požiadavka uvádza výstup JPEG, PNG a WebP s predvoleným JPEG a voliteľným seedom.

Profil [max] má samostatnú funkciu vyhľadávania na ukotvenie v zdrojoch, zatiaľ čo [flex] sprístupňuje kroky vzorkovania a guidance a [klein] má menší profil so štyrmi referenciami. Edíciu vyberajte podľa požadovanej práce namiesto prenášania týchto ovládaní do [pro]. Pri vybranom vizuáli uchovajte skutočný obrázok, konečné zadanie, referencie, rozmery a označenie modelu. Podpísané odkazy na výsledky FLUX.2 od výrobcu vypršia po desiatich minútach, preto obrázok načítajte namiesto spoliehania sa na jeho dočasné umiestnenie. Pred vložením výsledku do materiálu pre zákazníkov skontrolujte identitu subjektu, farby, text, kompozíciu 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

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-pro	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.06 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.06 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-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

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

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

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

Black Forest Labs: FLUX.2 Pro