Cara Menggunakan FLUX 3 API: Panduan Lengkap untuk Pengembang

Jawaban Singkat

FLUX 3 adalah model video multimodal dari Black Forest Labs untuk generasi teks-ke-video dan gambar-ke-video dengan audio tersinkronisasi. Di CometAPI, ID model produksi adalah flux-3. Alur kerja asinkron terverifikasi menggunakan POST /v1/videos untuk membuat tugas, GET /v1/videos/{task_id} untuk melakukan polling, dan GET /v1/videos/{task_id}/content untuk mengunduh MP4 yang sudah selesai.

Pembaruan ketersediaan (terverifikasi 24 September 2026): Black Forest Labs memindahkan FLUX 3 Video melampaui fase Early Access bulan Juli dan merilis versi awal teks-ke-video serta gambar-ke-video untuk ketersediaan umum melalui BFL API dan mitra terpilih pada 4 Agustus 2026. CometAPI menambahkan ID model produksi flux-3 dalam format Video API pada 13 Agustus 2026. Gunakan pengumuman rilis BFL dan halaman model CometAPI yang live sebagai sumber kebenaran untuk ketersediaan, field, dan harga.

Apa yang Berubah Sejak FLUX 3 Early Access?

Perubahan penting adalah ketersediaan operasional. Liputan awal berfokus pada peluncuran berbasis aplikasi bulan Juli, tetapi rilis BFL di bulan Agustus menghadirkan endpoint video yang dapat dipanggil, batasan yang diterbitkan, dan harga produksi. CometAPI kemudian mengekspos flux-3 melalui alur kerja Video API terpadu.

Artikel CometAPI sebelumnya, FLUX 3 API: Availability, Early Access, Video & Dev, tetap berguna untuk sejarah peluncuran dan evaluasi awal bulan Juli. Perbandingan Best AI Video APIs in 2026 yang lebih luas mencakup seleksi tingkat pasar. Panduan ini merangkum topik tersebut dan berfokus pada permintaan kerja, polling, prompt, kontrol biaya, dan penanganan produksi.

Apa itu FLUX 3?

FLUX 3 adalah keluarga model multimodal dari BFL untuk video, audio, gambar, dan prediksi terkait aksi. Rilis video saat ini mendukung teks-ke-video, gambar-ke-video, dan kelanjutan video melalui satu endpoint native penyedia.

Untuk pengembang video, kemampuan utama adalah hingga 20 detik pada 24 fps, output HD atau Full HD, audio tersinkronisasi, ucapan multibahasa dengan lip-sync, beberapa shot dalam satu generasi, dan hingga sepuluh keyframe yang dipin untuk kontrol gambar-ke-video.

Spesifikasi API FLUX 3

Seberapa Bagus FLUX 3 Video?

BFL melaporkan skor Elo teks-ke-video sebesar 1135 dalam evaluasi preferensi manusia all-vs-all. Dalam perbandingan yang sama yang dipublikasikan, FLUX 3 seri dengan Seedance 2.0 dalam preferensi gambar-ke-video dan memeringkat di depan model lain yang diuji.

Hasil ini berguna sebagai bukti pemposisian, tetapi ini adalah evaluasi preferensi manusia yang dijalankan vendor, bukan tolok ukur produksi independen. Mereka tidak mengukur latensi gateway, keandalan antrean, konsistensi biaya, atau stabilitas generasi berulang, jadi tim produksi tetap harus mengevaluasi set prompt mereka sendiri.

Performa Benchmark FLUX 3

Sumber: Black Forest Labs — FLUX 3 Video, Bagian 1: Generasi.

Yang Anda Butuhkan Sebelum Menggunakan FLUX 3 API

• Akun CometAPI dan kunci API yang disimpan di variabel lingkungan backend.
• Prompt yang mendefinisikan subjek, gerakan, arah kamera, suasana, dan audio atau dialog yang diperlukan.
• Jalur penanganan job yang tahan lama karena generasi video bersifat asinkron.
• Kredit yang cukup untuk pengujian iteratif; penagihan bergantung pada durasi dan resolusi yang dihasilkan.

Buat kunci di dasbor API CometAPI. Jangan menempatkannya di JavaScript frontend, bundel mobile, repositori publik, atau tangkapan layar.

ID Model dan Endpoint FLUX 3

Cara Menggunakan FLUX 3 API dengan CometAPI

Langkah 1: Setel Kunci API Anda

Di macOS atau Linux:

