Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] yra Black Forest Labs gamybinis vaizdų modelis kūrimui iš teksto ir orientyrais valdomam redagavimui. Dokumentuotas jo profilis derina fotorealistines detales, teksto bei spalvų valdymą su orientyrų ir išvesties pikselių limitu bei iki 4 megapikselių vaizdais.

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

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

FLUX.2 [pro] yra Black Forest Labs į gamybą orientuotas vaizdų generavimo ir redagavimo modelis. Gamintojas jį pateikia kaip numatytąjį pasirinkimą daugumai FLUX.2 vaizdinių užduočių: naujam vaizdui kurti iš teksto arba scenai keisti pagal vaizdinius orientyrus. Šeimos galimybės apima fotorealistines medžiagas ir apšvietimą, įskaitomą tekstą, tikslių spalvų nurodymus bei nuoseklius objektus susijusiose pataisose. Grąžintas rezultatas – vaizdas produkto scenai, redakcinei kompozicijai, dizaino koncepcijai arba vaizdinei komunikacijai.

Paruoškite gamybos užduotį

Pradėkite nuo objekto, jo veiksmo arba išdėstymo, stiliaus ir aplinkos ar šviesos. Gamintojo užklausų vadovas daugiau dėmesio skiria pradžios žodžiams ir rekomenduoja esminį objektą bei veiksmą dėti prieš dekoratyvines detales. Jis siūlo 10–30 žodžių greitoms koncepcijoms ir 30–80 įprastiems projektams, o sudėtingoms scenoms – ilgesnius aprašymus. Šie intervalai yra užklausų rašymo gairės, ne teksto konteksto riba.

Originali katalogo užduotis gali rodyti šlifuoto plieno šviestuvą ant šiltai pilko stalviršio, trijų ketvirčių rakursu, atskleidžiančiu jungiklį ir gaubtą. Nurodykite paviršių, apšvietimą ir žiūros tašką, leidžiančius produktą atpažinti. Infografikai arba rinkodaros vaizdui pirmiausia nustatykite matomą tekstą ir hierarchiją; pacituokite tikslų pavadinimą, nurodykite jo vietą ir raidžių stilių bei dydį. Etiketes, kiekius ir produkto detales tikrinkite galutiniu rodymo dydžiu.

Šeimos vadovas dokumentuoja natūralios kalbos ir JSON struktūros užklausas. Struktūruota scenos užduotis gali atskiruose laukuose išlaikyti objektą, foną, šviesą bei kompoziciją, kad vieną reikalavimą būtų galima aiškiai pataisyti. Ji taip pat palaiko šešioliktainių spalvų aprašymus: kodą susiekite su konkrečiu spalvinamu daiktu ar tekstu. Norimą išvaizdą aprašykite teigiamai, nes dokumentuota FLUX.2 užklausų eiga nesuteikia neigiamų užklausų.

Redaguokite su orientyrais ir bendru pikselių limitu

Konkretus [pro] užklausos profilis siūlo aštuonias orientyrinių vaizdų pozicijas; interaktyvi gamintojo sąsaja atskirai palaiko dešimt. Kiekvienam vaizdui priskirkite vaidmenį, pavyzdžiui, objekto išvaizdą, aprangą, produkto dizainą, kambarį arba stilių. Esamai scenai nurodykite keistiną elementą ir tai, kokia kompozicija, aplinka bei vaizdinės detalės turi išlikti. Paskelbti pavyzdžiai apima baldų kompozicijas, fono ar oro pokyčius, daiktų pakeitimus ir teksto pataisas.

Orientyrų talpa taip pat priklauso nuo išvesties dydžio. Gamintojo [pro] vadovas įvesčiai ir išvesčiai nustato bendrą 9 megapikselių limitą. Jo pavyzdžiai leidžia aštuonis orientyrus su 1 megapikselio išvestimi ir septynis su 2 megapikselių išvestimi, mažinant orientyrų talpą augant prašomam rezultatui. Pradinius failus ir išvestį planuokite kartu, užuot laikę didžiausią vietų skaičių prieinamu kiekvienam išvesties dydžiui. Naudokite būtinos informacijos suteikiančius orientyrus ir įvardykite numatytą jų indėlį.

Produkto kompozicijoje pirmas vaizdas galėtų pateikti produktą, antras – kambarį, o trečias nustatyti medžiagos apdailą. Paaiškinkite, kaip jie turi tapti viena vientisa scena. Jei rezultatas pakeičia išsaugotiną formą, žymėjimą ar tapatumą, tolesnę užduotį nukreipkite į šią problemą, užuot pakeitę visą užduotį. Praktiškas rezultatas – pataisytas vaizdas, kurio atitiktis orientyrams ir konkretus pakeitimas palyginti su įvestimis.

