Skip to main content
POST

Authorization

string
wajib
Semua endpoint memerlukan autentikasi Bearer TokenDapatkan API Key Anda dari Halaman Manajemen API Key:

Mode Pembuatan

flux-3-video adalah entri terpadu: mode disimpulkan dari field, atau diatur secara eksplisit dengan mode. Nilai mode: t2v / i2v / v2v / draft_enhance, atau ejaan resmi text-to-video / image-continuation / video-continuation. mode eksplisit memiliki prioritas tertinggi.

Semantik keyframe image-to-video

Urutan di image_urls bersifat semantik — jangan mengurutkan atau menghapus duplikat:

Parameter Permintaan

string
wajib
Nilai tetap: flux-3-video
string
wajib
Prompt. Tidak boleh dikirim saat menggunakan draft_from_task_id (ditolak jika ada).
integer
default:"5"
Durasi dalam detik, bilangan bulat 5~20, default 5
duration: "auto" tidak didukung (penagihan memerlukan jumlah detik tetap). Dihilangkan, "auto", atau non-integer → diperlakukan sebagai 5 detik tanpa error dan tanpa panjang adaptif.
Untuk video continuation, durasi yang dikirim mungkin lebih pendek dari yang diminta (mis. minta 5s, dapat 4s). Detik yang diminta dibebankan di muka dan selisihnya dikembalikan setelah selesai; jumlah akhir adalah cost kueri. Text/image-to-video tidak menunjukkan selisih ini.
string
default:"hd"
Resolusi
  • hd (default; juga menerima 720p)
  • fhd (juga menerima 1080p)
Diukur: hd ~1280×704 pada 16:9; fhd ~1920×1088.
Mode draft (draft:true) hanya mengizinkan hd.
string
default:"auto"
Rasio aspekOpsi: 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16, atau auto (default; dipilih otomatis dari prompt dan aset)
string[]
Keyframe image-to-video, 1~10, URL http(s) publik atau base64
string
Video input untuk continuation (mp4, URL publik atau base64)
string[]
Sama dengan video_url; menggunakan item pertama (kompatibilitas)
boolean
default:"true"
Hasilkan audio tersinkron, default true. false menghasilkan video bisu (tanpa diskon)
boolean
default:"false"
Mode draft: pratinjau kualitas rendah ~1/3 harga; hanya dengan resolution: hd
string
Draft → final: ID tugas draft Anda yang berhasil
  • Hanya resolution yang boleh berubah; prompt, durasi, gambar, video tidak boleh
  • Ditagih dengan harga final penuh; biaya draft tidak dikreditkan
  • Saling eksklusif dengan draft:true
integer
default:"2"
Toleransi moderasi 0~4, default 2 (lebih tinggi = lebih permisif)
Jangan bingungkan dengan gambar FLUX.2 (05) atau Kontext (06).
string
Mode eksplisit (opsional); lihat Mode Pembuatan

Mode Draft

Alur kerja dua langkah ketika iterasi mahal:

Buat draft

Draft ke final

Konversi draft → final merender ulang pada kualitas penuh dengan parameter draft yang disimpan (mode / prompt / seed / assets). Draft continuation difinalisasi dengan tarif final continuation.

Contoh Permintaan

Text-to-video (potret)

Image-to-video (awal + akhir)

Video continuation

Video bisu

Batasan

Error kirim umum (biasanya tidak ditagih)

Kegagalan moderasi berakhir sebagai failed dengan pengembalian dana penuh.

Cakupan Kapabilitas

Response

integer
Kode status; 200 saat berhasil
array
Array data respons
Kueri hasilPembuatan video bersifat asinkron. Poll Dapatkan Status Tugas.Interval yang disarankan 5~10 detik; timeout klien 15 menit (20s fhd lebih lambat). Diukur ~60s untuk t2v + hd + 5s.Saat berhasil gunakan result.videos[0].url; aset di-mirror ke CDN platform. cost adalah tagihan final. Kegagalan diganti penuh.