FLUX 3 Image: panduan kotak tata letak dan penyuntingan terarah

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.

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
• 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
• 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, batasan penyuntingan

Pilih jalur browser atau API

Halaman produk BFL produk menjelaskan dua cara masuk: menggambar kotak di Playground berbasis browser atau mengirim prompt tata letak melalui API. Dokumentasi tertaut ke Playground 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. 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, harga dan pengaturan

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

Tentukan seberapa banyak detail gambar yang akan ditetapkan

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

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

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

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:

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

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:

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

Sunting gambar yang sudah ada

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

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, skema baris penyuntingan

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

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

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

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

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

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: menjelaskan jalur browser/API dan akses lisensi bobot komersial. Demonstrasi di dalamnya berasal dari vendor, bukan hasil pengujian kami.
• Catatan rilis 1 Oktober: mencantumkan tanggal rilis gambar dan menjelaskan endpoint bersama. Klaim kendali yang luas dibaca dengan mempertimbangkan batasan lebih khusus dalam tutorial.
• Ringkasan endpoint: memuat parameter, batas referensi, pilihan resolusi, dan perilaku grounding.
• Tutorial kotak pembatas: menjelaskan dua skema baris dan contoh siluet berlari yang diadaptasi di atas.
• Panduan penyuntingan: mendukung konversi koordinat, urutan referensi, serta catatan kehati-hatian tentang area kecil dan piksel di sekitarnya.
• Panduan pembuatan: mendokumentasikan autentikasi, pengambilan hasil asinkron, tautan kedaluwarsa, dan kesalahan.
• Harga: memuat tarif yang digunakan dalam perhitungan kami. Periksa ulang harga dan parameter permintaan sebelum membayar percobaan; dokumentasi ini terus diperbarui.