FLUX 3 Image: gabay sa mga kahon ng layout at piling pag-edit

Sa FLUX 3 Image, mailalarawan mo kung saan dapat mapunta ang bawat elemento gamit ang mga parihabang bahagi ng prompt para sa larawan. Sinusuportahan din ng sistemang ito ang pag-edit ng reference image: maaaring tukuyin para sa bawat elemento ang posisyon nito sa pinagmulan, ang patutunguhan, at ang pagbabagong gagawin. Idinagdag ng Black Forest Labs ang image endpoint sa mga release note noong Oktubre 1, 2026.

Para sa mga designer at creator, mahalagang pag-ibahin ang pagpaplano sa buong komposisyon at ang pagbabago sa isang elemento ng umiiral nang larawan. Ipinapaliwanag ng gabay na ito kung paano pumili sa dalawa, gawing mga kinakailangang coordinate ang isang parihaba, at kunin ang resulta mula sa API. Gabay lamang ito batay sa dokumentasyon, sinuri noong Oktubre 3, 2026. Hindi gumawa o nag-edit ng larawan ang BIG CHANGE gamit ang produktong ito.

Ang pangunahing pagbabago

• Ano ang nagbago: Itinatala ng release ng BFL noong Oktubre 1 ang pagbuo ng komposisyon at pag-edit sa pamamagitan ng v1/flux-3-image. Pinagsasama ng iisang prompt ang paglalarawan ng eksena at talahanayan ng mga elemento sa JSON; tinutukoy ng mga kahon ang mga posisyon o pag-edit. Mga release note ng BFL
• Bakit ito mahalaga: Maaaring gawing mga coordinate ng creator ang planadong parihaba, saka tukuyin kung aling reference element ang pananatilihin, ililipat, o papalitan. Ang praktikal na tanong ay kung gaano karami ang dapat tukuyin: ang buong komposisyon, isang simpleng tagubilin, o tahasang talahanayan ng pag-edit. Gabay ng BFL sa mga kahon
• Ano ang dapat bantayan: Pumili muna ng resolution at badyet bago magsumite: ang nakalistang presyo para sa 1k at 4k ay $0.048 at $0.607 bawat larawan. Suriin ang buong resulta dahil maaaring lumampas sa hangganan ng mga kahon ang elemento, at maaaring maapektuhan ng pag-edit ang kalapit na liwanag, anino, o repleksiyon. Pagpepresyo ng BFL, mga limitasyon sa pag-edit

Piliin ang ruta sa browser o API

Inilalarawan ng pahina ng produkto ng BFL ang dalawang paraan: gumuhit ng mga kahon sa Playground gamit ang browser o magpadala ng layout prompt sa API. Inililink ng dokumentasyon ang Playground para magamit ito nang walang code. Gamitin ang browser kung nais mong iguhit mismo ang mga rehiyon; piliin ang API kung kailangan mong magpadala ng mga coordinate sa request at kunin ang output nang programatiko. Hindi namin sinuri ang kasalukuyang mga kontrol ng Playground, kaya inilalarawan sa mga tagubilin sa ibaba ang dokumentadong format ng request, hindi ang sunod-sunod na pagpindot sa mga button.

Para gamitin ang API, gumawa ng BFL account, magdagdag ng credit, at kumuha ng key sa dashboard. Magpadala ng JSON gamit ang POST request papunta sa https://api.bfl.ai/v1/flux-3-image, gamit ang Content-Type: application/json at ang key sa x-key header. Ang prompt lang ang kailangang field. Gabay sa pagbuo ng larawan ng BFL, pagpepresyo at setup

Dapat pag-ibahin ang FLUX 3 Image at FLUX 3 Dev: para sa naka-host na Image endpoint ng BFL ang mga tagubiling ito. Nag-aalok ang pahina ng produkto ng Image ng lisensiyang pangkomersiyo para sa weights sa pamamagitan ng sales team. Hindi pinatutunayan ng mga sangguniang sinuri para sa gabay na ito na may mada-download na open weights para sa FLUX 3 Image. Access sa FLUX 3 Image

Tukuyin kung gaano karaming detalye ang ilalagay sa larawan

Ayon sa BFL, maaaring awtomatikong lagyan ng kahon ang simpleng pag-edit habang pinapalawak ang prompt. Para sa tahasang kontrol, sarili mong talahanayan ang ibigay. Sa karaniwang tagubilin, ang “larawan 1” ang unang reference; sa mga row ng pag-edit, ang kaparehong reference ay ref_image_0. Gabay sa pag-edit ng BFL

