Cara Menggunakan FLUX 3 API: Panduan Pembangun Lengkap

Jawapan Pantas

FLUX 3 ialah model video multimodal keluaran Black Forest Labs untuk penjanaan teks-ke-video dan imej-ke-video dengan audio terselaraskan. Di CometAPI, ID model produksi ialah flux-3. Alur kerja asinkron yang disahkan menggunakan POST /v1/videos untuk mencipta tugas, GET /v1/videos/{task_id} untuk menyemak tugas, dan GET /v1/videos/{task_id}/content untuk memuat turun MP4 siap.

Kemas kini ketersediaan (disahkan 24 September 2026): Black Forest Labs telah memindahkan FLUX 3 Video melepasi fasa Early Access bulan Julai dan menjadikan keluaran awal teks-ke-video dan imej-ke-video tersedia umum melalui BFL API dan rakan terpilih pada 4 Ogos 2026. CometAPI menambah ID model produksi flux-3 dalam format Video API pada 13 Ogos 2026. Gunakan pengumuman keluaran BFL dan halaman model CometAPI langsung sebagai sumber rujukan utama untuk ketersediaan, medan dan harga.

Apa yang Berubah Sejak FLUX 3 Early Access?

Perubahan penting ialah ketersediaan operasi. Liputan awal memfokus kepada pelancaran berasaskan permohonan pada bulan Julai, tetapi keluaran BFL pada bulan Ogos memperkenalkan endpoint video yang boleh dipanggil, kekangan yang diterbitkan dan harga produksi. CometAPI kemudiannya mendedahkan flux-3 melalui alur kerja Video API bersepadu.

Artikel terdahulu CometAPI, FLUX 3 API: Availability, Early Access, Video & Dev, kekal berguna untuk sejarah pelancaran dan penilaian awal Julai. Perbandingan yang lebih luas, Best AI Video APIs in 2026, merangkumi pemilihan di peringkat pasaran. Panduan ini mengekalkan topik-topik tersebut secara ringkas dan memberi tumpuan pada permintaan berfungsi, semakan status, prompt, kawalan kos dan pengendalian produksi.

Apakah FLUX 3?

FLUX 3 ialah keluarga model multimodal BFL untuk video, audio, imej dan ramalan berkaitan tindakan. Keluaran video semasa menyokong teks-ke-video, imej-ke-video dan kesinambungan video melalui satu endpoint natif penyedia.

Untuk pembangun video, keupayaan utama ialah sehingga 20 saat pada 24 fps, output HD atau Full HD, audio terselaraskan, pertuturan berbilang bahasa dengan lip-sync, berbilang shot dalam satu generasi, dan sehingga sepuluh keyframe pin untuk kawalan imej-ke-video.

Spesifikasi API FLUX 3

Seberapa Baik FLUX 3 Video?

BFL melaporkan skor Elo teks-ke-video 1135 dalam penilaian keutamaan manusia all-vs-all. Dalam perbandingan yang sama yang diterbitkan, FLUX 3 seri dengan Seedance 2.0 dalam keutamaan imej-ke-video dan menduduki tangga di hadapan model lain yang diuji.

Keputusan ini berguna sebagai bukti kedudukan, namun ia ialah penilaian keutamaan manusia yang dijalankan vendor, bukan penanda aras produksi bebas. Ia tidak mengukur kependaman gerbang, kebolehpercayaan baris giliran, konsistensi kos, atau kestabilan penjanaan berulang, jadi pasukan produksi masih perlu menilai set prompt mereka sendiri.

Prestasi Penanda Aras FLUX 3

Sumber: Black Forest Labs — FLUX 3 Video, Bahagian 1: Penjanaan.

Perkara yang Diperlukan Sebelum Menggunakan API FLUX 3

• Akaun CometAPI dan kunci API yang disimpan dalam pembolehubah persekitaran backend.
• Prompt yang mentakrifkan subjek, pergerakan, arah kamera, suasana, serta audio atau dialog yang diperlukan.
• Laluan pengendalian kerja yang tahan lama kerana penjanaan video adalah asinkron.
• Kredit yang mencukupi untuk ujian berulang; pengebilan bergantung pada tempoh dan resolusi yang dijana.

Cipta kunci di papan pemuka API CometAPI. Jangan letakkan dalam JavaScript frontend, bundel mudah alih, repositori awam atau tangkapan skrin.

ID Model dan Endpoint FLUX 3

Cara Menggunakan API FLUX 3 dengan CometAPI

Langkah 1: Tetapkan Kunci API Anda

Pada macOS atau Linux:

export COMETAPI_KEY="your_api_key"

