Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] je produkcijski slikovni model Black Forest Labs za ustvarjanje na podlagi besedila in urejanje z referencami. Njegov dokumentirani profil združuje fotorealistične podrobnosti, nadzor besedila in barv ter skupno omejitev pikslov referenc in izhoda, s slikami do 4 megapikslov.

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

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 [pro] je model Black Forest Labs za ustvarjanje in urejanje slik s poudarkom na produkciji. Proizvajalec ga predstavlja kot privzeto izbiro za večino vizualnih nalog FLUX.2: ustvarjanje nove slike iz besedila ali spreminjanje prizora z vizualnimi referencami. Zmožnosti njegove družine vključujejo fotorealistične materiale in osvetlitev, berljivo besedilo, navodila za natančne barve in dosledne motive med povezanimi ureditvami. Vrnjeno gradivo je slika za uporabo v prizoru z izdelkom, uredniški kompoziciji, oblikovni zasnovi ali vizualnem sporočanju.

Pripravite produkcijski opis

Začnite z motivom, njegovim dejanjem ali razporeditvijo, slogom ter okoljem ali svetlobo. Proizvajalčev vodič za pozive zgodnjim besedam namenja več pozornosti in priporoča, da bistveni motiv in dejanje postavite pred okrasne podrobnosti. Predlaga 10–30 besed za hitre zasnove in 30–80 za običajne projekte, za kompleksne prizore pa daljše opise. Ti razponi so napotki za pisanje pozivov, ne omejitev besedilnega konteksta.

Izviren kataloški opis lahko pokaže svetilko iz brušenega jekla na toplo sivi mizni površini, s tričetrtinskim pogledom, ki razkrije stikalo in senčnik. Določite površino, osvetlitev in zorni kot, zaradi katerih je izdelek prepoznaven. Pri infografiki ali marketinški sliki najprej določite vidno besedilo in hierarhijo; točen naslov navedite v narekovajih, določite njegovo mesto ter poimenujte slog in velikost črk. Etikete, količine in podrobnosti izdelka preverite pri končni velikosti prikaza.

Vodič družine dokumentira tako pozive v naravnem jeziku kot strukturirane pozive JSON. Strukturiran opis prizora lahko motiv, ozadje, svetlobo in kompozicijo hrani v ločenih poljih, da je mogoče eno zahtevo jasno spremeniti. Podpira tudi opise šestnajstiških barv: kodo povežite z določenim predmetom ali besedilom, ki naj se obarva. Želeni videz opišite pozitivno, saj dokumentirani postopek pozivov FLUX.2 ne ponuja negativnih pozivov.

Urejajte z referencami in skupno omejitvijo pikslov

Natančni profil zahteve [pro] ponuja osem mest za referenčne slike; proizvajalčev interaktivni vmesnik ločeno podpira deset. Vsaki sliki dodelite vlogo, denimo videz motiva, oblačila, zasnovo izdelka, sobo ali slog. Pri obstoječem prizoru navedite element za spremembo ter kompozicijo, okolico in vizualne podrobnosti, ki naj ostanejo. Objavljeni primeri vključujejo sestavljanje pohištva v prizor, spremembe ozadja ali vremena, zamenjavo predmetov in spremembe besedila.

Zmogljivost referenc je odvisna tudi od velikosti izhoda. Proizvajalčev vodič [pro] določa skupno omejitev 9 megapikslov za vhod in izhod. Njegovi primeri dovoljujejo osem referenc pri izhodu 1 megapiksel in sedem pri izhodu 2 megapiksla ter z večanjem zahtevanega rezultata zmanjšujejo zmogljivost referenc. Izvorni nabor in izhod načrtujte skupaj, namesto da bi največje število mest obravnavali kot razpoložljivo pri vsaki velikosti izhoda. Uporabite reference, ki določajo potrebne podatke, in označite njihov predvideni prispevek.

Pri sestavljeni sliki izdelka lahko prva slika prispeva izdelek, druga sobo, tretja pa določi površinsko obdelavo materiala. Pojasnite, kako naj postanejo en skladen prizor. Če rezultat spremeni obliko, oznako ali identiteto, ki naj ostane, v nadaljnji zahtevi ciljajte to težavo, namesto da zamenjate celoten opis. Praktičen rezultat je spremenjena slika, pri kateri sta zvestoba referencam in določena sprememba primerjani z vhodi.

Razširitev poziva ter stalni in predogledni profili

Natančna specifikacija [pro] privzeto omogoča razširitev poziva. Nadzor disable_pup to razširitev ustavi, kadar naj se skrbno napisano navodilo uporabi, kot je priloženo. Pri primerjanju različic ohranite izbrano nastavitev, saj sta ista kratka zasnova in razširjen opis različna generativna vhoda. To je možnost proizvajalčevega profila, ne jamstvo, da se vsaka zahtevana podrobnost pojavi pravilno.

Dokumentacija razlikuje navadno končno točko [pro] kot stalen posnetek od [pro] Preview, v katero se uvajajo poznejše izboljšave modela. Oblike njunih zahtev in odgovorov so enake, osnovne uteži pa se razlikujejo. Natančno izbrani profil hranite s sliko in referencami. Ločena oznaka Preview ne sme tiho nadomestiti izbire navadnega [pro], kadar je sprememba odvisna od iste dokumentirane izbire modela.

Mere, formati in izbrano gradivo

Vodič družine dokumentira izhod do 4 megapikslov, z izrecnimi merami vsaj 64×64 in večkratniki 16. Za večino primerov uporabe priporoča do 2 megapiksla. Širina in višina določata predvideno kadriranje; kvadratna slika izdelka, pokončna postavitev in širok uredniški prizor prostor razporejajo različno. Natančna zahteva navaja izhod JPEG, PNG in WebP, privzeto JPEG, ter neobvezno seme.

Profil [max] ima ločeno možnost iskanja za navezavo na dejanske podatke, [flex] omogoča korake vzorčenja in vodenje, [klein] pa manjši profil s štirimi referencami. Različico izberite glede na zahtevano delo, namesto da te možnosti uvozite v [pro]. Pri izbranem gradivu shranite dejansko sliko, končni poziv, reference, mere in oznako modela. Proizvajalčeve podpisane povezave rezultatov FLUX.2 potečejo po desetih minutah, zato sliko pridobite, namesto da bi se zanašali na začasno lokacijo. Pred umestitvijo rezultata v gradivo za stranke preverite identiteto motiva, barve, besedilo, kompozicijo in urejene podrobnosti.

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

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

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

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

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

Black Forest Labs: FLUX.2 Pro