Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale membesarkan klip sedia ada melalui penambahbaikan butiran yang setia kepada sumber atau secara kreatif. Profil yang didokumentasikan menawarkan penskalaan 1.5×–3×, mengekalkan audio dan pembingkaian sumber, serta mengehadkan panjang sumber, resolusi input dan keluasan bingkai output.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
FLUX Video Upscale ialah aliran kerja resolusi super video Black Forest Labs yang dikuasakan oleh FLUX 3. Ia menerima klip sedia ada dan memulangkan MP4 yang dibesarkan, dengan pembingkaian dan audio sumber dibawa ke dalam hasil. Penerangan ringkas pilihan boleh membimbing butiran visual yang dipertingkat. Dua modnya memberikan pilihan bermakna antara kekal hampir dengan rupa yang dibekalkan dan menjana butiran lebih agresif, bukannya menganggap setiap imej yang lebih besar sebagai pembinaan semula yang sama setianya.
Pilih penambahbaikan tepat atau kreatif
Tetapan kreativiti memilih mod. Nilai 0 ialah profil tepat yang setia kepada sumber: pengeluar mengesyorkannya apabila wajah, produk atau aset jenama perlu mengekalkan identitinya. Nilai 1 membolehkan penambahbaikan butiran kreatif dan merupakan lalai. Ia boleh memulihkan atau mereka tekstur dengan lebih agresif, yang berguna untuk rakaman janaan, pemandangan, orang ramai atau permukaan yang butirannya boleh dikembangkan secara kreatif.
Pembuat memberi amaran jelas bahawa penambahbaikan kreatif tidak mengekalkan wajah dan produk dengan ketat yang sama. Periksa ciri yang mesti terus dapat dikenal pasti: rupa wajah, garis bentuk produk, tulisan, corak bahan atau logo. Visual yang kelihatan lebih tajam masih boleh mengandungi butiran yang berubah atau baru direka. Untuk demonstrasi produk, gunakan rupa produk yang dimaksudkan sebagai kriteria semakan, bukannya memilih versi hanya kerana teksturnya lebih rumit.
Prompt pilihan menerangkan kandungan klip untuk membimbing penambahbaikan; penerangan kosong meminta pembesaran neutral. Taklimat adegan janaan asal boleh mengenal pasti dinding batu berlumut, cahaya siang lembut dan tekstur daun halus. Kekalkan susunan kata tentang bahan yang patut diperhalus. Permintaan untuk menggantikan objek, membina semula latar atau mengubah dialog ialah keputusan penyuntingan, manakala profil ini mengekalkan trek audio sumber.
Skala dan keluasan bingkai output
upscale_factor yang didokumentasikan berjulat daripada 1.5 hingga 3, dengan 2 sebagai lalai. Ia membesarkan resolusi sumber sambil mengekalkan nisbah aspek. Faktor terpilih dan dimensi input menentukan output yang dimaksudkan, jadi klip landskap dan komposisi potret perlu dirancang berdasarkan bingkai sebenar. Sediakan saiz paparan sasaran sebelum memilih jumlah pembesaran yang berguna.
Spesifikasi tepat mengehadkan setiap bingkai output kepada 13.75 unit megapiksel pengeluar. Dokumentasinya mentakrifkan satu unit tersebut sebagai 1,048,576 piksel, memberikan had 14,417,920 piksel, iaitu kira-kira 14.4 juta. Itu menjelaskan ungkapan 14.4 megapiksel yang dibundarkan dalam panduan. Oleh itu, sumber besar mungkin menerima pembesaran kurang daripada faktor yang diminta. Periksa dimensi yang dihantar, bukannya menganggap permintaan 3× sentiasa menghasilkan tiga kali setiap dimensi sumber.
Had resolusi sumber yang diterbitkan ialah 2560×1440. Aliran kerja ini meningkatkan sumber yang layak ke arah 4K dan seterusnya; ia tidak menerima sumber yang sudah lebih besar hanya kerana output lebih tinggi dikehendaki. Kecilkan atau sediakan salinan kerja yang sesuai sebelum menggunakan profil yang didokumentasikan itu. Simpan rakaman asal secara berasingan supaya perbandingan akhir tidak terhad kepada perantaraan yang telah diubah saiz.
Sediakan sumber pendek yang mudah ditafsirkan
Panduan persediaan biasa pembuat mengehadkan sumber kepada dua puluh saat dan lima puluh MB. Klip dibekalkan melalui URL video atau MP4 terenkod. Rujukan tepatnya menyatakan pemprosesan merangkumi dua puluh saat pertama: sedikit lebihan tempoh mungkin hanya diproses hingga tanda itu, manakala klip yang jauh lebih panjang ditolak. Tiada toleransi angka diterbitkan. Pangkas kepada segmen dua puluh saat atau lebih pendek yang dimaksudkan, bukannya bergantung pada tingkah laku sempadan yang tidak dinyatakan itu.
Pilih versi dengan pemampatan paling sedikit yang tersedia. Artifak pemampatan mengehadkan jumlah butiran sebenar yang boleh dipulihkan oleh pembesar, dan penambahbaikan kreatif boleh menghasilkan tekstur munasabah tanpa membuktikan kandungan adegan asal. Selesaikan suntingan dan pemangkasan yang dimaksudkan sebelum membesarkan klip terpilih. Aliran kerja asal boleh bermula dengan menyiapkan syot produk, memilih sela tindakan berguna dan kemudian membesarkan pilihan akhir itu sambil mengekalkan sumber yang tidak diubah untuk perbandingan.
Hasil mengekalkan trek audio sumber. Periksa pemasaannya dengan gambar, khususnya pada awal dan akhir segmen terpilih. Profil yang didokumentasikan tidak menyediakan pemilih kadar bingkai berasingan, penjanaan dialog baharu atau kawalan penyuntingan rujukan imej. Tujuannya ialah video lebih besar dan olahan butiran terpilih, dengan bahan masa dan bunyi sumber dikekalkan dalam segmen yang diproses.
Simpan dan periksa klip yang dihantar
Aliran kerja pengeluar adalah tak segerak: tugas yang dihantar membekalkan identiti dan lokasi status, dan hasil yang lengkap mengandungi pautan penghantaran MP4 bertandatangan. Pautan itu luput selepas kira-kira satu jam. Simpan klip sebenar, sumber, faktor terpilih, mod kreativiti dan penerangan kandungan, bukannya bergantung pada lokasi sementara. Bezakan status gagal atau disekat moderasi daripada video yang lengkap.
Semak bingkai individu untuk wajah, tanda dan perubahan permukaan, kemudian tonton urutan untuk kesinambungan, gerakan dan penjajaran audio. Output tepat dan kreatif memenuhi keperluan visual berbeza; artifak berguna ialah klip dibesarkan yang memenuhi matlamat kesetiaan terpilih pada saiz paparan yang dimaksudkan. Resolusi lebih besar sahaja bukan bukti bahawa identiti asal, perkataan atau butiran halus kekal betul.
Ailoot Ultra · Penjanaan video POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscalePengenalan
FLUX Video Upscale membesarkan klip sedia ada melalui penambahbaikan butiran yang setia kepada sumber atau secara kreatif. Profil yang didokumentasikan menawarkan penskalaan 1.5×–3×, mengekalkan audio dan pembingkaian sumber, serta mengehadkan panjang sumber, resolusi input dan keluasan bingkai output.
- Input yang diterima
- Teks · Imej · Audio · Video
- Hasil
- Video
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Penjanaan video POST /v1/videos
- Input
text,image,audio,video- Output
video
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had black-forest-labs/flux-video-upscale | Lalai— |
Medaninput_references | Jenisarray | KeperluanDiperlukan | Nilai & had Item minimum: 1 Item maksimum: 1 | Lalai— |
Medanupscale_factor | Jenisnumber | KeperluanDiperlukan | Nilai & had Minimum: 1.5 Maksimum: 3 | Lalai— |
Medancreativity | Jenisinteger | KeperluanDiperlukan | Nilai & had 0, 1 | Lalai— |
Parameter kaedah dan kitar hayat
| 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 kandungan aset video siap sebenar milik anda dengan tandatangan yang dikembalikan. Pemilik aset, jenis dan bukti bait yang disimpan mesti sepadan dengan permintaan. |
Kitar hayat: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id atau polling_url sebenar yang dikembalikan
GET /v1/videos/{request_id}/content
Pelan harga
Cara caj akhir dikira
Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Anggaran kadar untuk perbandingan
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Kuantiti ramalan | Unit pengebilan | Syarat pengebilan | Piksel setiap megapiksel | Caj |
|---|---|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Unit pengebilan— | Syarat pengebilan— | Piksel setiap megapiksel— | Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token |
| KonfigurasiHarga video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap megapiksel-saat | Syarat pengebilankualiti: creative | Piksel setiap megapiksel1,048,576 | Caj Output · Harga video · Anggaran untuk perbandingan sahaja $0.21 bagi setiap megapiksel-saat |
| KonfigurasiHarga video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap megapiksel-saat | Syarat pengebilanquality: precise | Piksel setiap megapiksel1,048,576 | Caj Output · Harga video · Anggaran untuk perbandingan sahaja $0.15 bagi setiap megapiksel-saat |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Unit pengebilan— | Syarat pengebilan— | Piksel setiap megapiksel— | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.15 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai. |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
Ailoot Ultra · Penjanaan 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 · Penjanaan 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 fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.
Simpan respons dan pengepala yang lengkap, setiap output sebenar, pengecam asal yang dikembalikan serta semua medan penggunaan. Pulihkan operasi asal tanpa menghantar permintaan penciptaan sekali lagi.
Jika respons asal perlu disemak
Simpan X-Client-Request-ID, X-Ailoot-Task-Id dan id/polling_url sebenar yang dikembalikan. Teruskan tugas asal; jangan hantar permintaan penciptaan sekali lagi.
Medan respons
| Medan | Jenis |
|---|---|
Medanid | Jenis |
Medanstatus | Jenis |
Medandata[] | Jenis |
Medanoutputs[] | Jenis |
Alias
Alias model
Ailoot Ultra black-forest-labs/flux-video-upscale
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Black Forest Labs: FLUX Video Upscale
- Apakah input dan hasil yang tersedia?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Apakah medan yang digunakan oleh permintaan?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Apakah had yang terpakai?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3