Pada Windows PowerShell:

$env:COMETAPI_KEY="your_api_key"

Langkah 2: Cipta Video FLUX 3

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

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 memulakan satu tugas. Jangan mereka bentuk aplikasi untuk menerima MP4 siap dalam respons HTTP yang sama.

Langkah 3: Simpan ID Tugas

Simpan pengecam sebaik sahaja permintaan cipta berjaya:

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

Simpan ID tugas bersama rekod pengguna atau kerja sebelum semakan status bermula. Permulaan semula proses tidak sepatutnya menyebabkan kehilangan penjanaan yang telah dibilkan.

Langkah 4: Semak Status Video Secara Berkala

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

Mulakan dengan selang sederhana seperti sepuluh saat. Anggap completed, succeeded atau success sebagai status kejayaan terminal; anggap failed, failure, cancelled atau canceled sebagai kegagalan terminal.

Langkah 5: Muat Turun MP4

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

Selepas selesai, salin fail ke storan objek atau paip media anda sendiri dan jangan kekalkan URL penyedia sementara sebagai aset kekal.

Alur Kerja Python Lengkap untuk Penjanaan Video FLUX 3

Contoh berikut mencipta tugas, menyimpan ID, menyemak sehingga siap, memeriksa status kegagalan, mengesahkan tandatangan MP4, dan menulis output ke cakera.

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 Imej-ke-Video dan Keyframe

Halaman FLUX 3 CometAPI menyenaraikan imej-ke-video sebagai keupayaan yang disokong. Contoh awam semasanya menunjukkan teks-ke-video, jadi sahkan dokumentasi gerbang langsung sebelum menganggap medan imej rujukan yang disalin daripada model lain akan berfungsi tanpa perubahan.

API natif BFL adalah eksplisit: imej-ke-video menggunakan mode i2v dan medan keyframes. Satu imej memacak bingkai mula, dua imej boleh memacak permulaan dan pengakhiran, dan sehingga sepuluh imej bertiming boleh membingkaikan klip berterusan.

Contoh Keyframe Natif 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
  }'

Pastikan parameter natif penyedia dan gerbang diasingkan dalam adapter berbeza. BFL menggunakan medan seperti mode, keyframes, start_video, resolution, dan draft; sampel CometAPI yang disahkan menggunakan model, prompt, seconds, dan size.

Penjelasan Parameter API FLUX 3

Cara Menulis Prompt FLUX 3 yang Lebih Baik

Panduan prompting video BFL mengesyorkan arahan jelas untuk subjek dan aksi, kamera, adegan dan suasana, kualiti pergerakan serta kesinambungan. Untuk adegan berpandu audio, nyatakan dialog, suara, kesan bunyi dan ambien.

Struktur Prompt Praktikal

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 Natif

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 pergerakan, pembingkaian, bunyi dan kesinambungan tidak ditakrif. Arahan eksplisit menghasilkan ringkasan produksi yang lebih boleh diuji.

Harga API FLUX 3

Harga BFL adalah khusus alur kerja: render teks-ke-video dan imej-ke-video penuh berharga $0.17/s dalam HD atau $0.29/s dalam FHD, dengan Mod Draf HD pada $0.06/s. Kesinambungan video berharga $0.43/s dalam HD atau $0.54/s dalam FHD, dengan draf HD pada $0.12/s. CometAPI kini menyenaraikan flux-3 pada $0.136/s untuk 720p dan $0.232/s untuk 1080p. Sahkan harga langsung sebelum kelompok besar.

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

Cara Mengurangkan Kos Iterasi

• Prototip pada 720p sebelum memindahkan prompt terpilih ke 1080p.
• Gunakan klip lima saat untuk mengesahkan komposisi, pergerakan dan tafsiran prompt.
• Ubah satu pemboleh ubah prompt utama pada satu masa.
• Apabila menggunakan API natif BFL, uji Mod Draf sebelum render kualiti penuh.
• Simpan prompt berjaya dan keputusan rujukan dalam metadata aplikasi.

FLUX 3 vs Wan 3.0 vs Seedance 2.5

Bandingkan FLUX 3, Wan 3.0 dan Seedance 2.5 mengikut alur kerja dan bukan mencari satu pemenang universal. Pautan spesifikasi berautoriti kekal dalam pengepala jadual di bawah.

Nota harga: Harga permulaan bukan perbandingan setara dari segi kualiti atau resolusi. Gunakan jadual resolusi setiap halaman model langsung untuk perancangan bajet.

API Video Mana Patut Anda Pilih?

