Bangun dengan CometAPIButuh satu API untuk banyak model?Uji alur kerja di Playground, lalu buat API key saat model dan biayanya sesuai dengan use case Anda.
Buat foto produk, poster, dan edit berbasis referensi dengan FLUX 3 Image, tersedia melalui CometAPI sebagai flux-3-image, dengan harga mulai $0.0384 per permintaan. Panduan ini memandu Anda memilih pengaturan gambar, menyiapkan permintaan, menangani job asinkron, dan meninjau gambar akhir. Anda memerlukan akun CometAPI, kunci API, dan konfigurasi permintaan FLUX 3 Image yang disediakan untuk akun Anda.
Poin Penting
Pilih text-to-image untuk komposisi baru dan pengeditan berpanduan referensi saat produk atau subjek harus tetap dapat dikenali.
Gunakan draf kecil untuk meninjau komposisi sebelum membelanjakan untuk gambar final yang lebih besar.
Gunakan kredensial CometAPI dan skema permintaan spesifik model; kunci dan contoh native BFL termasuk integrasi terpisah.
Perkirakan biaya dari tarif CometAPI yang berlaku, lalu ukur pengeluaran per deliverable yang diterima.
Selesaikan satu siklus pengiriman, pengambilan hasil, pengunduhan, dan tinjauan visual sebelum menjalankan batch.
Ditinjau untuk kejelasan, atribusi sumber, dan terminologi API terkini.
Apa Itu FLUX 3 Image API?
FLUX 3 Image adalah model Black Forest Labs untuk membuat dan merevisi gambar diam. Prompt teks menjelaskan adegan baru; gambar referensi menyediakan materi visual untuk dipertahankan, digabungkan, atau diubah. Bagi tim e-commerce, ini dapat berarti mengembangkan adegan produk dari sebuah brief, lalu memakai ulang foto produk yang disetujui sambil mengubah lingkungan sekitarnya.
Pilih alur kerja sebelum menulis prompt. Untuk visual baru, tentukan subjek, seting, pencahayaan, dan pembingkaian. Untuk edit, identifikasi gambar sumber, sebutkan perubahan, dan nyatakan detail mana yang harus tetap utuh. Untuk komposisi yang memakai beberapa referensi, beri peran pada masing-masing sehingga identitas produk dan gaya visual tidak saling bertentangan.
Spesifikasi FLUX 3 Image dan Parameter API
Rencanakan gambar Anda dengan pengaturan di bawah. Kontrol model mengikuti BFL FLUX 3 Image API reference; autentikasi dan perutean permintaan mengikuti integrasi CometAPI Anda. Gunakan nama field yang diterima oleh rute FLUX 3 Image CometAPI Anda.
Kapabilitas / pengaturan
Apa yang dikontrol
Cara menggunakannya dengan CometAPI
Identitas model
FLUX 3 Image; ID katalog flux-3-image
Gunakan rute spesifik model dan konvensi perutean di contoh akun Anda.
Generasi / prompt
Adegan, komposisi, atau instruksi edit
Mulai dengan satu subjek yang jelas dan satu keluaran yang diinginkan.
Gambar referensi / native images
Daftar berurut 1–10 gambar referensi, disuplai sebagai URL HTTP(S) atau base64 di API native.
Konfirmasikan nama field gateway, format input, dan batas referensi.
Aspect ratio / native aspect_ratio
Proporsi kanvas. Dengan auto, rasio yang diminta dalam prompt memiliki prioritas; jika tidak, edit mempertahankan pembingkaian referensi pertama.
Pilih rasio untuk format pengiriman dan konfirmasi nilai yang diterima.
Resolusi / native resolution
Tier native: 768sq, 1k (default), 1.5k, 2k, dan 4k. Dimensi tepat bergantung pada aspect ratio.
Untuk edit, match_input mempertahankan ukuran referensi pertama, diturunkan ke 4 MP jika lebih besar; aspect_ratio eksplisit memilih tier terdekat. Lebar dan tinggi eksplisit prioritas.
Dimensi pasti / width + height
Berikan dua bilangan bulat, masing-masing 256–6256 piksel. Ini menimpa resolution dan aspect_ratio. Luas total dibatasi 16,822,272 piksel, atau 4,194,304 piksel saat memakai referensi.
Gunakan dimensi eksplisit untuk ukuran pengiriman tetap, misalnya 1024 × 1280. Pastikan rute CometAPI Anda menerima kontrol native ini.
Kontrol tata letak
Panduan kotak pembatas untuk penempatan elemen
Gunakan sintaks tata letak yang didokumentasikan saat penempatan presisi penting.
Edit terarah
Perubahan pada subjek atau area yang dipilih
Bandingkan sumber dan hasil pada area yang seharusnya tidak berubah.
Pilih dimensi dengan salah satu dari tiga cara: tier resolution plus aspect ratio, width plus height untuk kanvas pasti, atau match_input untuk edit. Simpan referensi asli agar Anda dapat membandingkan pembingkaian dan detail setelah generasi. Endpoint native menolak field yang tidak didukung; gunakan skema untuk rute yang Anda panggil.
FLUX.2 vs FLUX 3 Image
Dimensi
FLUX 2 MAX / FLUX 2 PRO
FLUX 3 Image
Penilaian praktis
Use case
Text-to-image/editing yang kuat, varian keluarga
Komposisi gambar detail dan edit yang menjaga piksel
Bandingkan prompt merek yang sama
Resolusi
Generasi resolusi tinggi bergantung varian
2K/4K native eksplisit
Periksa detail halus pada zoom penuh
Pengeditan
Kapabilitas multi-referensi pada varian tertentu
Demonstrasi edit terlokalisasi
Ukur drift area yang tidak diedit
Biaya
Beragam menurut varian dan platform
Harga CometAPI untuk konfigurasi yang dipilih
Bandingkan per gambar yang diterima
Akses CometAPI
Tersedia melalui CometAPI sebagai FLUX 2 PRO dan FLUX 2 MAX
Tersedia melalui CometAPI sebagai flux-3-image
Validasi permintaan spesifik model sebelum mengubah perutean produksi
Evaluasi
Gunakan varian persis yang dideploy hari ini
Jalankan prompt dan set referensi yang sama
Bandingkan output yang diterima dan total biaya alur kerja
Pertahankan integrasi FLUX.2 Anda saat ini sebagai baseline perbandingan saat mengevaluasi FLUX 3 Image. Jalankan brief dan aset referensi yang sama melalui kedua alur kerja, lalu bandingkan output yang diterima, waktu penyelesaian, dan total biaya.
Bagaimana Cara Menghasilkan Gambar dengan FLUX 3 Image API di CometAPI?
1. Prasyarat
Daftar di CometAPI dan buat kunci API.
Setel variabel lingkungan:
export COMETAPI_KEY="your_cometapi_key"
2. Endpoint
POST https://api.cometapi.com/flux/v1/flux-3-image
Autentikasi menggunakan token Bearer (gaya CometAPI). Permintaan bersifat asinkron secara default.
3. Contoh dasar text-to-image (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
Lakukan polling hingga status adalah "Ready". URL gambar muncul di result.sample (unduh segera; URL bertanda tangan bersifat sementara).
Untuk menunggu sinkron dalam permintaan yang sama, tambahkan "async": false ke body (biarkan koneksi tetap terbuka; gunakan timeout klien yang longgar).
5. Contoh Python (submit + poll)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image mendukung text-to-image murni dan pengeditan/multi-referensi dalam endpoint yang sama—cukup sertakan images dan jelaskan cara menggunakannya di prompt (tidak ada field “mode” terpisah).
Alternatif: Rute kompatibel OpenAI
Anda juga dapat mencoba endpoint gambar terpadu dengan ID model:
POST https://api.cometapi.com/v1/images/generations
(Native `/flux/v1/...` lebih disukai untuk parameter FLUX 3 yang lengkap.)
### Tips
* Cek ketersediaan terkini dan harga tepat di halaman model CometAPI Flux 3 Image.
* Selalu unduh URL `result.sample` dengan cepat.
* Untuk daftar parameter terbaru atau contoh playground, lihat dokumentasi Flux CometAPI dan FLUX 3 Image reference resmi Black Forest Labs.
Ini mencerminkan alur resmi BFL sambil menggunakan autentikasi dan infrastruktur terpadu CometAPI.
## Bagaimana Cara Membuat Prompt untuk FLUX 3 Image? Contoh
### Contoh: Prompt Fotografi Produk
Gunakan prompt ini untuk uji pertama fotografi produk.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
Ganti nilai prompt di request.json dengan brief ini, tetap pertahankan body permintaan sesuai yang diharapkan rute CometAPI Anda. Kanvas 4:5 cocok untuk penempatan produk portrait. Jika rute Anda menerima kontrol dimensi native, 1024 × 1280 adalah opsi 4:5 yang presisi; berikan kedua nilai sekaligus.
Mulailah dengan draf kecil dan periksa siluet botol, label, refleksi, dan objek tambahan. Jika identitas produk yang persis penting, gunakan referensi produk alih-alih mengharapkan prompt teks saja untuk merekonstruksinya. Catat prompt dan pengaturan output sebelum melakukan perubahan.
### Contoh: Tipografi dan Tata Letak Poster
Prompt poster dengan teks judul yang ditentukan secara eksplisit.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Gunakan brief ini sebagai prompt dalam permintaan CometAPI Anda dan pilih kanvas portrait. Mulai dengan draf untuk memeriksa posisi headline dan penataan karakter, lalu tingkatkan ukuran output untuk artwork final.
Perlakukan akurasi huruf sebagai kondisi penerimaan yang terukur. Tinjau setiap huruf dan tanda baca pada output resolusi akhir; gambar galeri yang impresif tidak menjamin nol kesalahan pada teks merek spesifik Anda.
## Bagaimana Cara Mengedit Gambar dengan Referensi
Untuk edit, jelaskan perubahan yang Anda inginkan dan detail yang harus dipertahankan. FLUX 3 Image API native menerima referensi di images; petakan ke field input yang sesuai di contoh CometAPI Anda. Posisikan referensi produk terlebih dahulu dan pertahankan urutan itu dalam prompt.
### Pengeditan Satu Gambar: Ganti Latar, Pertahankan Produk
Letakkan edit.py di samping submit.py, poll.py, dan download.py. Setel PRODUCT\_IMAGE\_URL ke foto produk HTTPS yang dapat diakses publik, lalu jalankan python edit.py. Contoh di bawah memerlukan rute yang menerima array images native. Gunakan body permintaan pengeditan tanpa field gambar sumber yang bertentangan, dan ubah pemetaan jika contoh CometAPI Anda memakai field input berbeda. Untuk melanjutkan task edit yang tersimpan, jalankan python poll\_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Pilih foto produk yang tajam dengan label yang terbaca dan siluet yang jelas. Kirimkan dalam format input gambar yang diterima rute CometAPI Anda. Jika rute tersebut mendukung pengaturan resolution native, gunakan match\_input untuk mempertahankan pembingkaian dan ukuran referensi sesuai batas pengeditan model.
Galeri BFL menampilkan contoh edit terlokalisasi dengan menambahkan dua penyelam. Aset resmi sebelum-dan-sesudah ini mengilustrasikan apa yang perlu diperiksa; ini bukan output dari permintaan CometAPI yang dijalankan untuk artikel ini.
Contoh edit resmi BFL, sebelum: adegan bawah air asli dengan satu penyelam.
Contoh edit resmi BFL, sesudah: dua penyelam ditambahkan ke adegan. Periksa area latar yang tidak berubah serta subjek baru.
### Edit Referensi Multi-Gambar: Gabungkan Gaya dan Identitas Produk
Tempatkan produk pertama dan referensi pencahayaan/gaya kedua. Setel PRODUCT\_IMAGE\_URL dan STYLE\_IMAGE\_URL, simpan kode di bawah sebagai multi\_edit.py di samping tiga berkas klien, lalu jalankan python multi\_edit.py. Contoh ini memerlukan rute yang menerima setidaknya dua referensi di images. Mulai dengan body permintaan pengeditan tanpa field gambar sumber yang bertentangan. Lanjutkan job tersimpan dengan python poll\_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Lampirkan kedua referensi menggunakan format CometAPI spesifik model. Tinjau terlebih dahulu apakah identitas produk dipertahankan; lalu nilai apakah referensi kedua memberikan cahaya dan warna yang diinginkan. Jika referensi itu juga memperkenalkan objek atau huruf yang tidak diinginkan, sederhanakan referensi tersebut atau buat prompt lebih eksplisit.
## Bagaimana Menggunakan Bounding Box untuk Kontrol Tata Letak
Gunakan kotak saat botol dan headline harus menempati area yang terprediksi. Tulis caption adegan dengan ID untuk tiap elemen, kemudian tambahkan array JSON ke prompt. Format BFL menggunakan bbox dalam urutan [top, left, bottom, right] pada grid 0–1000; kotak berada di dalam prompt, bukan di field API terpisah.
Contoh di bawah mencadangkan ruang untuk headline di atas botol. Pertahankan pengaturan output portrait di request.json dan simpan berkas ini sebagai layout.py di samping submit.py. Jalankan python layout.py, lalu python poll\_download.py layout-task.json. Gunakan rute yang mendukung sintaks tata letak ini; periksa hasilnya untuk memastikan botol dan headline menempati area yang dimaksud.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
Jaga agar aspect ratio konsisten dengan tata letak. Kotak membantu penempatan, bukan memotong objek ke batas keras. Periksa ejaan dan spasi headline pada gambar yang disimpan; tambahkan huruf merek final di alat desain saat tipografi presisi sangat penting.
## Berapa Biaya FLUX 3 Image API?
CometAPI menawarkan FLUX 3 Image mulai dari $0.0384 per permintaan (9 November 2026). Gunakan tarif awal ini untuk anggaran awal, lalu terapkan tarif yang ditampilkan untuk konfigurasi Anda. Contoh di bawah mengasumsikan setiap permintaan bertarif ditagihkan dengan tarif awal.
| Permintaan ditagihkan | Tarif asumsi / permintaan | Biaya ilustratif |
| --------------------- | ------------------------- | ---------------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
Periksa tarif untuk konfigurasi dan akun Anda sebelum melakukan batch. Harga awal publik tidak menetapkan harga untuk setiap opsi resolusi atau pengeditan. Lacak upaya kreatif yang ditolak serta output yang disetujui: jika Anda menghabiskan $3.84 untuk 100 permintaan bertarif dan menyetujui 80 deliverable, biaya API per deliverable yang diterima adalah $0.048, sebelum tinjauan manusia dan penyimpanan. Ini adalah perhitungan ilustratif, bukan tingkat penerimaan terukur.
### Pilihan Resolusi menurut Alur Kerja
| Alur kerja | Uji pertama | Pemeriksaan persetujuan |
| ---------------------------- | ------------------------------------------------- | ----------------------------------------------- |
| Eksplorasi prompt | Tier terkecil yang berguna dan didukung | Komposisi dan penempatan subjek |
| Gambar produk e-commerce | Draf dengan crop yang dimaksud | Geometri produk, label, dan detail tepi |
| Karya kampanye/editorial | Draf dulu; output lebih besar setelah layout OK | Tipografi dan detail pada ukuran pengiriman |
| Edit berbasis referensi | Pengaturan yang didukung dan sesuai sumber | Area tak berubah, identitas produk, dan pencahayaan |
## Kapan Anda Harus Menggunakan FLUX 3 Video?
Gunakan FLUX 3 Image untuk aset diam seperti gambar hero produk, poster, atau frame kampanye. Jika deliverable memerlukan gerak, lihat FLUX 3 Video di CometAPI, tercantum di bawah ID model terpisah flux-3. Alur video menggunakan pengaturan dan penagihan khusus video. Pisahkan permintaan gambar dan video; durasi, audio, dan kontrol frame video tidak termasuk dalam permintaan gambar diam.
Untuk kampanye dengan kedua format, setujui komposisi gambar diam terlebih dahulu, lalu siapkan brief motion secara terpisah. Periksa persyaratan input referensi model video sebelum memakai ulang gambar yang disetujui sebagai materi sumber.
## Kesimpulan
Mulailah dengan satu brief produk dan satu job gambar kecil. Kirim melalui rute CometAPI FLUX 3 Image Anda, simpan ID task, ambil gambar yang selesai, dan tinjau hasilnya sebelum menskalakan. Gunakan width dan height saat Anda memerlukan kanvas pasti, atau match\_input untuk edit referensi jika didukung. Bandingkan total pengeluaran dengan jumlah gambar yang Anda setujui agar anggaran mencerminkan hasil yang dapat digunakan.
## Metadata SEO
Meta title: Panduan FLUX 3 Image API: Generasi, Editing & CometAPI
Meta description: Gunakan FLUX 3 Image di CometAPI untuk generasi dan editing. Pelajari parameter gambar, penanganan job asinkron, contoh prompt, dan harga mulai $0.0384 per permintaan.
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, FLUX 3 image editing, FLUX 3 pricing, reference image generation, FLUX.2 migration
URL slug: flux-3-image-api-guide
Autentikasi
Kunci API CometAPI untuk permintaan gateway
Ikuti header autentikasi di contoh CometAPI; simpan kunci di server.
Penanganan hasil
Generasi asinkron: kirim job, lacak ID task, dan ambil gambar yang selesai.
Gunakan templat Python di bawah saat rute akun Anda mengikuti kontrak task CometAPI FLUX yang didokumentasikan.
Harga
Harga CometAPI mulai $0.0384 per permintaan (9 November 2026).
Gunakan bagian harga di bawah untuk anggaran ilustratif; verifikasi konfigurasi yang dipilih.
Field tambahan
Skema native dan gateway berbeda antar generasi model
FLUX 3 Image native menerima width dan height. Jangan memakai ulang seed atau input_image dari model lama; gunakan images untuk input referensi native dan ikuti skema gateway CometAPI.