Ilagay ang mga reference sa images bilang mga URL o Base64 data, bilang string o listahan. Kapag may mga ito, maaaring maglagay ng 1 hanggang 10 larawan, bawat isa ay mula 256 × 256 pixel hanggang 16 megapixel. Ang default na aspect_ratio ay auto: sinusunod nito ang unang reference, o gumagawa ng parisukat na larawan kapag walang ibinigay na reference. Itakda ito nang tahasan kapag kailangan ng layout mo ng partikular na hugis. Pangkalahatang-ideya ng endpoint ng BFL

Gawing kahon ang parihaba

Ang bawat kahon ay [top, left, bottom, right], na may mga whole-number coordinate mula 0 hanggang 1000. Nauuna ang mga coordinate na patayo. Saklaw ng bawat axis nang magkahiwalay ang buong larawan, kaya umaangkop ang grid sa pahalang o patayong canvas. Format ng kahon ng BFL

Para gawing coordinate ang mga posisyon ng pixel, hatiin ang itaas at ibaba sa taas ng larawan, at ang kaliwa at kanan sa lapad nito. I-multiply sa 1000 ang bawat sagot at i-round. Gumagamit ang dokumentadong conversion ng BFL ng canvas na 1920 × 1080:

Kaya ang kahon ay [100, 200, 900, 800]. Saklaw nito nang patayo ang 10% hanggang 90% ng frame at nang pahalang ang 20% hanggang 80%. Ipinapakita ng kalkulasyong ito kung bakit nagbabago ang nilalayong rehiyon kapag pinagpalit ang lapad at taas o inuna ang kaliwa kaysa itaas. Panatilihin ang aspect ratio na ginamit sa pagdisenyo ng layout. Conversion ng coordinate ng BFL

Bumuo ng bagong larawan

Isulat ang paglalarawan ng buong komposisyon at tukuyin ang bawat elemento gamit ang <id> tag. Magdugtong ng JSON array na may field na id, bbox at desc para sa bawat elemento. Ilagay ang array bilang teksto sa loob ng prompt, hindi bilang hiwalay na top-level API field.

Sa dokumentadong halimbawa ng BFL na tumatakbong silweta, nakatakip sa buong canvas ang background at nasa gitnang kahon ang pigura. Sinusunod ng pinaikling request na ito ang layout ng halimbawang iyon; hindi ito pinatakbo ng BIG CHANGE:

{
  "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"
}

Para sa layout na may teksto, maglaan ng hiwalay na row sa bawat linya at ilagay sa desc ang eksaktong mga salitang hinihingi. Gabay sa posisyon at laki ang mga kahon; nagbabala ang BFL na maaaring lumampas ang elemento sa parihaba nito. Hindi mahihigpit na clipping mask ang mga ito. Tutorial ng BFL sa komposisyon at mga limitasyon

Mag-edit ng umiiral na larawan

Ilagay ang pinagmulan sa images. Pinananatili ng mga row ng pag-edit ang id at desc ngunit pinapalitan ang bbox ng mga field na ito:

Pagsamahin ang tagubilin at array ng pag-edit sa prompt, gaya sa pagbuo ng komposisyon. Ilarawan sa parehong bahagi ang mga idadagdag at aalisin. Magdagdag ng mga row na panatilihin para sa mga elementong hindi dapat gumalaw. Ayon sa gabay ng BFL, karaniwang hindi nagbabago ang mga pixel sa labas ng mga kahon, ngunit maaaring magbago ang kalapit na liwanag, repleksiyon, at anino. Ihambing ang buong output sa pinagmulan bago tanggapin ang pag-edit. Iniulat din ng BFL na madalas hindi lumitaw sa sarili nilang mga pagsubok ang mga bagong elementong nasa kahong humigit-kumulang 40 × 25 pixel; obserbasyon ito ng vendor, hindi pangkalahatang minimum o pagsubok ng BIG CHANGE. Mga gabay ng BFL sa pag-edit, iskema ng row sa pag-edit

Pumili ng resolution at badyet

Nakalista sa pangkalahatang-ideya ang 768sq, 1k, 1.5k, 2k at 4k, kasama ang 1k bilang default. Inililista ng pahina ng pagpepresyo ang mga sumusunod na halaga; walang presyo para sa 1.5k. Suriin muna ang gastos ng opsiyong iyon bago gamitin. Pangkalahatang-ideya ng BFL