export COMETAPI_KEY="your_api_key"

Di Windows PowerShell:

$env:COMETAPI_KEY="your_api_key"

Langkah 2: Buat Video FLUX 3

Quickstart FLUX 3 saat ini menggunakan permintaan multipart dengan model, prompt, seconds, dan size. Contoh ini meminta klip 720p berdurasi lima detik:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=flux-3" \
  -F "prompt=A paper boat glides across a still pond in soft morning light" \
  -F "seconds=5" \
  -F "size=1280x720"

Permintaan ini memulai job. Jangan merancang aplikasi untuk menerima MP4 yang selesai dalam respons HTTP yang sama.

Langkah 3: Simpan Task ID

Persistenkan pengenal segera setelah permintaan pembuatan berhasil:

{
  "id": "video_task_id",
  "status": "queued"
}

Simpan task ID di samping catatan pengguna atau job sebelum polling dimulai. Restart proses tidak boleh membuat generasi yang sudah ditagih hilang.

Langkah 4: Polling Status Video

curl https://api.cometapi.com/v1/videos/{task_id} \
  -H "Authorization: Bearer $COMETAPI_KEY"

Mulailah dengan interval moderat seperti sepuluh detik. Perlakukan completed, succeeded, atau success sebagai status keberhasilan terminal; perlakukan failed, failure, cancelled, atau canceled sebagai kegagalan terminal.

Langkah 5: Unduh MP4

curl https://api.cometapi.com/v1/videos/{task_id}/content \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output flux3_output.mp4

Setelah selesai, salin file ke penyimpanan objek atau pipeline media Anda sendiri alih-alih menyimpan URL penyedia sementara sebagai aset permanen.

Alur Kerja Python Lengkap untuk Generasi Video FLUX 3

Contoh berikut membuat job, menyimpan ID-nya, melakukan polling hingga selesai, memeriksa status kegagalan, memvalidasi signature MP4, dan menulis output ke disk.

import os
import time
from pathlib import Path

import requests

api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files={
        "model": (None, "flux-3"),
        "prompt": (
            None,
            "A product bottle rotates slowly on wet black stone, "
            "soft rim lighting, macro lens, realistic reflections.",
        ),
        "seconds": (None, "5"),
        "size": (None, "1280x720"),
    },
    timeout=120,
)
response.raise_for_status()

task = response.json()
data = task.get("data") or {}
task_id = (
    task.get("id")
    or task.get("task_id")
    or data.get("id")
    or data.get("task_id")
)
if not task_id:
    raise RuntimeError(f"Create response has no task ID: {task}")

while True:
    response = requests.get(
        f"{base_url}/v1/videos/{task_id}",
        headers=headers,
        timeout=60,
    )
    response.raise_for_status()
    task = response.json()
    data = task.get("data") or {}
    status = str(task.get("status") or data.get("status") or "").lower()
    progress = task.get("progress") or data.get("progress") or "unknown"
    print(f"Status: {status or 'unknown'}; progress: {progress}")

    if status in {"failed", "failure", "cancelled", "canceled"}:
        raise RuntimeError(f"Video generation failed: {task}")
    if status in {"completed", "succeeded", "success"} or progress == "100%":
        break
    time.sleep(10)

response = requests.get(
    f"{base_url}/v1/videos/{task_id}/content",
    headers=headers,
    timeout=300,
)
response.raise_for_status()
video = response.content

if len(video) < 12 or video[4:8] != b"ftyp":
    raise RuntimeError("Content response is not a non-empty MP4 file")

output_dir = Path("output")
output_dir.mkdir(parents=True, exist_ok=True)
output_path = output_dir / f"{task_id}.mp4"
output_path.write_bytes(video)
print(f"Saved: {output_path} ({len(video)} bytes)")

Cara Menggunakan Gambar-ke-Video dan Keyframe

Halaman FLUX 3 di CometAPI mencantumkan gambar-ke-video sebagai kemampuan yang didukung. Sampel publik saat ini menunjukkan teks-ke-video, jadi verifikasi dokumentasi gateway yang live sebelum mengasumsikan field referensi-gambar yang disalin dari model lain akan berfungsi tanpa perubahan.

API native BFL eksplisit: gambar-ke-video menggunakan mode i2v dan field keyframes. Satu gambar mem-pin frame awal, dua gambar dapat mem-pin awal dan akhir, dan hingga sepuluh gambar bertiming dapat membuat storyboard klip berkelanjutan.

