FLUX 3 Image Klein: Panduan Praktis untuk Referensi, Tata Letak, dan Penyuntingan Lokal

Anda punya foto produk yang layak, tetapi tata letaknya tidak cocok untuk kebutuhan berikutnya. Subjek perlu digeser ke kiri, latar belakang diganti, dan sisi kanan tetap kosong untuk judul. Meminta generator gambar membuat ulang dari awal memang mudah. Mendapatkan revisi yang benar-benar bisa dipakai jauh lebih sulit.

FLUX 3 Image Klein menggabungkan pembuatan gambar dari teks, penyuntingan, dan beberapa gambar referensi dalam satu keluarga model. Black Forest Labs merilisnya pada 15 Oktober 2026. Perubahan menariknya bukan sekadar contoh yang indah, melainkan kemampuan menjelaskan isi gambar sekaligus posisi elemen-elemennya. Pengumuman BFL

Panduan ini membawa Anda dari percobaan kecil pertama ke alur penyuntingan yang dapat diulang. Mulailah di browser untuk memahami alatnya; pilih API untuk aplikasi; pertimbangkan eksekusi lokal jika kendali atas berkas atau penggunaan berulang sepadan dengan persiapannya. Anda tidak perlu memahami matematika diffusion untuk menentukan pilihan.

Pilih jalur terpendek menuju gambar pertama yang berguna

Ini produk berbeda di sekitar bobot yang terkait, bukan tombol yang bisa saling menggantikan. Model adalah kumpulan bobot yang telah dipelajari. Runtime menjalankannya. ComfyUI menyediakan antarmuka alur kerja; Diffusers menyediakan komponen Python; API ter-host menyediakan layanan terkelola. Fitur yang Anda lihat pada satu antarmuka belum tentu mencakup pemrosesan yang dilakukan antarmuka lain.

Untuk percobaan pertama, buka Space resmi atau BFL Playground. Periksa permintaan akun dan penagihan sebelum membuat gambar. Browser adalah jalur awal yang sama di Windows, macOS, dan Linux; Anda tidak memerlukan GPU lokal untuk memakai layanan jarak jauh.

Gunakan gambar milik Anda yang aman dikirim ke layanan tersebut. Foto mug milik sendiri lebih baik untuk belajar daripada produk pelanggan yang belum dirilis. Latihan berikut memberi tugas kecil yang konkret dan cara menilai hasilnya.

Buat satu perubahan terkontrol sebelum menggabungkan sepuluh referensi

1. Simpan gambar sumber tanpa perubahan dan catat dimensinya.
2. Pilih alur penyuntingan, lalu lampirkan satu gambar itu.
3. Jelaskan seluruh adegan yang diinginkan, termasuk bagian yang harus tetap dikenali.
4. Minta satu perubahan, misalnya mengganti latar, bukan sekaligus mengubah subjek, gaya, dan komposisi.
5. Bandingkan hasil dengan sumber pada resolusi penuh. Periksa bentuk, teks, tepi, dan pencahayaan, bukan hanya gambar mini.
6. Simpan instruksi dan hasilnya bersama-sama. Ubah satu variabel pada percobaan berikutnya.

Sebagai contoh, mulailah dengan deskripsi adegan berikut:

A catalog photograph of the same plain ceramic mug from the reference image,
with its handle and proportions preserved, on a matte pale-green surface.
Soft light comes from the left. The mug sits in the left third of a wide
composition, leaving clear space on the right for text added later.

Kriteria penerimaannya Anda tentukan: gagang tidak berubah, siluet mug tetap berguna, dan area kosong benar-benar kosong. Jika logo harus persis, bandingkan dengan aslinya alih-alih memercayai rekonstruksi yang sekilas tampak meyakinkan. Tambahkan tipografi akhir dengan alat desain biasa jika ejaan dan bentuk merek tidak boleh meleset.

Kartu model resmi menyebut hingga 10 gambar referensi. Itu batas kapasitas, bukan anjuran untuk selalu memakai sepuluh. Dua referensi dengan sudut kamera bertentangan dapat menimbulkan lebih banyak ambiguitas daripada satu referensi yang bersih. Beri tiap masukan peran tertentu: subjek, material, komposisi, atau gaya.

Kotak tata letak mengarahkan komposisi, bukan mengunci piksel

FLUX 3 mendukung deskripsi wilayah dengan koordinat ternormalisasi. Alih-alih hanya berkata "letakkan objek di kiri", Anda dapat memberi kotak dan menjelaskan isi yang terkait. Rentang koordinatnya 0 hingga 1000, jadi deskripsi tata letak tidak bergantung langsung pada apakah gambar akhir lebarnya 1024 atau 2048 piksel. Panduan kotak pembatas BFL

