FLUX 3 Image: vodič za raspored elemenata i ciljane izmene

FLUX 3 Image omogućava da opišete gde pojedinačni elementi treba da se nalaze tako što u upit za sliku uključite pravougaonike. Isti sistem podržava izmene referentne slike: za svaki element možete navesti izvorni položaj, odredište i opis željene promene. Black Forest Labs je dodao krajnju tačku za slike u svoje napomene o izdanju od 1. oktobra 2026..

Za dizajnere i autore sadržaja važno je razlikovati planiranje čitave kompozicije od izmene elementa na postojećoj slici. Ovaj vodič objašnjava kako da izaberete odgovarajući pristup, pretvorite pravougaonik u tražene koordinate i preuzmete rezultat preko API-ja. Vodič se zasniva isključivo na dokumentaciji, provereno 3. oktobra 2026. BIG CHANGE nije generisao niti izmenio sliku ovim proizvodom.

Suštinska promena

• Šta se promenilo: U objavi od 1. oktobra, BFL opisuje kompoziciju i uređivanje pomoću v1/flux-3-image. Opis scene i JSON tabela elemenata nalaze se u istom upitu, a pravougaonici određuju položaje ili izmene. BFL-ove napomene o izdanju
• Zašto je to važno: Autori mogu da pretvore planirani pravougaonik u koordinate, a zatim navedu koje elemente sa referentne slike treba zadržati, pomeriti ili zameniti. U praksi biraju koliko toga će zadati: čitavu kompoziciju, jednostavno uputstvo ili izričitu tabelu za uređivanje. BFL-ov vodič za pravougaonike
• Šta treba pratiti: Odredite rezoluciju i budžet pre slanja zahteva: navedene cene za 1k i 4k iznose 0,048 i 0,607 dolara po slici. Pregledajte ceo rezultat jer elementi mogu da izađu izvan zadatih pravougaonika, a izmena može da utiče na okolno osvetljenje, senke ili odraze. BFL-ov cenovnik, ograničenja uređivanja

Izaberite rad u pregledaču ili preko API-ja

BFL-ova stranica proizvoda opisuje dva načina rada: crtanje pravougaonika u pregledaču, u okruženju Playground, ili slanje upita za raspored preko API-ja. U dokumentaciji se nalazi veza ka Playground-u za rad bez koda. Koristite pregledač ako želite neposredno da crtate oblasti, a API ako u zahtevu treba da zadate koordinate i programski preuzmete rezultat. Nismo pregledali aktuelne kontrole u Playground-u, pa uputstva u nastavku objašnjavaju format zahteva iz dokumentacije, a ne niz klikova u pregledaču.

Za rad preko API-ja otvorite BFL nalog, dodajte sredstva i preuzmite ključ sa kontrolne table. Pošaljite JSON zahtev metodom POST ka adresi https://api.bfl.ai/v1/flux-3-image, koristeći Content-Type: application/json i ključ u zaglavlju x-key. Obavezno je samo polje prompt. BFL-ov vodič za generisanje, cene i podešavanje

Važno je razlikovati FLUX 3 Image od FLUX 3 Dev: ova uputstva odnose se na hostovanu krajnju tačku Image kompanije BFL. Na stranici proizvoda Image nudi se komercijalna licenca za težinske parametre preko prodajnog tima. U izvorima pregledanim za ovaj vodič ne potvrđuje se mogućnost preuzimanja težinskih parametara za FLUX 3 Image. Pristup FLUX 3 Image-u

Odlučite koliko elemenata slike treba zadati

BFL navodi da se pri proširivanju upita oblast jednostavne izmene može automatski zadati pravougaonikom. Za izričitu kontrolu unesite sopstvenu tabelu. U običnom uputstvu „slika 1“ označava prvu referentnu sliku; u redovima za uređivanje ista referenca je ref_image_0. BFL-ov vodič za uređivanje

