Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale memperbesar klip yang ada melalui peningkatan detail yang setia pada sumber atau kreatif. Profil yang didokumentasikan menawarkan skala 1,5×–3×, mempertahankan audio dan pembingkaian sumber, serta membatasi panjang sumber, resolusi masukan, dan luas bingkai keluaran.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
FLUX Video Upscale adalah alur kerja resolusi super video Black Forest Labs yang ditenagai FLUX 3. Alur ini menerima klip yang ada dan mengembalikan MP4 yang diperbesar, dengan pembingkaian serta audio sumber dibawa ke hasil. Deskripsi singkat opsional dapat mengarahkan detail visual yang ditingkatkan. Dua modenya memberikan pilihan bermakna antara tetap dekat dengan penampilan yang diberikan dan menghasilkan detail lebih agresif, alih-alih menganggap setiap gambar yang lebih besar sama setianya sebagai rekonstruksi.
Pilih peningkatan presisi atau kreatif
Pengaturan creativity memilih mode. Nilai 0 merupakan profil presisi yang setia pada sumber: produsen menyarankannya ketika wajah, produk, atau aset merek perlu mempertahankan identitasnya. Nilai 1 mengaktifkan peningkatan detail kreatif dan merupakan bawaan. Mode ini dapat memulihkan atau menciptakan tekstur secara lebih agresif, sehingga berguna untuk rekaman hasil generasi, pemandangan, kerumunan, atau permukaan yang detailnya dapat dikembangkan secara kreatif.
Pembuatnya secara eksplisit memperingatkan bahwa peningkatan kreatif tidak mempertahankan wajah dan produk seketat itu. Periksa ciri yang harus tetap dapat dikenali: penampilan wajah, garis bentuk produk, tulisan, pola material, atau logo. Visual yang tampak lebih tajam tetap dapat memuat detail yang berubah atau baru diciptakan. Untuk demonstrasi produk, gunakan penampilan produk yang dimaksud sebagai kriteria peninjauan, alih-alih memilih versi hanya karena teksturnya lebih rumit.
Prompt opsional menjelaskan konten klip untuk memandu peningkatan; deskripsi kosong meminta pembesaran netral. Arahan adegan hasil generasi yang orisinal dapat menyebut dinding batu berlumut, cahaya siang lembut, dan tekstur daun halus. Fokuskan susunan kata pada material yang perlu diperinci. Permintaan mengganti objek, membangun ulang latar, atau mengubah dialog merupakan keputusan penyuntingan, sedangkan profil ini mempertahankan trek audio sumber.
Skala dan luas bingkai keluaran
upscale_factor yang didokumentasikan berkisar dari 1,5 hingga 3, dengan 2 sebagai bawaan. Nilai ini memperbesar resolusi sumber sambil mempertahankan rasio aspek. Faktor pilihan dan dimensi masukan menentukan keluaran yang dimaksud, sehingga klip lanskap serta komposisi potret perlu direncanakan berdasarkan bingkai sebenarnya. Siapkan ukuran tampilan sasaran sebelum memilih besarnya pembesaran yang berguna.
Spesifikasi tepat membatasi setiap bingkai keluaran hingga 13,75 satuan megapiksel produsen. Dokumentasinya mendefinisikan satu satuan tersebut sebagai 1.048.576 piksel, sehingga batasnya 14.417.920 piksel, sekitar 14,4 juta. Ini menjelaskan ungkapan pembulatan 14,4 megapiksel dalam panduan. Karena itu, sumber besar dapat menerima pembesaran lebih kecil daripada faktor yang diminta. Periksa dimensi yang dikirim, alih-alih berasumsi bahwa permintaan 3× selalu menghasilkan tiga kali setiap dimensi sumber.
Batas resolusi sumber yang dipublikasikan adalah 2560×1440. Alur kerja ini meningkatkan sumber yang memenuhi syarat menuju 4K dan lebih tinggi; alur ini tidak menerima sumber yang sudah lebih besar hanya karena keluaran lebih tinggi diinginkan. Perkecil atau siapkan salinan kerja yang sesuai sebelum menggunakan profil yang didokumentasikan tersebut. Simpan rekaman asli secara terpisah agar perbandingan akhir tidak terbatas pada hasil antara yang sudah diubah ukurannya.
Siapkan sumber singkat yang jelas
Panduan persiapan umum pembuatnya membatasi sumber hingga dua puluh detik dan lima puluh MB. Klip diberikan melalui URL video atau MP4 terenkode. Referensi tepatnya menyatakan bahwa pemrosesan mencakup dua puluh detik pertama: sedikit kelebihan panjang dapat diproses hanya hingga batas itu, sedangkan klip yang jauh lebih panjang ditolak. Tidak ada toleransi numerik yang dipublikasikan. Pangkas menjadi segmen dua puluh detik atau lebih singkat yang dimaksud, alih-alih bergantung pada perilaku batas yang tidak ditentukan.
Pilih versi dengan kompresi paling sedikit yang tersedia. Artefak kompresi membatasi jumlah detail nyata yang dapat dipulihkan alat pembesar, dan peningkatan kreatif dapat membuat tekstur yang masuk akal tanpa membuktikan isi adegan asli. Selesaikan penyuntingan dan pemangkasan yang dimaksud sebelum memperbesar klip pilihan. Alur kerja orisinal dapat terlebih dahulu menyelesaikan shot produk, memilih interval tindakan yang berguna, lalu memperbesar pilihan akhir itu, sambil mempertahankan sumber tanpa modifikasi untuk perbandingan.
Hasil mempertahankan trek audio sumber. Periksa waktunya bersama gambar, terutama pada awal dan akhir segmen pilihan. Profil yang didokumentasikan tidak menyediakan pemilih laju bingkai independen, generasi dialog baru, atau kendali penyuntingan referensi gambar. Tujuannya adalah video lebih besar dan perlakuan detail pilihan, dengan materi temporal serta bunyi sumber tetap dipertahankan dalam segmen yang diproses.
Simpan dan periksa klip yang dikirim
Alur kerja produsen bersifat asinkron: tugas yang diajukan memberikan identitas dan lokasi status, lalu hasil lengkapnya berisi tautan pengiriman MP4 bertanda tangan. Tautan itu kedaluwarsa setelah sekitar satu jam. Simpan klip sebenarnya, sumber, faktor pilihan, mode creativity, dan deskripsi konten, alih-alih bergantung pada lokasi sementara. Bedakan status gagal atau dimoderasi dari video yang selesai.
Tinjau bingkai individual untuk wajah, penandaan, dan perubahan permukaan, lalu tonton urutan untuk kesinambungan, gerakan, dan penyelarasan audio. Keluaran presisi dan kreatif menjawab kebutuhan visual berbeda; artefak yang berguna adalah klip yang diperbesar dan memenuhi tujuan fidelitas pilihan pada ukuran tampilan yang dimaksud. Resolusi lebih besar saja bukan bukti bahwa identitas asli, susunan kata, atau detail halus tetap benar.
Ailoot Ultra · Pemrosesan video POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleMulai
FLUX Video Upscale memperbesar klip yang ada melalui peningkatan detail yang setia pada sumber atau kreatif. Profil yang didokumentasikan menawarkan skala 1,5×–3×, mempertahankan audio dan pembingkaian sumber, serta membatasi panjang sumber, resolusi masukan, dan luas bingkai keluaran.
- Masukan yang diterima
- Teks · Gambar · Audio · Video
- Hasil
- Video
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Pemrosesan video POST /v1/videos
- Masukan
text,image,audio,video- Keluaran
video
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan black-forest-labs/flux-video-upscale | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanWajib | Nilai & batasan Item minimum: 1 Item maksimum: 1 | Bawaan— |
Kolomupscale_factor | Jenisnumber | PersyaratanWajib | Nilai & batasan Minimum: 1,5 Maksimum: 3 | Bawaan— |
Kolomcreativity | Jenisinteger | PersyaratanWajib | Nilai & batasan 0, 1 | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, input_references, upscale_factor, creativity |
Parametermaterial_types | Kontraktext, image, audio, video |
Parametermaterial_conditions | KontrakGunakan tepat satu URL konten aset video aktual yang telah selesai dan dimiliki Ailoot beserta tanda tangan yang dikembalikan. Pemilik aset, tipe, dan bukti byte tersimpan harus sesuai dengan permintaan. |
Siklus hidup: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id atau polling_url aktual yang dikembalikan
GET /v1/videos/{request_id}/content
Paket
Cara menghitung biaya akhir
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Perkiraan tarif untuk perbandingan
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Satuan penagihan | Kondisi penagihan | Piksel per megapiksel | Biaya |
|---|---|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Satuan penagihan— | Kondisi penagihan— | Piksel per megapiksel— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiHarga video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper megapiksel-detik | Kondisi penagihankualitas: creative | Piksel per megapiksel1.048.576 | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.21 per megapiksel-detik |
| KonfigurasiHarga video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper megapiksel-detik | Kondisi penagihanquality: precise | Piksel per megapiksel1.048.576 | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.15 per megapiksel-detik |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Satuan penagihan— | Kondisi penagihan— | Piksel per megapiksel— | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.15 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Pemrosesan video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_UPSCALE_FACTOR:?Set the actual documented input value}"
export AILOOT_UPSCALE_FACTOR
: "${AILOOT_CREATIVITY:?Set the actual documented input value}"
export AILOOT_CREATIVITY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-upscale', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'upscale_factor': '${ACTUAL_UPSCALE_FACTOR}', 'creativity': '${ACTUAL_CREATIVITY}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['upscale_factor']=float(os.environ['AILOOT_UPSCALE_FACTOR'])
request['creativity']=int(os.environ['AILOOT_CREATIVITY'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Terima dan simpan hasil
Ailoot Ultra · Pemrosesan video
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Simpan semua aset yang selesai
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Simpan semua hasil yang selesai
Simpan setiap video yang selesai atau berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.
Jika respons asli perlu diperiksa
Simpan X-Client-Request-ID, X-Ailoot-Task-Id, dan id/polling_url aktual yang dikembalikan. Lanjutkan tugas awal; jangan kirim ulang permintaan pembuatan.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomid | Jenis |
Kolomstatus | Jenis |
Kolomdata[] | Jenis |
Kolomoutputs[] | Jenis |
Alias
Alias model
Ailoot Ultra black-forest-labs/flux-video-upscale
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Black Forest Labs: FLUX Video Upscale
- Input dan hasil apa yang tersedia?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Kolom apa yang digunakan permintaan?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Batasan apa yang berlaku?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3