Cara Menggunakan Flux.2 API? Semua yang Perlu Anda Ketahui

CometAPI
AnnaNov 27, 2025
Cara Menggunakan Flux.2 API? Semua yang Perlu Anda Ketahui

FLUX.2 adalah keluarga model generasi kedua dari Black Forest Labs untuk pembuatan dan pengeditan gambar (dirilis 25 Nov 2025). Model ini menawarkan fotorealisme tingkat produksi, pengeditan multi-referensi hingga 4MP, prompting terstruktur/JSON, serta pilihan endpoint terkelola (Pro, Flex) dan opsi bobot terbuka (Dev).

Kabar baiknya, CometAPI telah mengintegrasikan Flux.2 API. Panduan ini menjelaskan apa itu FLUX.2, , cara memanggil API, serta alur kerja lanjutan (teks→gambar, kontrol fleksibel, pengeditan multi-referensi), disertai contoh kode dan praktik terbaik.

Apa itu FLUX.2 dan mengapa penting?

FLUX.2 adalah penerus keluarga model gambar FLUX — direkayasa untuk generasi teks-ke-gambar dengan fidelitas tinggi dan pengeditan gambar multi-referensi pada resolusi produksi (hingga ~4 megapiksel). FLUX.2 dibangun untuk alur kerja kreatif nyata (aset aman merek, karakter dan gaya yang konsisten antar referensi, tipografi dan detail kecil yang lebih baik) alih-alih sekadar demo, dan bertujuan memperkecil kesenjangan antara gambar hasil generasi dan gambar nyata.

Hasil utama yang dirancang untuk dicapai oleh FLUX.2

  • Hasil fotorealistis yang cocok untuk periklanan, gambar produk, dan mockup UI.
  • Pengeditan multi-referensi native: menggabungkan, menukar, atau menyusun elemen dari beberapa gambar masukan dalam satu proses edit.
  • Varian untuk berbagai kasus penggunaan: model pengembang yang tersedia terbuka, endpoint Pro yang dioptimalkan untuk produksi, dan endpoint Flex untuk kontrol tingkat rendah.

Pada tingkat tinggi, FLUX.2 menggabungkan backbone generatif laten (arsitektur flow/transformer) dengan model visi–bahasa untuk landasan semantik, serta VAE yang baru dilatih untuk menyediakan ruang laten bersama di seluruh varian. Desain ini memungkinkan model melakukan generasi dan rekonstruksi (pengeditan) dengan fidelitas lebih tinggi sambil menjaga representasi tetap dapat dipelajari untuk pelatihan dan fine-tuning. VAE terbuka ini patut dicatat karena menstandarkan ruang laten untuk alur kerja yang di-host maupun self-hosted.

Mengapa itu penting: penggabungan bahasa dan pencocokan aliran laten menghasilkan kepatuhan prompt yang lebih kuat (sehingga instruksi multi-bagian dan komposisional berperilaku lebih dapat diprediksi), tipografi yang lebih baik, dan satu arsitektur yang mendukung generasi sekaligus pengeditan dengan banyak referensi. Bagi kreator, ini berarti keluaran yang lebih andal untuk instruksi kompleks dan input campuran (teks + gambar).

Bagaimana cara mengakses FLUX.2 API?

Siapkan lingkungan

Daftarkan dan masuk ke CometAPI lalu dapatkan kunci API Anda dari panel profil. Idealnya, Anda memiliki pengetahuan API sebagai pengembang (kami akan memberikan bantuan dalam hal ini, jadi jangan khawatir).

Anda juga perlu memilih metode permintaan yang diinginkan dan model Flux.2 yang sesuai.

Endpoint dan autentikasi apa yang diperlukan?

