AI-translated from English; not yet reviewed by a fluent editor.

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

> Gamitin ang mga kahon ng layout ng FLUX 3 Image at mga reference image para buuin ang komposisyon o magsagawa ng piling pag-edit. Gabay batay sa dokumentasyon tungkol sa mga coordinate, pagkuha ng resulta, presyo, at limitasyon.

By BIG CHANGE Editorial

Published: 2026-10-03T04:10:59.237Z
Updated: 2026-10-03T04:10:59.237Z
Canonical: https://bigchange.ai/blog/flux-3-image-layout-editing-guide

![Conceptual charcoal illustration of one right hand placing a flat runner cutout on an orange square art backing.](https://bigchange.ai/api/media/file/flux-layout-collage-hero-v1.png)
AI-generated conceptual editorial illustration by BIG CHANGE.

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](https://docs.bfl.ai/release-notes).

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](https://docs.bfl.ai/release-notes)
- **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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)
- **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](https://docs.bfl.ai/quick_start/pricing), [mga limitasyon sa pag-edit](https://docs.bfl.ai/flux_3/flux3_image_layout)

## Piliin ang ruta sa browser o API

Inilalarawan ng [pahina ng produkto](https://bfl.ai/models/flux-3-image) 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](https://playground.bfl.ai) 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](https://dashboard.bfl.ai). 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](https://docs.bfl.ai/flux_3/flux3_image_generate), [pagpepresyo at setup](https://docs.bfl.ai/quick_start/pricing)

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](https://bfl.ai/models/flux-3-image)

## Tukuyin kung gaano karaming detalye ang ilalagay sa larawan

| Gawain | Dokumentadong input | Gagamitin na kontrol |
| --- | --- | --- |
| Bumuo ng bagong komposisyon | Prompt ng eksena, maaaring sundan ng talahanayan ng mga elemento | `bbox` para sa bawat elementong mahalaga ang posisyon |
| Baguhin ang nakikilalang detalye | Isang tagubilin at isang reference image | Maaaring sapat ang tumpak na paglalarawan; suriin ang pinalawak na prompt |
| Piliin nang eksakto kung aling elemento ang ie-edit | Isang tagubilin, reference image, at talahanayan ng pag-edit | Mga kahon ng pinagmulan at patutunguhan, kasama ang mga row na panatilihin para sa elementong hindi dapat baguhin |
| Pagsamahin ang mga reference | Prompt na nagpapaliwanag sa gamit ng mga ito at 2 hanggang 10 larawan | Tukuyin kung aling larawan ang pinagmulan ng bawat paksa, bagay, o tagpuan |

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](https://docs.bfl.ai/flux_3/flux3_image_layout)

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](https://docs.bfl.ai/flux_3/flux3_image_overview)

## 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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#format)

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:

| Gilid | Posisyon ng pixel | Kalkulasyon | Halaga sa grid |
| --- | --- | --- | --- |
| Itaas | 108 | 108 ÷ 1080 × 1000 | 100 |
| Kaliwa | 384 | 384 ÷ 1920 × 1000 | 200 |
| Ibaba | 972 | 972 ÷ 1080 × 1000 | 900 |
| Kanan | 1536 | 1536 ÷ 1920 × 1000 | 800 |

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](https://docs.bfl.ai/flux_3/flux3_image_layout#send-a-request)

## 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:

```json
{
  "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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)

## 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:

| Operasyon | `from` | `src_bbox` | `tgt_bbox` |
| --- | --- | --- | --- |
| Panatilihin ang elemento | `"ref_image_0"` | Kahon sa pinagmulan nito | Parehong kahon |
| Ilipat o baguhin ang laki | `"ref_image_0"` | Kahon sa pinagmulan nito | Ibang kahon na patutunguhan |
| Idagdag, palitan, o kulayan muli | `null` | `null` | Nais na kahon sa output |
| Alisin ito | `"ref_image_0"` | Kahon sa pinagmulan nito | `null` |

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](https://docs.bfl.ai/flux_3/flux3_image_layout), [iskema ng row sa pag-edit](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#edit-an-image-box-by-box)

## 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](https://docs.bfl.ai/flux_3/flux3_image_overview)

| Resolution | Dokumentadong laki ng output | Presyo bawat larawan | Kalkuladong halaga para sa sampung request |
| --- | --- | --- | --- |
| `768sq` | 768 × 768 | $0.041 | $0.41 |
| `1k` | Humigit-kumulang 1 megapixel | $0.048 | $0.48 |
| `2k` | Humigit-kumulang 4 megapixel | $0.100 | $1.00 |
| `4k` | Humigit-kumulang 16 megapixel | $0.607 | $6.07 |

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](https://docs.bfl.ai/quick_start/pricing)

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](https://docs.bfl.ai/flux_3/flux3_image_overview#ground-the-prompt)

## 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](https://docs.bfl.ai/flux_3/flux3_image_generate#results-and-errors)

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](https://docs.bfl.ai/flux_3/flux3_image_generate)

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](https://bfl.ai/models/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](https://docs.bfl.ai/release-notes): 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](https://docs.bfl.ai/flux_3/flux3_image_overview): inililista ang mga parameter, limitasyon sa reference, pagpipilian sa resolution, at gawi ng grounding.
- [Tutorial sa mga bounding box](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes): ipinapaliwanag ang dalawang iskema ng row at ang halimbawang tumatakbong silweta na inangkop sa itaas.
- [Gabay sa pag-edit](https://docs.bfl.ai/flux_3/flux3_image_layout): 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](https://docs.bfl.ai/flux_3/flux3_image_generate): nagdodokumento ng authentication, asynchronous na pagkuha ng output, mga link na nag-e-expire, at mga error.
- [Pagpepresyo](https://docs.bfl.ai/quick_start/pricing): 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.

## Sources

- [FLUX 3 Image](https://bfl.ai/models/flux-3-image) — naglalarawan sa mga ruta sa browser at API, pati sa access sa komersiyal na lisensiya para sa weights. Materyal ng vendor ang mga demo nito, hindi resulta ng aming mga pagsubok. Hindi pinatutunayan ng mga sinuring sanggunian na may mada-download na open weights para sa Image endpoint na ito.
- [Pangkalahatang-ideya ng FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_overview) — nagbibigay ng mga parameter, limitasyon sa reference, pagpipilian sa resolution, at gawi ng grounding.
- [Layout at pag-edit ng FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_layout) — sumusuporta sa conversion ng coordinate, pagkakasunod-sunod ng mga reference, at mga babala tungkol sa maliliit na rehiyon at kalapit na pixel.
- [Pagbuo ng larawan gamit ang FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_generate) — nagdodokumento ng authentication, asynchronous na pagkuha ng output, mga link na nag-e-expire, at mga error.
- [Mga release note](https://docs.bfl.ai/release-notes) — tumutukoy sa petsa ng paglabas ng image at naglalarawan sa pinagsasaluhang endpoint. Binabasa ang malalawak na pahayag tungkol sa kontrol kasabay ng mas tiyak na mga limitasyon sa mga tutorial.
- [Pagpepresyo](https://docs.bfl.ai/quick_start/pricing) — nagbibigay ng mga halagang ginamit sa aming kalkulasyon. Suriin muli ang presyo at mga parameter ng request bago magbayad para sa pagsubok; mga live na dokumento ang mga ito.
- [Mga bounding box ng FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes) — ipinapaliwanag ang dalawang iskema ng row at ang halimbawang tumatakbong silweta na inangkop sa itaas.