Contoh Keyframe Native BFL

curl -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v",
    "prompt": "They sprint through the lantern-lit alley as the camera tracks behind them.",
    "keyframes": [
      [0, "data:image/png;base64,<first-frame>"],
      [8, "data:image/png;base64,<last-frame>"]
    ],
    "duration": 8
  }'

Pisahkan parameter native penyedia dan gateway dalam adapter terpisah. BFL menggunakan field seperti mode, keyframes, start_video, resolution, dan draft; sampel terverifikasi CometAPI menggunakan model, prompt, seconds, dan size.

Penjelasan Parameter FLUX 3 API

Cara Menulis Prompt FLUX 3 yang Lebih Baik

Panduan prompting video BFL merekomendasikan arahan yang jelas untuk subjek dan aksi, kamera, adegan dan suasana, kualitas gerak, dan kontinuitas. Untuk adegan yang dipimpin audio, tentukan dialog, suara, efek suara, dan ambience.

Struktur Prompt Praktis

Subject + Environment + Action + Camera + Lighting
+ Dialogue/Voice + Sound Effects + Ambience + Constraints

Prompt Sinematik

A lone cyclist rides through a rain-soaked neon street at midnight.
The camera begins low beside the rear wheel, then rises into a smooth tracking shot.
Reflections stretch across wet asphalt under moving cyan and magenta light.
Audio: steady rainfall, chain noise, distant traffic, no music, no dialogue.
Keep the same rider, bicycle, jacket, and weather throughout the shot.

Prompt Video Produk

A premium stainless-steel espresso machine stands on a dark stone counter.
Begin with a macro close-up of water droplets on the metal housing.
Orbit clockwise as the machine brews; steam catches warm side light.
Finish on a clean three-quarter hero angle with the cup in the foreground.
Audio: pump vibration, steam hiss, ceramic contact, quiet cafe ambience.
Do not change the product shape, logo placement, material, or color.

Prompt Dialog dan Audio Native

A young chef works alone in a compact Tokyo ramen shop at night.
Start close on boiling broth, then pull back as the chef sets down a bowl.
Warm tungsten lighting, natural reflections, documentary handheld motion.
The chef quietly says in Japanese: 「お待たせしました。」
Audio: bubbling broth, soft rain outside, distant street traffic.
No subtitles and no background music.

Prompt seperti “make a cinematic ramen shop video” membiarkan gerak, framing, suara, dan kontinuitas tidak ditentukan. Arahan yang eksplisit menghasilkan brief produksi yang lebih dapat diuji.

Harga FLUX 3 API

Harga BFL spesifik alur kerja: render penuh teks-ke-video dan gambar-ke-video dikenakan biaya $0.17/d di HD atau $0.29/d di FHD, dengan Draft Mode HD seharga $0.06/d. Kelanjutan video dikenakan biaya $0.43/d di HD atau $0.54/d di FHD, dengan draft HD seharga $0.12/d. CometAPI saat ini mencantumkan flux-3 pada $0.136/d untuk 720p dan $0.232/d untuk 1080p. Verifikasi harga live sebelum batch besar.

Catatan membaca dua kolom terakhir: nilai ditampilkan sebagai HD/720p terlebih dahulu dan FHD/1080p kedua.

Cara Mengurangi Biaya Iterasi

• Prototipe di 720p sebelum memindahkan prompt terpilih ke 1080p.
• Gunakan klip lima detik untuk memvalidasi komposisi, gerak, dan interpretasi prompt.
• Ubah satu variabel besar prompt pada satu waktu.
• Saat menggunakan API native BFL, uji Draft Mode sebelum render kualitas penuh.
• Simpan prompt yang berhasil dan keputusan referensi dalam metadata aplikasi.

FLUX 3 vs Wan 3.0 vs Seedance 2.5

Bandingkan FLUX 3, Wan 3.0, dan Seedance 2.5 berdasarkan alur kerja daripada mencari satu pemenang universal. Tautan spesifikasi otoritatif tetap ada di header tabel di bawah.

Catatan harga: Harga awal bukan perbandingan apel-dengan-apel untuk kualitas atau resolusi. Gunakan tabel resolusi spesifik di setiap halaman model live untuk penganggaran.

API Video Mana yang Harus Anda Pilih?