Reference se u polje images unose kao URL adrese ili podaci u Base64 formatu, pojedinačno ili kao lista. Ako se navedu, dozvoljeno ih je od 1 do 10, a svaka mora imati između 256 × 256 piksela i 16 megapiksela. Podrazumevani format slike aspect_ratio je auto: prati oblik prve reference, ili je kvadratni ako nijedna referenca nije prosleđena. Izričito ga zadajte kada je za raspored potreban određeni oblik. Pregled krajnje tačke BFL-a

Pretvorite pravougaonik u okvir

Svaki okvir je [top, left, bottom, right], a koordinate su celi brojevi od 0 do 1000. Najpre se navode uspravne, pa vodoravne koordinate. Svaka osa nezavisno obuhvata celu sliku, pa se mreža prilagođava pejzažnom ili portretnom platnu. BFL-ov format okvira

Da biste položaje u pikselima pretvorili u koordinate, gornju i donju ivicu podelite visinom slike, a levu i desnu širširinom. Svaki rezultat pomnožite sa 1000 i zaokružite. U dokumentovanom primeru BFL-a koristi se platno veličine 1920 × 1080:

Okvir je, dakle, [100, 200, 900, 800]. Uspravni opseg je od 10% do 90% visine kadra, a vodoravni od 20% do 80%. Iz ovog računa se vidi zašto zamena širine i visine ili navođenje leve ivice pre gornje menja željenu oblast. Zadržite odnos širine i visine prema kojem je raspored osmišljen. BFL-ovo pretvaranje koordinata

Napravite novu sliku

Opišite celu kompoziciju i imenujte elemente pomoću oznaka <id>. Zatim dodajte JSON niz sa poljem id, bbox i desc za svaki element. Niz je tekst unutar polja prompt, a ne još jedno polje na najvišem nivou API zahteva.

Dokumentovani primer BFL-a sa siluetom osobe koja trči ima pozadinu koja prekriva celo platno i figuru smeštenu u centralni okvir. Ovaj skraćeni zahtev prati raspored iz primera; BIG CHANGE ga nije pokrenuo:

{
  "prompt": "A black running silhouette <silhouette_1> on a chartreuse background <background_1>. [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"Chartreuse background with paper texture\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"Black running silhouette with stippled texture\"}]",
  "aspect_ratio": "1:1",
  "resolution": "1k"
}

Ako kompozicija sadrži tekst, unesite svaki red kao zasebnu stavku i tačne tražene reči navedite u polju desc. Okviri usmeravaju položaj i veličinu elementa, ali BFL upozorava da element može da izađe izvan okvira. Oni nisu čvrste maske za odsecanje. BFL-ov vodič za kompoziciju i ograničenja

Izmenite postojeću sliku

Izvor prosledite u polju images. U redovima za uređivanje zadržavaju se polja id i desc, a polje bbox zamenjuje se sledećim poljima:

Uputstvo i niz za uređivanje objedinite u polju prompt, kao kod kompozicije. Opis promene dodajte na oba mesta. Unesite redove za elemente koji treba da ostanu na mestu. Prema BFL-ovom vodiču, pikseli izvan okvira uglavnom ostaju isti, ali okolno osvetljenje, odrazi i senke mogu da se promene. Pre prihvatanja izmene uporedite ceo rezultat sa izvornom slikom. BFL takođe navodi da se u njihovim testovima novi elementi često nisu pojavili kada su okviri bili približno 40 × 25 piksela; to je zapažanje dobavljača, a ne univerzalna minimalna veličina niti rezultat testa kompanije BIG CHANGE. BFL-ova uputstva za uređivanje, šema reda za uređivanje

Izaberite rezoluciju i odredite budžet

Pregled navodi rezolucije 768sq, 1k, 1.5k, 2k i 4k, pri čemu je 1k podrazumevana. Na stranici sa cenama navedeni su sledeći iznosi; cena opcije 1.5k nije navedena. Proverite trošak te opcije pre nego što je upotrebite. BFL-ov pregled

