Black Forest Labs: FLUX.2 Max

FLUX.2 [max] je slikovni model Black Forest Labs za zahtevna končna gradiva in dosledne ureditve. Njegov dokumentirani profil združuje vizualne reference, podroben nadzor prizora in spletno navezavo na aktualne motive, z izhodom do 4 megapikslov.

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

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

FLUX.2 [max] je najkakovostnejši član družine Black Forest Labs za ustvarjanje in urejanje slik FLUX.2. Proizvajalec ga namenja zahtevnim končnim gradivom, močnemu upoštevanju kompleksnega opisa in doslednosti med ureditvami. Sliko ustvari iz pisnega opisa ali priložene slike uporabi kot vizualne reference. Njegova razlikovalna zmožnost v družini je iskanje za navezavo na dejanske podatke: zahteva lahko črpa iz aktualnih informacij, namesto da bi se zanašala samo na prizor, opisan v pozivu.

Podatki iz resničnega sveta in vizualni opis

Proizvajalec dokumentira spletno iskanje za motive, kot so trenutno vreme, nedavni športni dogodek ali zgodovinsko okolje. Označite dejansko lokacijo, dogodek in čas, pomembne za sliko, nato umetniško obdelavo opišite ločeno. Zasnova vremenske kartice, navezana na podatke, lahko določi mesto, vremensko stanje za prikaz, točen naslov in postavitev. Iskanje usmerja ustvarjanje; privlačna ilustracija še vedno potrebuje preverjanje vidnih dejstev glede na ustrezni vir, preden postane stvarno sporočilo.

Ta zmožnost iskanja v objavljeni primerjavi FLUX.2 pripada [max]. Drugi poimenovani člani imajo svoje vloge: [pro] za produkcijo, [flex] za prilagodljivo vzorčenje in tipografijo ter [klein] za kompaktno interaktivno ustvarjanje. Ime izbranega modela hranite z rezultatom, da poznejša sprememba ne zamenja profila z navezavo na podatke z drugo različico brez opozorila.

Reference za zahtevne ureditve

Dokumentirani profil zahteve sprejme do osem referenčnih slik; proizvajalčev interaktivni vmesnik ločeno dovoljuje deset. Vsaki referenci dodelite vlogo, denimo videz lika, zasnovo izdelka, oblačila, sobo ali vizualni slog. Kompozicija lahko stol iz ene slike združi s sobo iz druge in ohrani silhueto ter material stola. Pri obstoječem prizoru označite predmet za spremembo in podrobnosti za ohranitev, vključno s smerjo svetlobe in okoliško geometrijo.

Primeri družine vključujejo spremembe ozadja, zamenjave predmetov, kompozicije pohištva, urejanje besedila in dosledne like. Izviren opis končnega gradiva lahko priloženo uro postavi na temno zloženo tkanino, ohrani zasnovo številčnice in pasu ter spremeni samo osvetlitev v mehko stransko svetlobo. Poimenujte vir vsake značilnosti ter nastalo številčnico, oznake, material in odseve preglejte skupaj. Navodilo za ohranitev določi cilj; vrnjena slika je dokaz za primerjavo z njim.

Besedilo, barve in razlaga poziva

Vodič FLUX.2 priporoča strukturo motiv–dejanje–slog–kontekst s pomembnimi elementi na začetku. Predlaga 10–30 besed za hitre zasnove, 30–80 za običajne projekte in daljše opise za kompleksen prizor. To so priporočila za pisanje, ne trde omejitve konteksta. Naravni jezik in strukturirani opisi prizora JSON so dokumentirana načina organizacije motivov, postavitve, svetlobe in sloga. Strukturiran poziv je slikovni opis, ne obljuba strukturiranega besedilnega odgovora.