Replicate Predictions API menyediakan akses untuk menghasilkan gambar berkualitas tinggi menggunakan berbagai model FLUX dari Black Forest Labs melalui format Replicate standar. API ini mendukung beragam varian model FLUX, masing-masing dioptimalkan untuk berbagai kasus penggunaan mulai dari pembuatan prototipe cepat hingga generasi gambar kelas profesional. Pengguna dapat beralih antar model dengan mulus hanya dengan mengganti nama model pada path URL(https://api.cometapi.com/replicate/v1/models/{models}/predictions), sehingga fleksibel untuk berbagai aplikasi kreatif dan komersial.

CometAPI menyediakan endpoint terkelola di bawah https://api.cometapi.com/flux/v1/{model} dan menamai endpoint seperti flux-2-pro, flux-2-flex dan flux-2-flex untuk pembuatan dan pengeditan gambar. Permintaan memerlukan kunci API pada header x-key .

Keluarga model & trade-off komputasi

  • FLUX.2 (open weights) — Gunakan saat Anda memerlukan kontrol lokal, eksperimen riset, atau menjalankan inferensi pada infrastruktur Anda sendiri. Dev adalah open-weight (32B) dan sangat baik untuk riset eksploratif serta fine-tuning. Lebih dapat dikonfigurasi, tetapi Anda bertanggung jawab atas infrastruktur dan optimisasi.
  • FLUX.2 pro — Keseimbangan terbaik antara kecepatan, kualitas, dan biaya untuk produksi. Pro disetel untuk latensi yang dapat diprediksi, kepatuhan prompt yang konsisten, throughput cepat, dan mendukung hingga 8 gambar referensi API (total 9MP melalui API). Gunakan ini untuk pengeditan volume tinggi dan saat Anda memerlukan keandalan serta harga yang dapat diprediksi.
  • FLUX.2 (managed + controllability) — Mengekspos kontrol generasi tingkat rendah (mis. steps, guidance) dan mendukung lebih banyak referensi (hingga 10) serta kualitas/detail sedikit lebih tinggi ketika Anda menerima latensi dan biaya lebih tinggi. Gunakan Flex saat Anda memerlukan kontrol kreatif akhir — fidelitas tipografi, warna yang presisi, atau penyesuaian komposisi yang sangat detail.

Buat prototipe di Dev atau paket Pro berbiaya rendah, lalu pindah ke Pro untuk skala atau Flex untuk hasil akhir yang sangat terkontrol.

Bagaimana cara menggunakan FLUX.2 API?

Siklus permintaan (model tugas + polling)

Respons terhadap permintaan pengeditan/generasi adalah objek tugas yang menyertakan polling_url dan id; Anda membuat permintaan lalu melakukan polling (atau menggunakan webhook) untuk mengambil URL hasil bertanda tangan. URL bertanda tangan berumur pendek (biasanya ~10 menit) jadi ambil output segera.

API terkelola mengikuti model tugas asinkron:

  1. POST permintaan generasi → mengembalikan task id dan polling_url plus perkiraan cost.
  2. Poll polling_url hingga status == "Ready", lalu ambil hasil gambar (sering berupa base64 atau URL yang di-host).

Contoh: Python (requests) — submit & poll

import time, requests, os

API_KEY = os.environ
API_URL = "https://api.cometapi.com/flux/v1/flux-2-pro"

payload = {
    "prompt": "A high-end product photo of a ceramic mug on a wooden desk, soft window light.",
    "width": 1024, "height": 1024, "seed": 42
}

r = requests.post(API_URL, headers={"x-key": API_KEY, "accept":"application/json"}, json=payload)
r.raise_for_status()
task = r.json()
polling_url = task

while True:
    time.sleep(0.5)
    status_r = requests.get(polling_url, headers={"x-key": API_KEY})
    status_r.raise_for_status()
    status = status_r.json()
    if status == "Ready":
        print("Result URL:", status)
        break
    elif status in ("Error", "Failed"):
        print("Generation failed:", status)
        break

Pola ini (submit → poll atau webhook) adalah alur sinkron/asinkron utama untuk endpoint terkelola.

Pengeditan Gambar — contoh minimal (curl dengan URL input)

curl -X POST "https://api.cometapi.com/flux/v1/flux-2-pro" \
  -H "accept: application/json" \
  -H "x-key: $CometAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Replace the background with a sunlit seaside boardwalk, keep the person intact and match lighting",
    "input_image": "![image](https://example.com/my-photo.jpg)",
    "width": 2048,
    "height": 1536
  }'

Untuk pengeditan multi-referensi, gunakan input_image, input_image_2, input_image_3, … (Pro mendukung hingga 8 referensi melalui API; Flex hingga 10; Dev direkomendasikan maksimum ~6 tergantung memori).

Parameter dasar apa yang harus saya kirim?

Bidang body permintaan penting (pengeditan/generasi gambar) mencakup:

  • guidance dan steps — memungkinkan kontrol yang lebih halus.
  • prompt (string) — hingga 32K token; bahasa alami rinci atau JSON terstruktur.
  • input_image (string) — wajib untuk edit (URL atau base64).
  • input_image_2 … input_image_9 — gambar multi-referensi.
  • width / height — kelipatan 16; output maks 4MP.
  • seed — integer untuk reproduktibilitas.
  • safety_tolerance — tingkat moderasi.