Diagram penjelas orisinal. Kotak menyatakan lokasi yang diminta, bukan hasil generasi yang diamati atau masker piksel yang mengikat.

Berikut fragmen caption generasi ilustratif. Fragmen ini menjelaskan komposisi baru, bukan penyuntingan gambar referensi. Letakkan di dalam prompt, bukan terminal:

A clean studio composition with a ceramic mug <mug_1> on the left.
[{"id":"mug_1","bbox":[200,80,850,480],"desc":"A plain ceramic mug with a visible handle"}]

Urutannya adalah atas, kiri, bawah, kanan. Pada contoh ini kotak dimulai 20% dari atas dan 8% dari kiri kanvas, lalu berakhir 85% dari atas dan 48% dari kiri. Untuk desain nyata, sketsakan susunan yang dituju dahulu, kemudian ubah menjadi koordinat. Menukar nilai horizontal dan vertikal mudah menghasilkan hasil membingungkan.

Penyuntingan perlu menyebut sumber sekaligus tujuan. Isi API ilustratif berikut memindahkan mug dari kotak sumber di tengah ke kotak tujuan di kiri. Ganti URL contoh dengan gambar milik Anda yang dapat dijangkau; jangan kirim placeholder tanpa perubahan. Referensi pertama adalah ref_image_0.

{
  "images": ["https://example.com/your-own-mug.png"],
  "output_format": "png",
  "prompt": "In <ref_image_0>, move the mug <mug_1> to the left. Preserve the mug's handle and the plain background. [{\"id\":\"mug_1\",\"from\":\"ref_image_0\",\"src_bbox\":[200,300,850,700],\"tgt_bbox\":[200,80,850,480],\"desc\":\"The same plain ceramic mug with its handle visible\"}]"
}

Di sini from menamai referensi, src_bbox menunjukkan wilayah asal, dan tgt_bbox menjelaskan tujuan. Tambahkan baris untuk elemen lain jika rencana mempertahankan detail perlu lebih lengkap. CLI referensi lokal memakai koordinat 0 hingga 1 dalam boxes.json terpisah; jangan tempel nilai API 0–1000 ke sana. Sintaks penyuntingan ter-host, format kotak lokal

Jangan anggap kotak menjamin semua bagian di luarnya tidak berubah. Dokumentasi checkpoint mentah memperingatkan bahwa penyuntingan dapat memengaruhi wilayah lain dan elemen dapat melampaui kotaknya. Jalur penyuntingan ter-host BFL juga menyertakan pemulihan piksel; fitur layanan itu tidak boleh dianggap ada pada setiap pipeline lokal. Periksa implementasi yang digunakan. Batasan checkpoint

Untuk pekerjaan cetak atau klien, tumpuk gambar lama dan baru di editor. Jika objek berhasil dipindahkan tetapi teks kemasannya berubah, komposisi berhasil sementara pelestarian aset gagal. Itu dua penilaian berbeda; memisahkannya membuat iterasi jauh lebih mudah.

Permintaan API adalah awal pekerjaan, bukan berkas akhirnya

Pengembang dapat mengirim permintaan gambar ke endpoint terdokumentasi. Di terminal macOS atau Linux, atur BFL_API_KEY secara privat di lingkungan, lalu gunakan contoh ini. Layanan mungkin mengenakan biaya; jangan letakkan kunci di repositori publik atau bundel browser.

curl --fail-with-body --request POST \
  --url https://api.bfl.ai/v1/flux-3-image-klein \
  --header "x-key: $BFL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"prompt":"A simple studio photograph of a plain ceramic mug on a pale green surface","aspect_ratio":"16:9","output_format":"png"}' \
  --output bfl-job.json

Untuk Windows PowerShell, gunakan endpoint sama dengan serialisasi JSON native:

