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

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

FLUX.2 adalah keluarga model pembangkit dan penyunting gambar generasi kedua dari Black Forest Labs (dirilis 25 November 2025). Model ini menawarkan fotorealisme tingkat produksi, penyuntingan multi-referensi hingga 4MP, prompt terstruktur/JSON, serta pilihan titik akhir terkelola (Pro, Flex) dan opsi bobot terbuka (Dev).

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

Apa itu FLUX.2 dan mengapa itu penting?

FLUX.2 merupakan pengembangan dari keluarga model gambar FLUX — dirancang untuk menghasilkan teks ke gambar dengan fidelitas tinggi dan mengedit gambar multi-referensi pada resolusi produksi (hingga ~4 megapiksel). FLUX.2 dirancang untuk alur kerja kreatif yang nyata (aset yang aman bagi merek, karakter dan gaya yang konsisten di seluruh referensi, tipografi yang lebih baik, dan detail yang halus), alih-alih demo, dan bertujuan untuk menjembatani kesenjangan antara citra yang dihasilkan dan citra nyata.

Hasil utama FLUX.2 dirancang untuk memberikan

  • Keluaran fotorealistis yang cocok untuk periklanan, citra produk, dan tiruan UI.
  • Pengeditan multireferensi asli: menggabungkan, menukar, atau menyusun elemen dari beberapa gambar masukan dalam satu kali pengeditan.
  • Varian untuk kasus penggunaan yang berbeda: model pengembang yang tersedia secara terbuka, titik akhir Pro yang dioptimalkan untuk produksi, dan titik akhir Flex untuk kontrol tingkat rendah.

Pada tingkat tinggi, FLUX.2 menggabungkan tulang punggung generatif laten (arsitektur aliran/transformator) dengan model visi-bahasa untuk landasan semantik, dan VAE yang baru dilatih untuk menyediakan ruang laten bersama di seluruh varian. Desain ini memungkinkan model melakukan pembangkitan dan rekonstruksi (penyuntingan) dengan fidelitas yang lebih tinggi sekaligus menjaga representasi tetap dapat dipelajari untuk pelatihan dan penyempurnaan. VAE terbuka ini khususnya penting karena menstandardisasi ruang laten untuk alur kerja yang dihosting dan yang dihosting sendiri.

Mengapa hal ini penting: menggabungkan bahasa dan pencocokan alur laten menghasilkan tindak lanjut perintah yang lebih kuat (sehingga instruksi komposisi multi-bagian berperilaku lebih terprediksi), tipografi yang lebih baik, dan arsitektur tunggal yang mendukung pembuatan dan pengeditan dengan berbagai referensi. Bagi kreator, hal ini berarti keluaran yang lebih andal untuk instruksi kompleks dan masukan campuran (teks + gambar).

Bagaimana cara mengakses API FLUX.2?

Siapkan lingkungan

Daftar dan masuk ke CometAPI, lalu dapatkan kunci API Anda dari panel profil. Idealnya, Anda harus 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.

Titik akhir dan autentikasi apa saja yang diperlukan?

API Replicate Predictions 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 pembuatan gambar tingkat profesional. Pengguna dapat beralih antar model dengan mudah hanya dengan mengubah nama model di jalur URL (https://api.cometapi.com/replicate/v1/models/{models}/predictions), sehingga fleksibel untuk berbagai aplikasi kreatif dan komersial.

API Komet mengekspos titik akhir terkelola di https://api.cometapi.com/flux/v1/{model} dan memberi nama titik akhir seperti flux-2-pro, flux-2-flex, dan flux-2-flex untuk pembuatan dan pengeditan gambar. Permintaan memerlukan kunci API di x-key judul .

Keluarga model & pertukaran komputasi

  • FLUX.2 (bobot terbuka) — Gunakan saat Anda membutuhkan kontrol lokal, eksperimen riset, atau untuk menjalankan inferensi pada infrastruktur Anda sendiri. Dev berbobot terbuka (32B) dan sangat baik untuk riset eksplorasi dan penyempurnaan. Dev lebih mudah dikonfigurasi, tetapi Anda bertanggung jawab atas infrastruktur dan optimasi.
  • FLUX.2 pro — Keseimbangan terbaik antara kecepatan, kualitas, dan biaya produksi. Pro dirancang untuk latensi yang dapat diprediksi, kepatuhan perintah yang konsisten, throughput yang cepat, dan mendukung hingga 8 gambar referensi API (total 9MP melalui API). Gunakan ini untuk pengeditan volume tinggi dan ketika Anda membutuhkan keandalan dan harga yang dapat diprediksi.
  • FLUX.2 (dikelola + pengendalian) — Mengekspos kontrol pembangkitan tingkat rendah (misalnya, steps, guidance) dan mendukung lebih banyak referensi (hingga 10) serta kualitas/detail yang sedikit lebih tinggi jika Anda menerima latensi dan biaya yang lebih tinggi. Gunakan Flex saat Anda membutuhkan kendali kreatif akhir — fidelitas tipografi, warna yang tepat, atau penyesuaian komposisi yang sangat detail.

Prototipe aktif dev atau biaya rendah per rencana, lalu bermigrasi ke per untuk skala atau Melenturkan untuk hasil akhir yang terkontrol dengan baik.

Bagaimana cara menggunakan API FLUX.2?

Siklus hidup permintaan (tugas + model pemungutan suara)

Tanggapan terhadap permintaan penyuntingan/pembuatan adalah objek tugas yang mencakup a polling_url dan id; Anda membuat permintaan lalu melakukan polling (atau menggunakan webhook) untuk mengambil URL hasil yang ditandatangani. URL yang ditandatangani berumur pendek (biasanya sekitar 10 menit) sehingga segera ambil outputnya.

API yang dihosting mengikuti model tugas asinkron:

  1. POST permintaan pembangkitan → mengembalikan task id dan polling_url ditambah perkiraan cost.
  2. Jajak pendapat polling_url sampai status == "Ready", lalu mengambil hasil gambar (seringkali base64 atau URL yang dihosting).

Contoh: Python (permintaan) — kirim & jajak pendapat

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 (kirim → jajak pendapat atau webhook) adalah alur sinkron/asinkron utama untuk titik akhir yang dikelola.

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": "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 merekomendasikan maksimal ~6 tergantung pada memori).