Pri vidnih napisih besedilo navedite v narekovajih, določite položaj in opišite tipografsko hierarhijo. Vsako šestnajstiško barvo povežite z določenim predmetom ali besedilnim elementom; barvna koda brez poimenovanega cilja je dvoumna. Proizvajalčev vodič uporablja pozitivne opise namesto mehanizma negativnih pozivov. Pri prizoru izdelka s praznim prostorom za naslov neposredno opišite to prazno območje in njegov predvideni položaj.

Natančna specifikacija zahteve [max] privzeto uporablja razširitev poziva. Nadzor disable_pup jo izklopi, kadar naj se skrbno napisan opis uporabi, kot je priložen. To se razlikuje od trditve, da bo vsaka beseda v končni sliki ostala nespremenjena. Pri ocenjevanju, ali je nepričakovana vizualna odločitev prišla iz navodila ali njegove razlage, z rezultatom ohranite dejanski opis in izbrano nastavitev.

Izhod in uporabno končno gradivo

Vodič družine dokumentira slike do 4 megapikslov z izrecnimi merami vsaj 64×64 in večkratniki 16. Priporočilo za običajno uporabo je do 2 megapiksla. Natančni profil [max] navaja JPEG, PNG in WebP, privzeto JPEG, ter neobvezno naključno seme. Pred razporeditvijo kompozicije izberite obliko izhoda za predvideno umestitev. Ustvarjanje slike z modelom je ločeno od spreminjanja velikosti že dokončanega gradiva.

Pri izbiri končne različice hranite sliko, reference, poziv, mere in identiteto modela. Proizvajalčev vodič FLUX.2 opozarja, da je podpisana povezava rezultata začasna, z desetminutnim oknom pridobivanja. Pri predvideni velikosti prikaza preverite drobno besedilo, identiteto predmetov, postavitev, svetlobo in dejstva, pridobljena z iskanjem. Uporabno gradivo je izbrana vizualna podoba z dovolj konteksta za nadaljevanje natančne spremembe, ne prizor, katerega pomembne podrobnosti nikoli niso bile primerjane z opisom.

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

Začetek

Dovoljeni vhodi: Besedilo · Slike
Rezultati: Slike

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Slike POST /v1/images/generations

Vhod: text, image
Izhod: image

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve black-forest-labs/flux.2-max	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Najmanjša dolžina: 1	Privzeto—
Polje`aspect_ratio`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Privzeto—
Polje`output_format`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve png, jpeg	Privzeto—
Polje`n`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 1	Privzeto—
Polje`input_references`	Vrsta`array`	ZahtevaIzbirno	Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 8	Privzeto—
Polje`provider`	Vrsta`object`	ZahtevaIzbirno	Vrednosti in omejitve	Privzeto—

Parametri in življenjski cikel metode

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

Življenjski cikel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Obračunska enota	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Obračunska enota—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
Nastavitevmegapiksel izhodne slike	Cenovna lestvica—	Predvidena količina—	Obračunska enotana megapiksel izhodne slike	Strošek Izhod · megapiksel izhodne slike · Ocena samo za primerjavo $0.14 na megapiksel izhodne slike
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Obračunska enota—	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.14 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Slike

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

Prejmi in shrani rezultate

Ailoot Ultra · Slike

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

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

Branje druge vsebine

Preberi obstoječa gradiva, ki vam pripadajo

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.

Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.

Če je treba preveriti izvirni odgovor

Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.

Polja odgovora

Polje	Vrsta
Polje`created`	Vrsta
Polje`data[].url`	Vrsta
Polje`data[].b64_json`	Vrsta
Polje`usage`	Vrsta

Druga imena

Druga imena modelov

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

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

Kateri vhodi in rezultati so na voljo?: POST /v1/images/generations · black-forest-labs/flux.2-max: text, image → image
Katera polja uporablja zahteva?: POST /v1/images/generations · black-forest-labs/flux.2-max: model, prompt, aspect_ratio, output_format, n, input_references, provider
Katere omejitve veljajo?: POST /v1/images/generations · black-forest-labs/flux.2-max: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Max