Bagaimana saya dapat memanfaatkan FLUX.2 Pro untuk generasi teks-ke-gambar profesional?

FLUX.2 Pro disetel untuk keluaran yang andal dan berkualitas tinggi. Gunakan saat Anda memerlukan hasil setara level merek yang konsisten, waktu penyelesaian cepat, dan SLA tingkat enterprise.

Resep alur kerja — citra produksi

  1. Pra-proses prompt: pertahankan satu baris “niat” yang singkat ditambah bagian atribut terstruktur (pencahayaan, lensa, suasana, kode warna hex untuk warna merek). FLUX.2 mendukung pengarah warna hex untuk membantu mempertahankan palet merek.
  2. Mulai dengan default konservatif: steps 30–50 dan skala guidance 6–9,0; tingkatkan steps untuk detail, tingkatkan guidance agar hasil lebih patuh pada prompt.
  3. Gunakan seed + sampling deterministik untuk reproduktibilitas dalam pengujian A/B.
  4. Gunakan endpoint Pro untuk sampling multi-coba: minta N variasi secara paralel dan pilih yang terbaik — lebih murah dan lebih cepat daripada penalaan hiperparameter manual.
  5. Pasca-proses: denoise, tone mapping ringan, atau sentuhan gaya vektor dalam pipeline deterministik. Pertimbangkan GAN kecil atau super-resolution jika Anda memerlukan keluaran di atas resolusi asli.

Mengapa langkah ini membantu: Pro menyeimbangkan kecepatan dan fidelitas serta biasanya menerapkan filter keamanan/konten pasca-generasi, sehingga menjadi default yang masuk akal untuk aset yang berhadapan dengan pelanggan.

Tips terbaik untuk menghasilkan gambar

1. Prompt terstruktur unggul untuk produksi. Susun prompt berdasarkan prioritas: subjek → aksi → gaya → konteks. Gunakan prompting JSON (scene, subjects, camera, lighting, color_palette) ketika Anda memerlukan komposisi deterministik di banyak gambar. Contoh penggunaan skema JSON (pseudo):

{
  "scene": "product shot",
  "subjects": [
    {"type":"mug","pose":"center","style":"ceramic, matte"},
    {"type":"background","style":"wooden desk, window light"}
  ],
  "camera": {"focal_length":"85mm","aperture":"f2.8","angle":"slightly above"}
}

2. Reproducibilitas: Lewatkan seed untuk reproduksi di kemudian hari. Simpan katalog yang memetakan prompt + seed → gambar untuk ketertelusuran.

3. Batch & orkestrasi: Untuk produksi skala besar, kirim banyak permintaan secara paralel ke Pro, tetapi batasi laju untuk menghindari throttling; utamakan endpoint Pro untuk latensi yang dapat diprediksi. Gunakan antrian job dan worker pool untuk mengunduh hasil bertanda tangan dengan cepat setelah siap.

4. Moderasi & keamanan: Gunakan safety_tolerance untuk mengontrol tingkat keketatan moderasi. Endpoint Pro mencakup kebijakan penggunaan dan hook moderasi konten; integrasikan pemeriksaan sisi server sebelum publikasi.

5. Pascapemrosesan: Keluaran Pro berkualitas tinggi tetapi terkadang memerlukan sentuhan kecil. Bangun langkah pascaproses otomatis (crop, color grading, komposit) dalam pipeline Anda dan pertahankan tinjauan manusia untuk aset yang sensitif terhadap merek.

Bagaimana saya dapat menyesuaikan keluaran dengan endpoint FLUX.2 Flex?

Flex adalah varian “alat bedah”: sesuaikan steps, guidance, negative prompt, ukuran tile, dan jumlah referensi untuk membentuk keluaran secara presisi.

Kapan memilih Flex

  • Anda memerlukan perenderan tipografi yang presisi (mockup UI, label).
  • Anda harus mengkomposit beberapa referensi dengan kontrol atas pose dan pencahayaan.
  • Anda sedang bereksperimen dengan teknik prompt lanjutan (prompt terstruktur, rantai kendala).

Contoh — kunci kontrol Flex dan efeknya

  • steps — lebih banyak langkah = detail lebih halus (dengan biaya latensi).
  • guidance_scale — lebih tinggi = lebih dekat ke prompt teks, lebih rendah = lebih kreatif.
  • negative_prompt — menghapus elemen secara eksplisit (mis., “tanpa watermark, tanpa jari ekstra”).
  • tile_size / tiled_inference — untuk generasi beresolusi sangat tinggi, bagi ruang inferensi menjadi tile untuk menukar memori dengan kecepatan.
  • reference_weights — beberapa endpoint memungkinkan Anda memberi bobot referensi untuk memihak gambar mana yang mengarahkan pose vs. gaya.

