Black Forest Labs: FLUX.2 Max

FLUX.2 [max] yra Black Forest Labs vaizdų modelis reikliems galutiniams failams ir nuoseklioms pataisoms. Dokumentuotas jo profilis derina vaizdinius orientyrus, išsamų scenos valdymą ir internetine informacija grindžiamą aktualių objektų vaizdavimą, su iki 4 megapikselių išvestimi.

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

Apie modelį

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

FLUX.2 [max] yra aukščiausios kokybės Black Forest Labs FLUX.2 vaizdų generavimo ir redagavimo šeimos narys. Gamintojas jį skiria reikliems galutiniams failams, tvirtam sudėtingos užduoties laikymuisi ir nuoseklumui tarp pataisų. Jis kuria vaizdą iš rašytinio aprašymo arba naudoja pateiktus vaizdus kaip vaizdinius orientyrus. Išskirtinė jo šeimos galimybė – informacija grindžianti paieška: užklausa gali remtis aktualia informacija, užuot pasikliovusi vien užklausoje aprašyta scena.

Tikrojo pasaulio informacija ir vaizdinė užduotis

Gamintojas dokumentuoja interneto paiešką tokiems objektams kaip dabartiniai orai, nesenas sporto įvykis arba istorinė aplinka. Įvardykite tikrą vietą, įvykį ir laiką, susijusius su vaizdu, tada atskirai aprašykite meninę stilistiką. Informacija grindžiamos orų kortelės koncepcija galėtų nurodyti miestą, vaizduojamą orų sąlygą, tikslų pavadinimą ir maketą. Paieška informuoja generavimą; patrauklios iliustracijos matomus faktus vis tiek reikia patikrinti pagal atitinkamą šaltinį prieš naudojant ją faktinei komunikacijai.

Paskelbtame FLUX.2 palyginime ši paieškos galimybė priklauso [max]. Kiti įvardyti nariai turi savus vaidmenis: [pro] – gamybai, [flex] – reguliuojamam generavimui ir tipografijai, [klein] – kompaktiškam interaktyviam generavimui. Pasirinkto modelio pavadinimą laikykite su rezultatu, kad vėlesnė pataisa tyliai nepakeistų informacija grindžiamo profilio kita versija.

Orientyrai reiklioms pataisoms

Dokumentuotas užklausos profilis priima iki aštuonių orientyrinių vaizdų; interaktyvi gamintojo sąsaja atskirai leidžia dešimt. Kiekvienam orientyrui priskirkite vaidmenį, pavyzdžiui, personažo išvaizdą, produkto dizainą, aprangą, kambarį arba vaizdinį stilių. Kompozicija gali sujungti kėdę iš vieno vaizdo su kambariu iš kito, išlaikydama kėdės siluetą ir medžiagą. Esamai scenai įvardykite keistiną daiktą bei išsaugotinas detales, įskaitant šviesos kryptį ir aplinkinę geometriją.

Šeimos pavyzdžiai apima fono pakeitimus, daiktų pakeitimą, baldų kompozicijas, teksto pataisas ir nuoseklius personažus. Originali galutinio failo užduotis gali padėti pateiktą laikrodį ant tamsaus sulankstyto audinio, išsaugoti ciferblato bei dirželio dizainą ir pakeisti tik apšvietimą į švelnią šoninę šviesą. Įvardykite, kuris šaltinis pateikia kiekvieną savybę, ir kartu peržiūrėkite gautą ciferblatą, žymėjimą, medžiagą bei atspindžius. Išsaugojimo nurodymas nustato tikslą; grąžintas vaizdas yra su juo lyginamas įrodymas.

Tekstas, spalvos ir užklausos interpretavimas

FLUX.2 vadovas rekomenduoja objekto–veiksmo–stiliaus–konteksto struktūrą, svarbius elementus pateikiant pirmus. Jis siūlo 10–30 žodžių greitoms koncepcijoms, 30–80 įprastiems projektams ir ilgesnius aprašymus sudėtingai scenai. Tai rašymo rekomendacijos, ne griežtos konteksto ribos. Natūrali kalba ir JSON struktūros scenos aprašymai yra dokumentuoti būdai sutvarkyti objektus, jų vietą, šviesą ir stilių. Struktūruota užklausa yra vaizdo užduotis, o ne struktūruoto tekstinio atsakymo pažadas.

Matomiems užrašams pacituokite tekstą, nurodykite jo vietą ir aprašykite tipografinę hierarchiją. Kiekvieną šešioliktainę spalvą susiekite su konkrečiu daiktu ar teksto elementu; spalvos kodas be įvardyto taikinio yra dviprasmiškas. Gamintojo vadovas naudoja teigiamus aprašymus vietoj neigiamos užklausos mechanizmo. Produkto scenai su tuščia vieta antraštei tą tuščią sritį ir jos numatytą vietą aprašykite tiesiogiai.

Konkreti [max] užklausos specifikacija pagal numatytuosius nustatymus taiko užklausos išplėtimą. Valdiklis disable_pup jį išjungia, kai kruopščiai parašytą užduotį reikia naudoti tokią, kokia pateikta. Tai skiriasi nuo teiginio, kad kiekvienas žodis galutiniame vaizde pasirodys nepakeistas. Su rezultatu išsaugokite tikrą užduotį ir pasirinktą nustatymą, vertindami, ar netikėtas vaizdinis sprendimas kilo iš nurodymo, ar jo interpretavimo.

Išvestis ir naudingas galutinis failas

Šeimos vadovas dokumentuoja iki 4 megapikselių vaizdus, aiškius mažiausiai 64×64 matmenis ir 16 kartotinius. Iki 2 megapikselių yra jo rekomendacija įprastam naudojimui. Konkretus [max] profilis nurodo JPEG, PNG ir WebP, numatytasis – JPEG, ir pasirenkamą pradinį atsitiktinumo skaičių. Prieš dėliodami kompoziciją pasirinkite išvesties formą numatytai vietai. Modelio vaizdų generavimas skiriasi nuo jau užbaigto failo dydžio pakeitimo.

Rinkdamiesi galutinę versiją išsaugokite vaizdą, orientyrus, užklausą, matmenis ir modelio tapatybę. Gamintojo FLUX.2 vadovas perspėja, kad pasirašyta rezultato nuoroda laikina ir turi dešimties minučių gavimo langą. Numatytu rodymo dydžiu tikrinkite smulkų tekstą, daikto tapatumą, maketą, šviesą ir iš paieškos gautus faktus. Naudingas rezultatas – pasirinktas vaizdas su pakankamu kontekstu tiksliai pataisai tęsti, o ne scena, kurios svarbios detalės niekada nebuvo palygintos su užduotimi.

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

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-max	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.14 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.14 į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-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

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

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

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

Black Forest Labs: FLUX.2 Max