Užklausos išplėtimas ir fiksuoti bei peržiūros profiliai

Konkreti [pro] specifikacija pagal numatytuosius nustatymus įjungia užklausos išplėtimą. Valdiklis disable_pup jį sustabdo, kai kruopščiai parašytą nurodymą reikia naudoti tokį, koks pateiktas. Lygindami versijas išlaikykite pasirinktą nustatymą, nes ta pati trumpa koncepcija ir išplėstas aprašymas yra skirtingos generavimo įvestys. Tai gamintojo profilio valdiklis, o ne garantija, kad kiekviena prašyta detalė pasirodys teisingai.

Dokumentacija skiria įprastą [pro] galinį tašką kaip fiksuotą momentinę versiją nuo [pro] Preview, į kurį įtraukiami vėlesni modelio patobulinimai. Jų užklausos ir atsakymo formos vienodos, bet baziniai svoriai skiriasi. Tikslų pasirinktą profilį laikykite su vaizdu ir orientyrais. Atskira Preview žyma neturi tyliai pakeisti įprasto [pro] pasirinkimo, kai pataisa priklauso nuo to paties dokumentuoto modelio.

Matmenys, formatai ir pasirinktas failas

Šeimos vadovas dokumentuoja iki 4 megapikselių išvestį, aiškius mažiausiai 64×64 matmenis ir 16 kartotinius. Daugumai naudojimo atvejų rekomenduoja iki 2 megapikselių. Plotis bei aukštis nustato numatytą kadravimą; kvadratinis produkto vaizdas, vertikalus maketas ir plati redakcinė scena erdvę paskirsto skirtingai. Konkrečioje užklausoje nurodyti JPEG, PNG ir WebP formatai, numatytasis – JPEG, ir pasirenkamas pradinis atsitiktinumo skaičius.

[max] profilis turi atskirą informacija grindžiančios paieškos funkciją, [flex] leidžia valdyti generavimo žingsnius ir nurodymų laikymosi stiprumą, o [klein] turi mažesnį keturių orientyrų profilį. Versiją rinkitės pagal reikiamą darbą, užuot perkėlę šiuos valdiklius į [pro]. Pasirinktam rezultatui išsaugokite patį vaizdą, galutinę užklausą, orientyrus, matmenis ir modelio žymą. Gamintojo FLUX.2 pasirašytos rezultatų nuorodos baigia galioti po dešimties minučių, todėl gaukite vaizdą, užuot pasikliovę laikina jo vieta. Prieš dėdami rezultatą į klientams skirtą medžiagą, patikrinkite objekto tapatumą, spalvas, tekstą, kompoziciją ir redaguotas detales.

Ailoot Ultra · Vaizdai 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

Pradžia

Leidžiamos įvestys: Tekstas · Vaizdai
Rezultatai: Vaizdai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdai POST /v1/images/generations

Įvestis: text, image
Išvestis: image

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos black-forest-labs/flux.2-pro	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`aspect_ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Numatyta—
Laukas`output_format`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos png, jpeg	Numatyta—
Laukas`n`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 1	Numatyta—
Laukas`input_references`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 8	Numatyta—
Laukas`provider`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, prompt
Parametras`material_types`	Specifikacijatext, image

Gyvavimo ciklas: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Apskaitos vienetas	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Apskaitos vienetas—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
Konfigūracijaišvesties vaizdo megapikselis	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetasuž išvesties vaizdo megapikselį	Mokestis Išvestis · išvesties vaizdo megapikselis · Įvertis tik palyginimui $0.06 už išvesties vaizdo megapikselį
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Apskaitos vienetas—	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.06 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdai

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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdai

Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį

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

Kito turinio skaitymas

Skaityti esamą jums priklausančią medžiagą

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.

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.

Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.

Atsakymo laukai

Laukas	Tipas
Laukas`created`	Tipas
Laukas`data[].url`	Tipas
Laukas`data[].b64_json`	Tipas
Laukas`usage`	Tipas

Pseudonimai

Modelių pseudonimai

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

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

Kokios įvestys ir rezultatai prieinami?: POST /v1/images/generations · black-forest-labs/flux.2-pro: text, image → image
Kokius laukus naudoja užklausa?: POST /v1/images/generations · black-forest-labs/flux.2-pro: model, prompt, aspect_ratio, output_format, n, input_references, provider
Kokie apribojimai taikomi?: POST /v1/images/generations · black-forest-labs/flux.2-pro: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Pro