Parameter dasar apa yang harus saya kirim?

Bidang isi permintaan yang penting (penyuntingan/pembuatan gambar) meliputi:

  • guidance dan steps — memungkinkan kontrol yang lebih rinci.
  • prompt (string) — hingga 32K token; bahasa alami terperinci atau JSON terstruktur.
  • input_image (string) — diperlukan untuk pengeditan (URL atau base64).
  • input_image_2 ... input_image_9 — gambar multi-referensi.
  • width / height — kelipatan 16; keluaran maks. 4MP.
  • seed — bilangan bulat untuk reproduktifitas.
  • safety_tolerance — tingkat moderasi.

Bagaimana saya dapat memanfaatkan FLUX.2 Pro untuk pembuatan teks menjadi gambar secara profesional?

FLUX.2 Pro dirancang untuk menghasilkan output yang andal dan berkualitas tinggi. Gunakan saat Anda membutuhkan hasil yang konsisten setara merek, penyelesaian cepat, dan SLA perusahaan.

Resep alur kerja — citra produksi

  1. Perintah praproses: Pertahankan baris "maksud" yang singkat plus bagian atribut terstruktur (pencahayaan, lensa, suasana hati, kode heksadesimal warna untuk warna merek). FLUX.2 mendukung pengarahan warna heksadesimal untuk membantu mempertahankan palet merek.
  2. Mulailah dengan default konservatif: langkah 30–50 dan skala panduan 6–9.0; tingkatkan langkah untuk mendapatkan detail, tingkatkan panduan agar hasil lebih sesuai dengan petunjuk.
  3. Gunakan benih + pengambilan sampel deterministik untuk reproduktifitas dalam pengujian A/B.
  4. Gunakan titik akhir Pro untuk pengambilan sampel multi-percobaan: meminta N variasi secara paralel dan memilih yang terbaik — lebih murah dan lebih cepat daripada penyetelan hiperparameter manual.
  5. Pasca-proses: Denoise, pemetaan nada minor, atau penyempurnaan bergaya vektor dalam alur kerja deterministik. Pertimbangkan GAN kecil atau pass resolusi super jika Anda membutuhkan keluaran yang lebih tinggi daripada keluaran asli.

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

Tips terbaik untuk menghasilkan gambar

1. Dorongan yang terstruktur menghasilkan produksi yang baik. Atur prompt berdasarkan prioritas: subjek → tindakan → gaya → konteks. Gunakan prompt JSON (adegan, subjek, kamera, pencahayaan, palet warna) jika Anda membutuhkan 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. Reproduksibilitas: Lulus seed untuk direproduksi nanti. Simpan prompt pemetaan katalog + seed → image untuk ketertelusuran.

3. Batch & orkestrasi: Untuk produksi massal, ajukan banyak permintaan secara paralel ke Pro, tetapi batasi kecepatan untuk menghindari pelambatan; pilih titik akhir Pro untuk latensi yang dapat diprediksi. Gunakan antrean pekerjaan dan kumpulan pekerja untuk mengunduh hasil yang telah ditandatangani dengan cepat setelah siap.

4. Moderasi & keamanan: penggunaan safety_tolerance untuk mengontrol keketatan moderasi. Titik akhir Pro mencakup kebijakan penggunaan dan kait moderasi konten; mengintegrasikan pemeriksaan sisi server sebelum penerbitan.