$body = @{
    prompt = "A simple studio photograph of a plain ceramic mug on a pale green surface"
    aspect_ratio = "16:9"
    output_format = "png"
} | ConvertTo-Json
$job = Invoke-RestMethod -Method Post `
    -Uri "https://api.bfl.ai/v1/flux-3-image-klein" `
    -Headers @{ "x-key" = $env:BFL_API_KEY } `
    -ContentType "application/json" -Body $body
$job | ConvertTo-Json -Depth 10 | Set-Content -Encoding utf8 bfl-job.json

Pilih satu metode pengiriman di atas. Keduanya menyimpan pekerjaan yang diterima ke bfl-job.json; tidak satu pun mengunduh hasil. Simpan skrip Python pustaka standar berikut sebagai poll_result.py di folder yang sama. Pastikan BFL_API_KEY tersedia bagi prosesnya, lalu jalankan python poll_result.py di Windows atau python3 poll_result.py di macOS/Linux. Skrip ini memeriksa pekerjaan yang sudah ada dan menyimpan result.png tanpa mengirim generasi lain.

import json
import os
from pathlib import Path
import time
from urllib.parse import urlparse
from urllib.request import Request, urlopen

job = json.loads(Path("bfl-job.json").read_text(encoding="utf-8-sig"))
polling_url = job["polling_url"]
parsed = urlparse(polling_url)
if parsed.scheme != "https" or not (parsed.hostname or "").endswith(".bfl.ai"):
    raise ValueError("Unexpected polling host; inspect the saved job")
headers = {"x-key": os.environ["BFL_API_KEY"]}
deadline = time.monotonic() + 600

while time.monotonic() < deadline:
    with urlopen(Request(polling_url, headers=headers), timeout=60) as reply:
        result = json.load(reply)
    status = result["status"]
    print(job["id"], status)
    if status == "Ready":
        sample = result["result"]["sample"]
        if urlparse(sample).scheme != "https":
            raise ValueError("Unexpected result URL")
        with urlopen(sample, timeout=120) as image:
            Path("result.png").write_bytes(image.read())
        print("Saved result.png; inspect it before accepting the asset")
        break
    if status not in {"Pending", "Reasoning", "Generating"}:
        raise RuntimeError(f"Job stopped: {status}; keep bfl-job.json")
    time.sleep(1.5)
else:
    raise TimeoutError("Keep bfl-job.json and resume polling this job later")

API hasil membedakan status berjalan, siap, dimoderasi, dan galat. Jika pengecualian jaringan menghentikan skrip, simpan berkas pekerjaan dan jalankan ulang poller, bukan perintah pengiriman. Periksa respons pengiriman yang tidak pasti sebelum mencoba lagi: kehilangan respons tidak membuktikan layanan menolak pekerjaan berbayar. Skema permintaan

Aplikasi yang berguna menyimpan tiga catatan: aset sumber, pekerjaan generasi, dan keluaran yang diterima. Pengguna harus dapat membuka kembali aslinya meski menolak revisi. Desain itu lebih bernilai daripada tombol yang menyembunyikan semua tahap perantara dan menghasilkan JPEG misterius.

Instalasi lokal dimulai dari seluruh anggaran memori

Label 5.6B Klein merujuk pada transformer gambar, bukan seluruh komponen yang diperlukan. Encoder teks, autoencoder gambar, prompt upsampler, aktivasi, dan token gambar referensi juga memakai sumber daya. CLI referensi, demo, dan API Python mengaktifkan upsampler secara default; BFL meminta pengguna membiarkannya aktif kecuali caption bergaya upsampler sudah disiapkan. Karena itu ukuran berkas bobot bukan perkiraan VRAM total yang andal. Pembedaan sama penting saat menilai model bahasa lokal besar. Implementasi referensi

BFL mengiklankan jalur yang dioptimalkan untuk GPU konsumen, termasuk konfigurasi INT8 untuk kartu 8GB. Kartu model kode referensi melaporkan puncak jauh lebih besar pada konfigurasi lain. Pernyataan itu menjelaskan resep berbeda; tak satu pun merupakan minimum universal untuk setiap antarmuka, resolusi, dan jumlah referensi. Catat runtime, presisi, ukuran gambar, dan kebijakan offloading bersama angka memori. Contoh perangkat keras saat rilis, detail perangkat keras kode referensi

Daftar periksa sumber daya orisinal, bukan benchmark. Ukuran komponen dan puncak runtime berbeda menurut resep.

Di Windows dengan GPU NVIDIA yang didukung, mulailah dengan integrasi ComfyUI terkini atau runtime rekomendasi BFL. Pastikan alur FLUX 3 yang tepat, bukan templat FLUX 2 yang namanya mirip. Unduhan model berhasil tidak membuktikan node kustom, kernel terkuantisasi, dan encoder teks kompatibel.

Di Linux, repositori referensi dan panduan integrasi Diffusers menyediakan jalur pengembang. Instalasi berikut ditujukan untuk resep CUDA 13 yang didokumentasikan dan diuji penerbit pada B200, bukan kartu 8GB. Pengguna Windows membutuhkan Linux/WSL kompatibel untuk perintah Bash. Pastikan kompatibilitas driver dan anggaran memori lengkap dahulu.

1. Instal Git dan Python 3.12, lalu siapkan lingkungan terisolasi:

git clone https://github.com/black-forest-labs/flux-3-image-klein.git
cd flux-3-image-klein
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install -e . --extra-index-url https://download.pytorch.org/whl/cu130

2. Terima ketentuan checkpoint di akun Hugging Face sendiri, autentikasi dengan hf auth login, lalu unduh bundel distilled terdokumentasi. README referensi memperkirakan sekitar 52GB ruang disk untuk model, upsampler, dan pengklasifikasi keamanan; ruang disk bukan VRAM.

hf download black-forest-labs/flux-3-image-klein --local-dir weights/flux-3-image-klein --exclude 'variants/*'
hf download black-forest-labs/flux-3-image-klein-pup --local-dir weights/pup
hf download Falconsai/nsfw_image_detection --local-dir weights/nsfw-classifier

3. Jalankan satu generasi dengan prompt upsampling aktif, lalu periksa out.png dan JSON pengaturan yang menyertainya:

python scripts/cli.py "A plain ceramic mug on a pale green studio surface" --model distilled --out out.png --seed 7

4. Untuk antarmuka browser di mesin sendiri, mulai python scripts/app.py, buka http://127.0.0.1:7860, pilih Edit, lampirkan gambar sumber milik Anda, lalu masukkan satu perubahan. Layout adalah tab terpisah untuk menggambar kotak. Batasi aplikasi ke loopback; jangan aktifkan opsi berbagi publik untuk materi privat. Penyiapan dan demo referensi

Tambahkan kuantisasi atau CPU offloading hanya setelah konfigurasi dasar berfungsi. Untuk GPU 8GB, ikuti berkas dan petunjuk ComfyUI terpisah, bukan asumsi memori kode referensi penuh.

Di Mac, browser dan API tetap menjadi pilihan mudah. Jangan menyalin perintah CUDA atau angka kecepatan NVIDIA sebagai ekspektasi Apple Silicon. Jalur lokal memerlukan implementasi Metal/MPS kompatibel dan unified memory yang cukup untuk seluruh komponen; contoh pustaka generik memakai mps bukan bukti semua jalur terkuantisasi berfungsi. Mac Intel adalah kasus perangkat keras berbeda, bukan nama lain untuk Apple Silicon.

Prompt lebih panjang berguna jika mengurangi ambiguitas

Implementasi referensi memperluas instruksi singkat menjadi caption adegan lengkap sebelum generasi. Prompt upsampling adalah langkah model bahasa tersendiri, aktif secara default di CLI, demo, dan API Python referensi. README referensi terbaru juga menautkan pipeline Diffusers yang menjalankan upsampling pada tiap permintaan. Pertahankan perilaku itu, bukan menyamakan prompt pendek tanpa pengembangan. Persiapan prompt

Jika upsampler dan model gambar tidak muat bersamaan, resep referensi dapat menjalankan upsampling dahulu lalu meneruskan caption siap pakai ke generasi. Model vision-language eksternal juga dapat menyiapkan caption dengan system prompt yang dipublikasikan. Hanya caption yang telah disiapkan itulah yang boleh memakai --no-pup; flag ini bukan optimasi memori gratis untuk permintaan satu baris yang belum dikembangkan. Upsampling dan pemulihan piksel ter-host adalah fitur berbeda; mempertahankan satu tidak membuktikan runtime lain menyertakan yang lain.

Tuliskan subjek, latar, pencahayaan, dan perubahan yang diinginkan dalam bahasa biasa sebelum menambahkan sintaks khusus. "Buat terlihat profesional" membiarkan hampir semua hal tidak diputuskan. "Pertahankan mug dan gagangnya, gunakan latar polos, sisakan sepertiga sisi kanan" memberi sistem lebih sedikit sasaran yang bertentangan. Lebih banyak kata sifat tidak otomatis membuat instruksi lebih baik.

Untuk penggunaan kedua, buat serangkaian ilustrasi artikel. Pertahankan palet dan deskripsi subjek, sambil mengubah komposisi untuk header lebar dan gambar sosial persegi. Periksa konsistensi objek ant format; jangan menganggap rasio aspek yang berhasil akan berpindah sempurna ke rasio lain.

Untuk penggunaan ketiga, bandingkan mockup kemasan secara internal. Gunakan label fiktif atau materi yang disetujui dan tandai keluaran sebagai konsep. Render menarik tidak membuktikan produk dapat diproduksi, warna akurat, atau izin memakai kemiripan orang yang difoto. Tinjauan desain produksi tetap diperlukan setelah generasi.

Hitung biaya aset jadi, bukan hanya satu permintaan berhasil

Pengumuman peluncuran mencantumkan harga API mulai US$0.009 per gambar 1K, per 15 Oktober. Harga awal itu bukan jaminan untuk setiap resolusi atau alur kerja. Periksa harga BFL saat ini, tagihan akun, dan aturan permintaan sebelum menyusun anggaran kampanye.

Untuk anggaran, hitung percobaan per aset yang diterima. Jika tugas memerlukan lima revisi, satuan relevan adalah kelima percobaan ditambah waktu peninjauan dan penyelesaian. Eksekusi lokal mengganti sebagian biaya layanan dengan perangkat keras, listrik, penyimpanan, dan pemeliharaan; biaya pemeriksaan hasil tetap ada.

Bobot terbuka tidak berarti hak komersial tanpa batas. Lisensi FLUX Kommunity membedakan penggunaan nonkomersial, generasi keluaran komersial yang memenuhi syarat, dan aktivitas komersial lain. Ambang pendapatan, afiliasi, redistribusi model, dan penggunaan untuk pelatihan perlu diperiksa terpisah. Hak atas foto masukan, merek dagang, atau orang juga terpisah dari lisensi model.

Saat penyuntingan gagal, persempit sumber masalah

Pertanyaan sebelum proyek kedua

Apakah FLUX 3 Image Klein pengganti Photoshop?

Bukan. Ini model generasi dan penyuntingan dengan beberapa cara menjalankannya, bukan aplikasi produksi berbasis layer yang lengkap. Model ini dapat membantu membuat atau merevisi aset; alat seleksi, tipografi presisi, manajemen warna, pengelolaan versi, dan penyerahan hasil mungkin tetap menjadi tugas editor Anda.

Bisakah saya memakai teks Korea dan mengharapkan huruf persis?

Uji teks yang benar-benar akan dikirim pada ukuran akhir. Kartu model memperingatkan bahwa teks yang dirender bisa tidak akurat atau terdistorsi. Demo bahasa Inggris yang terbaca bukan bukti tata huruf Korea andal. Jika memungkinkan, pertahankan salinan persis sebagai teks yang dapat diedit.

Apakah inferensi lokal membuat seluruh alur kerja offline?

Hanya jika Anda sengaja mengaturnya demikian. Unduhan awal, pengembangan prompt jarak jauh, node eksternal, dan telemetri dapat menimbulkan lalu lintas jaringan. Periksa alur lengkap, bukan hanya lokasi transformer gambar.

Checkpoint mana yang sebaiknya dipilih pemula?

Mulailah dengan jalur generasi distilled terdokumentasi. Checkpoint base ditujukan untuk adaptasi dan riset. Setelah mempunyai tugas dengan hasil yang diketahui, bandingkan alternatif dengan masukan sama alih-alih mengganti model, prompt, dan resolusi sekaligus.

Terobosan yang berguna adalah revisi yang dapat dipercaya

Menurut kami, AI gambar lebih berguna saat memberi orang kendali lebih baik atas revisi, bukan sekadar galeri kejutan yang lebih besar. FLUX 3 Image Klein menarik karena referensi, tata letak, dan beberapa jalur penerapan mendekatkan kendali itu ke pekerjaan sehari-hari. Tugas yang tersisa adalah membuat gambar asli, perubahan yang diminta, dan kriteria penerimaan terlihat jelas.

Mulailah dengan satu gambar dan satu penyuntingan yang disengaja. Alur kerja yang andal menghasilkan aset yang disetujui lebih bernilai daripada model cepat yang membuat Anda menebak apa yang berubah.

Sumber dan media

Diperiksa pada 18 Oktober 2026. Kemampuan produk dan angka performa di atas berasal dari penerbit yang ditautkan; tidak ada benchmark lokal atau generasi berbayar yang diklaim. Ketiga diagram adalah ilustrasi penjelas orisinal. Lihat galeri keluaran resmi BFL dan demo interaktif resmi untuk contoh produk; gambar pihak ketiga itu tidak diterbitkan ulang di sini.

• Pengumuman BFL, 15 Oktober
• Checkpoint, batasan, dan resep lokal
• Integrasi Diffusers dan contoh alur kerja, 15 Oktober
• Skema permintaan API BFL
• Lisensi FLUX Kommunity

Buat eksperimen Anda mudah digunakan kembali

Simpan tautan sumber, prompt, pengaturan, dan catatan peninjauan bersama-sama, bukan hanya gambar akhir. Telli.sh dapat membantu mengatur catatan riset; ini bukan integrasi pembuatan gambar. Buat akun Telli.sh