Tip praktis: Untuk komposisi yang kompleks, jalankan pratinjau singkat dengan guidance rendah untuk memverifikasi komposisi, lalu tingkatkan dengan lebih banyak langkah dan guidance lebih tinggi. Teknik dua lintasan ini mengurangi biaya sambil memberikan keluaran akhir yang presisi.

Contoh: Permintaan Flex dengan steps & guidance

curl -X POST "https://api.bfl.ai/v1/flux-2-flex" \
  -H "Content-Type: application/json" \
  -H "x-key: $BFL_API_KEY" \
  -d '{
    "prompt": "Cinematic movie poster, bold typography at top, main character centered, dramatic rim lighting",
    "width": 1536, "height": 2048,
    "steps": 50,
    "guidance": 7.5,
    "seed": 99999
  }'

Tip: Gunakan Flex selama persetujuan kreatif akhir dan Pro untuk pipeline berskala besar yang lebih cepat. Flex terasa jauh lebih dapat dikendalikan untuk tugas tipografi dan detail mikro.

Praktik terbaik untuk penggunaan produksi

Di bawah ini adalah pola yang telah teruji dan saran pragmatis untuk mengintegrasikan FLUX.2 dalam skala besar.

1) Kendalikan biaya dengan melacak megapiksel & caching

Penagihan FLUX.2 didasarkan pada megapiksel input + output. Untuk generasi volume tinggi, utamakan render pratinjau yang lebih kecil (langkah cepat beresolusi rendah) dan hanya naikkan ke render final MP lebih tinggi. Cache aset yang telah dirender (atau simpan diff) agar Anda tidak merender ulang job yang identik. Selalu tampilkan cost dalam respons dan catat per permintaan.

2) Gunakan tier secara cerdas: pratinjau vs pemrosesan akhir

  • Jalankan render Pro cepat dengan langkah rendah untuk pembuatan prototipe atau banyak varian.
  • Gunakan Flex atau Pro ber-MP tinggi untuk keluaran final yang disetujui di mana fidelitas penting. Pendekatan hibrida ini menyeimbangkan throughput dan kualitas gambar akhir.

3) Rekayasa prompt → prompt terstruktur & JSON

Manfaatkan prompting JSON terstruktur FLUX.2 ketika Anda memerlukan komposisi deterministik (objek adegan, kamera, pose, sampel warna hex). Ini mengurangi siklus prompting iteratif dan menghasilkan batch yang lebih dapat direproduksi. Contoh Cloudflare menunjukkan prompt JSON yang disematkan dalam formulir multipart.

4) Seed + versioning untuk reproduktibilitas

Saat Anda memerlukan hasil yang dapat direproduksi, kirimkan seed dan catat versi/timestamp model dalam metadata. Untuk pipeline aset deterministik, simpan sebuah manifest: prompt, seed, varian model, resolusi, hash gambar referensi. Ini meningkatkan ketertelusuran dan opsi rollback.

Kesimpulan

FLUX.2 secara tepat ditujukan untuk menutup kesenjangan antara “demo yang mengesankan” dan “alat kreatif produksi.” Dengan pengeditan multi-referensi, keluaran beresolusi tinggi, dan serangkaian endpoint terkelola (plus kode inferensi terbuka dan build konsumen terkuantisasi), ini memberi tim banyak opsi praktis: menjalankan secara lokal untuk riset dan kustomisasi, atau menggunakan endpoint Pro/Flex terkelola untuk pipeline produksi yang stabil.

Pengembang dapat mengakses Flux.2 Dev API, Flux.2 Flex API dan Flux.2 Pro API melalui CometAPI. Untuk memulai, jelajahi kapabilitas model CometAPI di Playground dan lihat  panduan API untuk petunjuk terperinci. Sebelum mengakses, pastikan Anda telah masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga yang jauh lebih rendah daripada harga resmi untuk membantu Anda melakukan integrasi.

Siap mulai?→ Daftar CometAPI hari ini !

Jika Anda ingin mengetahui lebih banyak tips, panduan, dan berita tentang AI, ikuti kami di VK, X dan Discord!

Siap memangkas biaya pengembangan AI hingga 20%?

Mulai gratis dalam beberapa menit. Kredit uji coba gratis disertakan. Tidak perlu kartu kredit.

Baca Selengkapnya