Ito ang mga presyong nakalista ng BFL sa US dollar, sinuri noong Oktubre 3. Kalkulasyon lamang ang haligi para sa sampung request, hindi aktuwal na nagastos. Pareho ang presyong inililista ng BFL para sa API at Playground; katumbas ng $0.01 ang isang credit. Kasama sa tugon sa pagsusumite ang cost. Ang 4k request ay nagkakahalaga nang humigit-kumulang 12.6 ulit sa nakalistang presyo ng 1k; piliin ang laki ng output na kailangan ng gawain at maglaan ng badyet para sa mga karagdagang pagsubok. Bagong request ang pagbabago ng resolution, at hindi pinatutunayan ng gabay na ito na magbibigay ng magkaparehong komposisyon ang dalawang request. Pagpepresyo ng BFL

Ang opsiyonal na setting na grounding ay naka-default sa true, kaya naghahanap ito sa web at mga larawan bago bumuo ng output. Ayon sa BFL, mas mabilis ang resulta kapag pinatay ito at prompt lamang ang ginamit. Hindi namin sinukat ang pagkakaiba sa bilis o sinuri ang katumpakan ng output na gumagamit ng grounding. Dokumentasyon ng BFL tungkol sa grounding

Isumite, suriin ang status, at i-save ang output

Pagkatapos magsumite, itago ang ibinalik na polling_url at suriin ang eksaktong URL na iyon gamit ang API key mo. Itinuturo nito ang rehiyong kinaroroonan ng task. Pending, Reasoning at Generating ay nangangahulugang tumatakbo pa ang task. Kapag Ready, i-download ang result.sample; mag-e-expire pagkalipas ng isang oras ang pirmadong link nito. Huwag ipadala ang header na x-key sa URL ng download. Kasama rin sa resulta ang result.prompt, na nagpapakita sa pinalawak na prompt, at ang result.duration, na tagal ng pagbuo. Mga tagubilin ng BFL sa pagkuha ng resulta

Iba ang kailangang tugon sa naharang o nabigong task kaysa sa tumatakbo pa. Request Moderated ay nangangahulugang hinarang ang input; Content Moderated naman ay nangangahulugang hinarang ang output. Baguhin ang input bago sumubok muli. Para sa Error, siyasatin ang tugon; ibinabalik ng hindi kilala o nag-expire na task ang Task not found. Nagbabala ang BFL na maaaring dumating ang nabigong task bilang HTTP 503 na may karaniwang JSON body, kaya basahin ang status bago muling subukan. Nagbubunga ng 400 ang sobrang laking reference; maaaring magbalik ng 422 ang hindi kilalang field, maling value, walang laman na prompt, o larawang kulang sa minimum na laki. Hindi tinatanggap dito ang mga field gaya ng seed, width at input_image mula sa ibang endpoint. Gabay ng BFL sa pagbuo at mga error

Kumpleto na ang pagsubok kapag na-save mo na ang output at nasuri ang posisyon ng mga elemento, anumang hiniling na teksto, at mga bahaging nakapaligid sa pag-edit. Ipinapakita ng tugong Ready na may resultang makukuha; sa biswal na pagsusuri mo malalaman kung natutugunan nito ang gawain.

Mga sanggunian at karagdagang babasahin

• Pahina ng produkto ng FLUX 3 Image: inilalarawan ang mga ruta sa browser at API, pati ang access sa komersiyal na lisensiya para sa weights. Materyal ng vendor ang mga demo nito, hindi resulta ng aming mga pagsubok.
• Mga release note noong Oktubre 1: tinutukoy ang petsa ng paglabas ng image at inilalarawan ang pinagsasaluhang endpoint. Binabasa namin ang malalawak na pahayag tungkol sa kontrol kasabay ng mas tiyak na mga limitasyon sa mga tutorial.
• Pangkalahatang-ideya ng endpoint: inililista ang mga parameter, limitasyon sa reference, pagpipilian sa resolution, at gawi ng grounding.
• Tutorial sa mga bounding box: ipinapaliwanag ang dalawang iskema ng row at ang halimbawang tumatakbong silweta na inangkop sa itaas.
• Gabay sa pag-edit: sumusuporta sa conversion ng coordinate, pagkakasunod-sunod ng mga reference, at mga babala tungkol sa maliliit na rehiyon at kalapit na pixel.
• Gabay sa pagbuo ng larawan: nagdodokumento ng authentication, asynchronous na pagkuha ng output, mga link na nag-e-expire, at mga error.
• Pagpepresyo: nagbibigay ng mga halagang ginamit sa aming kalkulasyon. Suriin muli ang presyo at mga parameter ng request bago magbayad para sa pagsubok; palaging nagbabago ang mga dokumentong ito.