5. Pasca-pemrosesan: Hasil karya profesional berkualitas tinggi, tetapi terkadang perlu sedikit perbaikan. Bangun langkah pascaproses otomatis (pemotongan, pemeringkatan warna, komposit) dalam alur kerja Anda dan lakukan peninjauan manual untuk aset yang sensitif terhadap merek.

Bagaimana saya dapat menyesuaikan keluaran dengan titik akhir FLUX.2 Flex?

Flex adalah varian “alat bedah”: menyetel langkah, panduan, perintah negatif, ukuran petak, dan jumlah referensi untuk membentuk keluaran secara tepat.

Kapan harus memilih Flex

  • Anda memerlukan rendering tipografi yang tepat (model UI, label).
  • Anda harus menggabungkan beberapa referensi dengan kontrol atas pose dan pencahayaan.
  • Anda bereksperimen dengan teknik perintah tingkat lanjut (perintah terstruktur, rangkaian kendala).

Contoh — Tombol kontrol fleksibel dan efeknya

  • steps —lebih banyak langkah = detail lebih halus (dengan mengorbankan latensi).
  • guidance_scale — semakin tinggi = lebih dekat ke perintah teks, semakin rendah = lebih kreatif.
  • negative_prompt —menghapus elemen secara eksplisit (misalnya, “tanpa tanda air, tanpa jari tambahan”).
  • tile_size / tiled_inference — untuk pembangkitan resolusi yang sangat tinggi, petak ruang inferensi untuk menukar memori dengan kecepatan.
  • reference_weights —beberapa titik akhir memungkinkan Anda memberi bobot pada referensi bias yang menggerakkan pose vs. gaya.

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

Contoh: Permintaan fleksibel dengan langkah & panduan

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
  }'

olymp trade indonesiaTip: Gunakan Flex saat persetujuan akhir kreatif dan Pro untuk alur kerja berskala besar dan lebih cepat. Flex terasa lebih mudah dikontrol untuk tugas tipografi dan detail mikro.

Praktik terbaik untuk penggunaan produksi

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

1) Kontrol biaya dengan melacak megapiksel & caching

Penagihan FLUX.2 didasarkan pada megapiksel masukan + keluaranUntuk pembuatan volume tinggi, pilih render pratinjau yang lebih kecil (langkah cepat beresolusi rendah) dan hanya tingkatkan ke render akhir MP yang lebih tinggi. Cache aset yang dirender (atau simpan perbedaan) agar Anda tidak merender ulang pekerjaan yang identik. Selalu tampilkan cost dalam respons dan mencatatnya per permintaan.

2) Gunakan tingkatan dengan cerdas: pratinjau vs. render akhir

  • Jalankan render Pro yang cepat dan langkah rendah untuk pembuatan prototipe atau banyak varian.
  • Gunakan Flex atau proses Pro MP tinggi untuk hasil akhir yang disetujui di mana fidelitas menjadi prioritas. Pendekatan hibrida ini menyeimbangkan throughput dan kualitas gambar akhir.

3) Rekayasa prompt → prompt terstruktur & JSON

Manfaatkan FLUX.2 permintaan JSON terstruktur Ketika Anda membutuhkan komposisi deterministik (objek pemandangan, kamera, pose, contoh warna heksadesimal). Hal ini mengurangi siklus prompt iteratif dan menghasilkan batch yang lebih reproduktif. Contoh Cloudflare menunjukkan prompt JSON yang tertanam dalam formulir multi-bagian.

4) Benih + versi untuk reproduktifitas

Ketika Anda membutuhkan hasil yang dapat direproduksi, berikan seed dan catat versi/stempel waktu model dalam metadata. Untuk alur aset deterministik, simpan manifes: prompt, seed, varian model, resolusi, hash gambar referensi. Ini meningkatkan ketertelusuran dan opsi rollback.

Kesimpulan

FLUX.2 ditujukan untuk menjembatani kesenjangan antara "demo yang mengesankan" dan "alat kreatif produksi". Dengan fitur penyuntingan multi-referensi, keluaran beresolusi tinggi, dan serangkaian titik akhir yang dihosting (ditambah kode inferensi terbuka dan build konsumen terkuantisasi), FLUX.2 memberikan banyak pilihan praktis bagi tim: menjalankannya secara lokal untuk riset dan kustomisasi, atau menggunakan titik akhir Pro/Flex yang dihosting untuk alur kerja produksi yang stabil.

Pengembang dapat mengakses Flux.2 Dev APIFlux.2 Flex API dan Flux.2 Pro API melalui CometAPI. Untuk memulai, jelajahi kemampuan model CometAPI di tempat bermain dan konsultasikan  Panduan API untuk petunjuk terperinci. Sebelum mengakses, pastikan Anda telah masuk ke CometAPI dan memperoleh kunci API. cometAPI menawarkan harga yang jauh lebih rendah dari harga resmi untuk membantu Anda berintegrasi.

Siap untuk berangkat?→ Daftar ke CometAPI hari ini !

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

Baca Selengkapnya

500+ Model dalam Satu API

Diskon hingga 20%