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

# FLUX 3 Image: panduan kotak tata letak dan penyuntingan terarah

> Gunakan kotak tata letak dan gambar referensi FLUX 3 Image untuk mengatur komposisi atau menyunting bagian tertentu. Panduan berbasis dokumentasi ini membahas koordinat, pengambilan hasil, harga, dan batasan.

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.

FLUX 3 Image memungkinkan Anda menjelaskan penempatan tiap elemen dengan menggunakan persegi panjang sebagai bagian dari prompt gambar. Sistem yang sama mendukung penyuntingan gambar referensi: setiap elemen dapat memiliki posisi sumber, tujuan, dan deskripsi tentang perubahan yang diinginkan. Black Forest Labs menambahkan endpoint gambar ke [catatan rilis pada 1 Oktober 2026](https://docs.bfl.ai/release-notes).

Bagi desainer dan kreator, pembedaan yang berguna adalah antara merencanakan seluruh komposisi dan mengubah elemen pada gambar yang sudah ada. Panduan ini menjelaskan cara memilih di antara keduanya, mengubah persegi panjang menjadi koordinat yang diperlukan, dan mengambil hasil dari API. Panduan ini hanya berdasarkan dokumentasi, yang diperiksa pada 3 Oktober 2026. BIG CHANGE tidak membuat atau menyunting gambar dengan produk ini.

## Perubahan besar

- **Apa yang berubah:** Catatan rilis BFL tanggal 1 Oktober mendokumentasikan komposisi dan penyuntingan melalui `v1/flux-3-image`. Deskripsi adegan dan tabel elemen JSON menggunakan satu prompt bersama, dengan kotak untuk menentukan posisi atau penyuntingan. [Catatan rilis BFL](https://docs.bfl.ai/release-notes)
- **Mengapa ini penting:** Kreator dapat mengubah persegi panjang yang direncanakan menjadi koordinat, lalu menentukan elemen referensi mana yang dipertahankan, dipindahkan, atau diganti. Pilihan praktisnya adalah seberapa terperinci instruksi: seluruh komposisi, perintah sederhana, atau tabel penyuntingan eksplisit. [Tutorial kotak BFL](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)
- **Yang perlu diperhatikan:** Tentukan resolusi dan anggaran sebelum mengirim permintaan: harga yang tercantum untuk `1k` dan `4k` adalah $0.048 dan $0.607 per gambar. Periksa hasil lengkap karena kotak dapat membolehkan elemen meluber, dan penyuntingan dapat memengaruhi pencahayaan, bayangan, atau pantulan di dekatnya. [Harga BFL](https://docs.bfl.ai/quick_start/pricing), [batasan penyuntingan](https://docs.bfl.ai/flux_3/flux3_image_layout)

## Pilih jalur browser atau API

Halaman produk BFL [produk](https://bfl.ai/models/flux-3-image) menjelaskan dua cara masuk: menggambar kotak di Playground berbasis browser atau mengirim prompt tata letak melalui API. [Dokumentasi tertaut ke Playground](https://playground.bfl.ai) untuk penggunaan tanpa kode. Gunakan jalur browser jika ingin menggambar area secara langsung; gunakan API jika perlu mengirim koordinat dalam permintaan dan mengambil hasil secara terprogram. Kami belum memeriksa kontrol Playground saat ini, jadi petunjuk berikut menjelaskan format permintaan yang didokumentasikan, bukan urutan tombol di browser.

Untuk menggunakan API, buat akun BFL, tambahkan kredit, lalu dapatkan kunci dari [dasbor](https://dashboard.bfl.ai). Kirim JSON dengan permintaan `POST` ke `https://api.bfl.ai/v1/flux-3-image`, menggunakan `Content-Type: application/json` dan kunci di header `x-key`. Hanya `prompt` yang wajib diisi. [Panduan pembuatan BFL](https://docs.bfl.ai/flux_3/flux3_image_generate), [harga dan pengaturan](https://docs.bfl.ai/quick_start/pricing)

FLUX 3 Image dan FLUX 3 Dev harus dibedakan: petunjuk ini mencakup endpoint Image ter-host milik BFL. Halaman produk Image menawarkan lisensi bobot komersial melalui bagian penjualan. Sumber yang diperiksa untuk panduan ini tidak membuktikan adanya unduhan bobot terbuka untuk FLUX 3 Image. [Akses FLUX 3 Image](https://bfl.ai/models/flux-3-image)

## Tentukan seberapa banyak detail gambar yang akan ditetapkan

| Tugas | Masukan yang didokumentasikan | Kontrol yang digunakan |
| --- | --- | --- |
| Membuat komposisi baru | Prompt adegan, opsional diikuti tabel elemen | `bbox` untuk setiap elemen yang penempatannya penting |
| Mengubah detail yang dapat dikenali | Instruksi dan satu gambar referensi | Deskripsi yang tepat mungkin cukup; periksa prompt yang diperluas |
| Memilih elemen yang akan disunting secara persis | Instruksi, gambar referensi, dan tabel penyuntingan | Kotak sumber dan tujuan, dengan baris “pertahankan” untuk elemen yang harus dijaga |
| Menggabungkan referensi | Prompt yang menjelaskan peran tiap gambar dan 2 hingga 10 gambar | Tentukan gambar mana yang menyediakan tiap subjek, objek, atau latar |

BFL menyatakan bahwa penyuntingan sederhana dapat memperoleh kotak secara otomatis saat prompt diperluas. Untuk kontrol eksplisit, berikan tabel sendiri. Dalam instruksi biasa, “image 1” berarti referensi pertama; dalam baris penyuntingan, referensi yang sama ditulis sebagai `ref_image_0`. [Panduan penyuntingan BFL](https://docs.bfl.ai/flux_3/flux3_image_layout)

Referensi dimasukkan ke `images` sebagai URL atau data base64, berupa satu string atau daftar. Jika disertakan, jumlahnya dapat 1 hingga 10 gambar, masing-masing berukuran dari 256 × 256 piksel hingga 16 megapiksel. Nilai bawaan `aspect_ratio` adalah `auto`: bentuknya mengikuti referensi pertama, atau menjadi persegi jika tidak ada referensi. Tetapkan secara eksplisit jika tata letak Anda membutuhkan bentuk tertentu. [Ringkasan endpoint BFL](https://docs.bfl.ai/flux_3/flux3_image_overview)

## Ubah persegi panjang menjadi kotak

Setiap kotak berbentuk `[top, left, bottom, right]`, dengan koordinat bilangan bulat dari 0 hingga 1000. Koordinat vertikal dicantumkan lebih dulu. Setiap sumbu membentang sendiri di sepanjang seluruh gambar, sehingga kisi menyesuaikan dengan kanvas lanskap maupun potret. [Format kotak BFL](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#format)

Untuk mengubah posisi piksel, bagi nilai atas dan bawah dengan tinggi gambar, serta kiri dan kanan dengan lebarnya. Kalikan tiap hasil dengan 1000 lalu bulatkan. Konversi yang didokumentasikan BFL menggunakan kanvas berukuran 1920 × 1080:

| Tepi | Posisi piksel | Perhitungan | Nilai kisi |
| --- | --- | --- | --- |
| Atas | 108 | 108 ÷ 1080 × 1000 | 100 |
| Kiri | 384 | 384 ÷ 1920 × 1000 | 200 |
| Bawah | 972 | 972 ÷ 1080 × 1000 | 900 |
| Kanan | 1536 | 1536 ÷ 1920 × 1000 | 800 |

Dengan demikian, kotaknya adalah `[100, 200, 900, 800]`. Rentang vertikalnya dari 10% hingga 90% bingkai; rentang horizontalnya dari 20% hingga 80%. Perhitungan ini menjelaskan mengapa menukar lebar dengan tinggi atau memasukkan nilai kiri sebelum atas akan mengubah area yang dimaksud. Pertahankan rasio aspek yang digunakan untuk merancang tata letak. [Konversi koordinat BFL](https://docs.bfl.ai/flux_3/flux3_image_layout#send-a-request)

## Buat gambar baru

Tulis deskripsi seluruh komposisi, dan tandai elemen dengan penanda `<id>`. Tambahkan array JSON yang berisi `id`, `bbox` dan `desc` untuk setiap elemen. Array tersebut berupa teks di dalam `prompt`, bukan kolom API tingkat teratas lainnya.

Contoh siluet berlari yang didokumentasikan BFL memiliki latar belakang yang menutupi seluruh kanvas dan sosok yang menempati kotak tengah. Permintaan yang dipersingkat ini mengikuti tata letak contoh tersebut; BIG CHANGE belum menjalankannya:

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

Untuk tata letak yang memuat teks, buat satu baris tersendiri untuk setiap baris tulisan dan cantumkan kata-kata persis yang diminta di dalam `desc`. Kotak menjadi panduan penempatan dan skala; BFL memperingatkan bahwa elemen dapat meluas ke luar persegi panjangnya. Kotak bukanlah masker pemotong yang keras. [Tutorial komposisi dan batasan BFL](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)

## Sunting gambar yang sudah ada

Sertakan sumber gambar di `images`. Baris penyuntingan mempertahankan `id` dan `desc` tetapi mengganti `bbox` dengan kolom berikut:

| Operasi | `from` | `src_bbox` | `tgt_bbox` |
| --- | --- | --- | --- |
| Mempertahankan elemen | `"ref_image_0"` | Kotak sumbernya | Kotak yang sama |
| Memindahkan atau mengubah ukurannya | `"ref_image_0"` | Kotak sumbernya | Kotak tujuan yang berbeda |
| Menambahkan, mengganti, atau mengubah warnanya | `null` | `null` | Kotak keluaran yang diinginkan |
| Menghapusnya | `"ref_image_0"` | Kotak sumbernya | `null` |

Gabungkan instruksi dan array penyuntingan ke dalam `prompt`, seperti pada komposisi. Jelaskan penambahan dan penghapusan di kedua tempat. Tambahkan baris “pertahankan” untuk elemen yang harus tetap di tempatnya. Panduan BFL menyebutkan bahwa piksel di luar kotak biasanya tetap sama, tetapi pencahayaan, pantulan, dan bayangan di dekatnya dapat berubah. Bandingkan seluruh hasil dengan sumber sebelum menerima penyuntingan. BFL juga melaporkan bahwa elemen baru di dalam kotak sekitar 40 × 25 piksel sering kali tidak muncul dalam pengujiannya sendiri; ini pengamatan vendor, bukan ukuran minimum universal atau hasil pengujian BIG CHANGE. [Panduan penyuntingan BFL](https://docs.bfl.ai/flux_3/flux3_image_layout), [skema baris penyuntingan](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#edit-an-image-box-by-box)

## Pilih resolusi dan anggaran

Ringkasan mencantumkan `768sq`, `1k`, `1.5k`, `2k` dan `4k`, dengan `1k` sebagai nilai bawaan. Halaman harga memublikasikan tarif berikut; halaman itu tidak mencantumkan harga untuk `1.5k`. Periksa biaya opsi tersebut sebelum menggunakannya. [Ringkasan BFL](https://docs.bfl.ai/flux_3/flux3_image_overview)

| Resolusi | Ukuran keluaran yang didokumentasikan | Harga per gambar | Biaya sepuluh permintaan, hasil perhitungan |
| --- | --- | --- | --- |
| `768sq` | 768 × 768 | $0.041 | $0.41 |
| `1k` | Sekitar 1 megapiksel | $0.048 | $0.48 |
| `2k` | Sekitar 4 megapiksel | $0.100 | $1.00 |
| `4k` | Sekitar 16 megapiksel | $0.607 | $6.07 |

Ini harga dalam dolar AS yang dicantumkan BFL dan diperiksa pada 3 Oktober. Kolom sepuluh permintaan merupakan hasil hitungan, bukan pengeluaran yang diukur. BFL mencantumkan harga yang sama untuk API dan Playground, dengan satu kredit setara $0,01. Respons pengiriman menyertakan `cost`. Permintaan `4k` berharga sekitar 12,6 kali lipat dari biaya tercantum untuk `1k`; pilih ukuran keluaran sesuai kebutuhan tugas dan anggarkan percobaan tambahan. Mengubah resolusi berarti membuat permintaan baru, dan panduan ini tidak membuktikan bahwa dua permintaan akan menghasilkan komposisi yang sama. [Harga BFL](https://docs.bfl.ai/quick_start/pricing)

Pengaturan opsional `grounding` secara bawaan bernilai `true`, yang mengaktifkan penelusuran web dan gambar sebelum pembuatan. BFL menyatakan bahwa menonaktifkannya mempercepat hasil karena hanya menggunakan prompt. Kami belum mengukur perbedaan kecepatannya ataupun memverifikasi keakuratan keluaran yang didasarkan pada pencarian. [Dokumentasi grounding BFL](https://docs.bfl.ai/flux_3/flux3_image_overview#ground-the-prompt)

## Kirim, pantau, dan simpan hasil

Setelah mengirim permintaan, simpan `polling_url` yang dikembalikan dan polling URL yang sama persis itu dengan kunci API Anda. URL tersebut mengarah ke wilayah tempat tugas dijalankan. `Pending`, `Reasoning` dan `Generating` berarti tugas masih berjalan. Saat statusnya `Ready`, unduh `result.sample`; tautan bertanda tangan tersebut kedaluwarsa setelah satu jam. Jangan kirim header `x-key` ke URL unduhan. Hasilnya juga memuat `result.prompt`, yang menunjukkan instruksi yang diperluas, dan `result.duration`, yaitu waktu pembuatan. [Petunjuk pengambilan hasil BFL](https://docs.bfl.ai/flux_3/flux3_image_generate#results-and-errors)

Tugas yang diblokir atau gagal memerlukan respons berbeda dari tugas yang masih berjalan. `Request Moderated` berarti masukan diblokir; `Content Moderated` berarti keluaran diblokir. Sesuaikan masukan sebelum mencoba lagi. Untuk `Error`, periksa responsnya; tugas yang tidak dikenal atau kedaluwarsa mengembalikan `Task not found`. BFL memperingatkan bahwa tugas yang gagal dapat diterima sebagai HTTP `503` dengan isi JSON biasa, jadi baca bagian `status` sebelum mencoba kembali. Referensi yang terlalu besar menghasilkan `400`; kolom yang tidak dikenal, nilai tidak valid, prompt kosong, atau gambar terlalu kecil dapat menghasilkan `422`. Kolom seperti `seed`, `width` dan `input_image` dari endpoint lain tidak diterima di sini. [Panduan pembuatan dan kesalahan BFL](https://docs.bfl.ai/flux_3/flux3_image_generate)

Percobaan selesai setelah Anda menyimpan hasil dan memeriksa penempatan, teks yang diminta, serta area di sekitar bagian yang disunting. Respons `Ready` memastikan hasil tersedia; tinjauan visual Anda menentukan apakah hasil itu memenuhi kebutuhan.

## Sumber & bacaan lebih lanjut

- [Halaman produk FLUX 3 Image](https://bfl.ai/models/flux-3-image): menjelaskan jalur browser/API dan akses lisensi bobot komersial. Demonstrasi di dalamnya berasal dari vendor, bukan hasil pengujian kami.
- [Catatan rilis 1 Oktober](https://docs.bfl.ai/release-notes): mencantumkan tanggal rilis gambar dan menjelaskan endpoint bersama. Klaim kendali yang luas dibaca dengan mempertimbangkan batasan lebih khusus dalam tutorial.
- [Ringkasan endpoint](https://docs.bfl.ai/flux_3/flux3_image_overview): memuat parameter, batas referensi, pilihan resolusi, dan perilaku grounding.
- [Tutorial kotak pembatas](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes): menjelaskan dua skema baris dan contoh siluet berlari yang diadaptasi di atas.
- [Panduan penyuntingan](https://docs.bfl.ai/flux_3/flux3_image_layout): mendukung konversi koordinat, urutan referensi, serta catatan kehati-hatian tentang area kecil dan piksel di sekitarnya.
- [Panduan pembuatan](https://docs.bfl.ai/flux_3/flux3_image_generate): mendokumentasikan autentikasi, pengambilan hasil asinkron, tautan kedaluwarsa, dan kesalahan.
- [Harga](https://docs.bfl.ai/quick_start/pricing): memuat tarif yang digunakan dalam perhitungan kami. Periksa ulang harga dan parameter permintaan sebelum membayar percobaan; dokumentasi ini terus diperbarui.

## Sources

- [FLUX 3 Image](https://bfl.ai/models/flux-3-image) — menjelaskan jalur browser/API dan akses lisensi bobot komersial. Demonstrasi di dalamnya berasal dari vendor, bukan hasil pengujian kami. Sumber yang diperiksa tidak membuktikan adanya unduhan bobot terbuka untuk endpoint Image ini.
- [Ringkasan FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_overview) — memuat parameter, batas referensi, pilihan resolusi, dan perilaku grounding.
- [Tata letak dan penyuntingan FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_layout) — mendukung konversi koordinat, urutan referensi, serta catatan kehati-hatian tentang area kecil dan piksel di sekitarnya.
- [Pembuatan FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_generate) — mendokumentasikan autentikasi, pengambilan hasil asinkron, tautan kedaluwarsa, dan kesalahan.
- [Catatan rilis](https://docs.bfl.ai/release-notes) — mencantumkan tanggal rilis gambar dan menjelaskan endpoint bersama. Klaim kendali yang luas dibaca dengan mempertimbangkan batasan lebih khusus dalam tutorial.
- [Harga](https://docs.bfl.ai/quick_start/pricing) — memuat tarif yang digunakan dalam perhitungan kami. Periksa ulang harga dan parameter permintaan sebelum membayar percobaan; dokumentasi ini terus diperbarui.
- [Kotak pembatas FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes) — menjelaskan dua skema baris dan contoh siluet berlari yang diadaptasi di atas.