• Pilih FLUX 3 untuk pergerakan realistik, bunyi terselaraskan, logik multi-shot, keyframe natif atau kesinambungan.
• Pilih Wan 3.0 apabila alur kerja bermula dengan banyak jenis input dan tetingkap penjanaan 30 saat penting.
• Pilih Seedance 2.5 untuk penceritaan lebih panjang berasaskan rujukan dengan kawalan identiti, produk dan gaya yang kukuh.

Amalan Terbaik Produksi API FLUX 3

Simpan Tugas Asinkron sebagai Keadaan Berdaya Tahan

Simpan ID tugas sebaik sahaja penghantaran dibuat. Permulaan semula pelayan atau cubaan semula pekerja tidak boleh memaksa pengguna membayar untuk penjanaan lain kerana aplikasi kehilangan tugas asal.

Elakkan Polling Terlalu Rapat

Mulakan sekitar selang sepuluh saat melainkan dokumentasi langsung mencadangkan sebaliknya. Polling setiap saat menambah tekanan permintaan tanpa menambah baik pengalaman dengan ketara.

Sahkan Muat Turun

Periksa panjang kandungan dan tandatangan MP4 sebelum menandakan aset sebagai siap. Respons HTTP berjaya tidak semestinya membuktikan badan respons ialah video yang sah.

Pisahkan Skema Natif dan Gerbang

Kekalkan adapter berasingan untuk permintaan natif BFL dan CometAPI. Ini mengelakkan medan natif seperti mode, keyframes dan start_video daripada meresap ke panggilan gerbang yang menjangkakan model, prompt, seconds dan size.

Simpan Konteks Kegagalan Sepenuhnya

Log status HTTP, badan respons, ID tugas, ID model, versi prompt, saiz, durasi dan ID kerja dalaman. Pangkalkan kunci API.

Gunakan Set Penilaian Kecil Sebelum Dihantar

Bina 10–30 prompt representatif meliputi pergerakan kamera, manusia, produk, tipografi, dialog, adegan pergerakan tinggi dan nisbah aspek yang diperlukan. Jalankan set yang sama apabila versi model atau integrasi berubah, dan ulang prompt penting kerana penjanaan video adalah stokastik.

FAQ

Apakah ID model FLUX 3 di CometAPI?

ID model semasa ialah flux-3.

Endpoint CometAPI manakah yang digunakan oleh FLUX 3?

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

Adakah FLUX 3 segerak?

Tidak. Layan ia sebagai tugas asinkron: hantar, simpan ID tugas, semak status dan muat turun.

Berapa lama FLUX 3 boleh menjana?

BFL mendokumenkan 5–20 saat untuk T2V/I2V dan 5–15 saat untuk kesinambungan.

Adakah FLUX 3 menjana audio?

Ya. BFL mendokumenkan audio terselaraskan diaktifkan secara lalai dalam API natifnya.

Adakah FLUX 3 menyokong imej-ke-video?

Ya. CometAPI menyenaraikan sokongan imej-ke-video, manakala API natif BFL melaksanakannya melalui mod i2v dan keyframes.

Bolehkah saya gunakan keyframe BFL melalui CometAPI tanpa perubahan?

Jangan anggap begitu. Skema permintaan berbeza; sahkan quickstart CometAPI semasa sebelum menghantar alur kerja imej rujukan gerbang.

Berapakah kos video FLUX 3 selama lima saat di CometAPI?

Pada kadar CometAPI semasa yang disenaraikan, lima saat berharga $0.68 pada 720p atau $1.16 pada 1080p. Lihat jadual harga terkonsolidasi di atas untuk pautan rujukan langsung.

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

Ia bergantung pada alur kerja. FLUX 3 menarik untuk shot audiovisual yang koheren dari segi pergerakan dan keyframe natif atau kawalan kesinambungan; Wan 3.0 menekankan keluasan input; Seedance 2.5 menekankan penceritaan lebih panjang berasaskan rujukan.

Kesimpulan

FLUX 3 kini mempunyai laluan Video API asinkron yang berfungsi di CometAPI, manakala dokumentasi natif BFL mendedahkan kawalan lebih mendalam untuk keyframe, kesinambungan, audio dan Mod Draf.

Laluan integrasi yang selamat adalah mudah: mulakan dengan permintaan teks-ke-video 720p pendek, simpan ID tugas, semak status secara konservatif, muat turun dan sahkan MP4, kemudian tambah templat prompt, storan, logik cubaan semula dan set penilaian berulang. Kekalkan skema natif dan gerbang yang berasingan, dan sahkan halaman model langsung sebelum mengkod medannya atau harganya.