• Pilih FLUX 3 untuk gerak realistis, suara tersinkron, logika multi-shot, keyframe native, atau kelanjutan.
• Pilih Wan 3.0 ketika alur kerja dimulai dengan banyak jenis input dan jendela generasi 30 detik penting.
• Pilih Seedance 2.5 untuk penceritaan yang lebih panjang dan kaya referensi dengan kontrol identitas, produk, dan gaya yang kuat.

Praktik Terbaik Produksi FLUX 3 API

Persistenkan Job Asinkron sebagai State yang Tahan Lama

Simpan task ID segera setelah pengiriman. Restart server atau retry worker tidak boleh memaksa pengguna membayar generasi lain karena aplikasi kehilangan tugas asli.

Hindari Polling Ketat

Mulailah di sekitar interval sepuluh detik kecuali dokumentasi live merekomendasikan sebaliknya. Polling setiap detik menambah tekanan permintaan tanpa secara material meningkatkan pengalaman.

Validasi Unduhan

Periksa panjang konten dan signature MP4 sebelum menandai aset selesai. Respons HTTP yang berhasil tidak selalu membuktikan bahwa body adalah video yang valid.

Pisahkan Skema Native dan Gateway

Pertahankan adapter terpisah untuk permintaan native BFL dan CometAPI. Ini mencegah field native seperti mode, keyframes, dan start_video bocor ke panggilan gateway yang mengharapkan model, prompt, seconds, dan size.

Simpan Konteks Kegagalan Secara Lengkap

Log status HTTP, body respons, task ID, ID model, versi prompt, size, durasi, dan ID job internal. Redaksi kunci API.

Gunakan Set Evaluasi Kecil Sebelum Rilis

Bangun 10–30 prompt representatif yang mencakup gerak kamera, orang, produk, tipografi, dialog, adegan bergerak tinggi, dan rasio aspek yang diperlukan. Jalankan set yang sama saat versi model atau integrasi berubah, dan ulangi prompt penting karena generasi video bersifat stokastik.

FAQ

Apa ID model FLUX 3 di CometAPI?

ID model saat ini adalah flux-3.

Endpoint CometAPI mana yang digunakan FLUX 3?

Alur kerja Video API terverifikasi menggunakan POST /v1/videos, diikuti oleh GET /v1/videos/{task_id} dan GET /v1/videos/{task_id}/content.

Apakah FLUX 3 sinkron?

Tidak. Perlakukan sebagai job asinkron: kirim, persist task ID, polling, dan unduh.

Berapa lama FLUX 3 dapat menghasilkan?

BFL mendokumentasikan 5–20 detik untuk T2V/I2V dan 5–15 detik untuk kelanjutan.

Apakah FLUX 3 menghasilkan audio?

Ya. BFL mendokumentasikan audio tersinkronisasi aktif secara default dalam API native-nya.

Apakah FLUX 3 mendukung gambar-ke-video?

Ya. CometAPI mencantumkan dukungan gambar-ke-video, sementara API native BFL mengimplementasikannya melalui mode i2v dan keyframes.

Bisakah saya menggunakan keyframe BFL melalui CometAPI tanpa perubahan?

Jangan berasumsi demikian. Skema permintaan berbeda; verifikasi quickstart CometAPI saat ini sebelum mengirimkan alur kerja referensi-gambar gateway.

Berapa biaya video FLUX 3 berdurasi lima detik di CometAPI?

Pada tarif CometAPI yang saat ini tercantum, lima detik berharga $0.68 di 720p atau $1.16 di 1080p. Lihat tabel harga konsolidasi di atas untuk tautan referensi live.

Apakah FLUX 3 lebih baik daripada Wan 3.0 atau Seedance 2.5?

Tergantung alur kerja. FLUX 3 menarik untuk shot audiovisual dengan koherensi gerak dan kontrol keyframe atau kelanjutan native BFL; Wan 3.0 menekankan lebar input; Seedance 2.5 menekankan penceritaan lebih panjang yang kaya referensi.

Kesimpulan

FLUX 3 kini memiliki jalur Video API asinkron yang berfungsi di CometAPI, sementara dokumentasi native BFL menampilkan kontrol yang lebih dalam untuk keyframe, kelanjutan, audio, dan Draft Mode.

Jalur integrasi yang aman sederhana: mulai dengan permintaan teks-ke-video 720p pendek, persistenkan task ID, polling secara konservatif, unduh dan validasi MP4, lalu tambahkan templat prompt, penyimpanan, logika retry, dan set evaluasi yang dapat diulang. Pisahkan skema native dan gateway, dan verifikasi halaman model yang live sebelum meng-hard-code field atau harga.