Ovo su cene u američkim dolarima koje navodi BFL, proverene 3. oktobra. Kolona za deset zahteva predstavlja računicu, a ne izmerenu potrošnju. BFL navodi istu cenu za API i Playground, pri čemu jedan kredit vredi 0,01 $. U odgovoru na zahtev nalazi se polje cost. Zahtev sa 4k ima oko 12,6 puta veći navedeni trošak od zahteva sa 1k; izaberite veličinu izlaza koja je potrebna za zadatak i predvidite troškove dodatnih pokušaja. Promena rezolucije zahteva novo slanje, a ovaj vodič ne potvrđuje da će dva zahteva proizvesti istu kompoziciju. BFL-ov cenovnik

Opcionalno podešavanje grounding podrazumevano je true, što omogućava pretragu veba i slika pre generisanja. BFL navodi da se isključivanjem dobijaju brži rezultati zasnovani samo na upitu. Nismo izmerili tu razliku u brzini niti proverili tačnost rezultata zasnovanih na spoljnim izvorima. BFL-ova dokumentacija o utemeljenju

Pošaljite zahtev, proverite status i sačuvajte rezultat

Nakon slanja sačuvajte vraćeni identifikator zadatka polling_url i proveravajte baš tu URL adresu pomoću svog API ključa. Ona vodi do regiona u kojem se zadatak izvršava. Pending, Reasoning i Generating znače da je zadatak još u toku. Kada se prikaže status Ready, preuzmite polje result.sample; njegova potpisana veza ističe posle jednog sata. Nemojte slati zaglavlje x-key API ključa na URL adresu za preuzimanje. Rezultat sadrži i result.prompt, u kojem se vidi prošireno uputstvo, kao i polje result.duration, koje prikazuje vreme generisanja. BFL-ova uputstva za preuzimanje rezultata

Blokiran ili neuspešan zadatak zahteva drugačiji odgovor od zadatka koji je još u toku. Request Moderated znači da je ulazni zahtev blokiran; Content Moderated znači da je blokiran izlaz. Izmenite ulaz pre novog pokušaja. Kod statusa Error, pregledajte odgovor; za nepoznat zadatak ili zadatak kome je istekao rok vraća se status Task not found. BFL upozorava da neuspešan zadatak može vratiti HTTP 503 sa uobičajenim JSON sadržajem, zato pre ponovnog pokušaja pročitajte polje status. Prevelike referentne slike vraćaju grešku 400; nepoznato polje, nevažeća vrednost, prazan upit ili premala slika mogu da vrate grešku 422. Polja kao što su seed, width i input_image sa drugih krajnjih tačaka ovde nisu prihvaćena. BFL-ov vodič za generisanje i greške

Pokušaj je završen kada sačuvate rezultat i pregledate položaj elemenata, traženi tekst i okolinu izmenjenog dela slike. Odgovor sa statusom Ready potvrđuje da je rezultat dostupan; vizuelnim pregledom utvrđujete da li ispunjava zadatak.

Izvori i dodatna literatura

• Stranica proizvoda FLUX 3 Image: potvrđuje načine rada preko pregledača i API-ja, kao i pristup komercijalnoj licenci za težinske parametre. Primeri su materijal dobavljača, a ne rezultati naših testova.
• Napomene o izdanju od 1. oktobra: navodi datum objavljivanja verzije za slike i opisuje zajedničku krajnju tačku. Široke tvrdnje o kontroli tumačimo u svetlu užih ograničenja u vodičima.
• Pregled krajnje tačke: navodi parametre, ograničenja za reference, izbor rezolucije i ponašanje utemeljenja.
• Vodič za granične okvire: objašnjava dve šeme redova i prilagođeni primer sa siluetom osobe koja trči.
• Vodič za uređivanje: objašnjava pretvaranje koordinata, redosled referenci i ograničenja za male oblasti i okolne piksele.
• Vodič za generisanje: opisuje autentifikaciju, asinhrono preuzimanje rezultata, veze sa rokom trajanja i greške.
• Cenovnik: sadrži cene korišćene u našim proračunima. Pre plaćanja novog pokušaja proverite aktuelne cene i parametre zahteva, jer je reč o promenljivoj dokumentaciji.