Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale zvětšuje existující klip pomocí detailního vylepšení věrného zdroji nebo kreativního zpracování. Jeho dokumentovaný profil nabízí zvětšení 1.5×–3×, zachovává původní zvuk a rámování a omezuje délku zdroje, vstupní rozlišení i plochu výstupního snímku.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
FLUX Video Upscale je postup zvýšení rozlišení videa od Black Forest Labs poháněný FLUX 3. Přijímá existující klip a vrací zvětšený MP4 s původním rámováním a zvukem. Krátký volitelný popis může usměrnit vylepšené vizuální detaily. Jeho dva režimy představují smysluplnou volbu mezi blízkostí dodanému vzhledu a generováním výraznějších detailů, místo aby byl každý větší obraz považován za stejně věrnou rekonstrukci.
Vyberte přesné nebo kreativní vylepšení
Režim volí nastavení creativity. Hodnota 0 znamená přesný profil věrný zdroji: výrobce jej doporučuje, pokud si tvář, produkt nebo podklad značky musí zachovat identitu. Hodnota 1 zapíná kreativní vylepšení detailů a je výchozí. Může důrazněji obnovovat nebo vymýšlet texturu, což se hodí pro generovaný záznam, krajinu, davy nebo povrchy, jejichž detaily lze tvůrčím způsobem rozvinout.
Výrobce výslovně varuje, že kreativní vylepšení nezachovává tváře a produkty stejně přísně. Zkontrolujte rys, který musí zůstat rozpoznatelný: vzhled tváře, obrys produktu, nápis, vzor materiálu nebo logo. Vizuál vypadající ostřeji může stále obsahovat změněný nebo nově vymyšlený detail. U produktové ukázky posuzujte zamýšlený vzhled produktu, místo výběru verze pouze pro propracovanější texturu.
Volitelný prompt popisuje obsah klipu a vede vylepšení; prázdný popis žádá neutrální zvětšení. Původní zadání generované scény může určit kamennou zeď porostlou mechem, jemné denní světlo a drobnou texturu listů. Znění zaměřte na materiál, který se má zpřesnit. Požadavek výměny objektu, přestavby prostředí nebo změny dialogu patří k rozhodnutí o úpravě, zatímco tento profil zachovává původní zvukovou stopu.
Zvětšení a plocha výstupního snímku
Dokumentovaný upscale_factor sahá od 1,5 do 3 s výchozí hodnotou 2. Zvětšuje zdrojové rozlišení při zachování poměru stran. Vybraný faktor a vstupní rozměry určují zamýšlený výstup, proto je třeba plánovat široký klip i portrétní kompozici podle skutečných snímků. Před volbou užitečné míry zvětšení připravte cílovou velikost zobrazení.
Přesná specifikace omezuje každý výstupní snímek na 13,75 megapixelových jednotek výrobce. Dokumentace definuje jednu takovou jednotku jako 1 048 576 pixelů, což dává strop 14 417 920 pixelů, přibližně 14,4 milionu. Tím se vysvětluje zaokrouhlené znění 14,4 megapixelu v příručce. Velký zdroj proto může dostat menší zvětšení než požadovaný faktor. Ověřte dodané rozměry a nepředpokládejte, že požadavek 3× vždy vytvoří trojnásobek každého zdrojového rozměru.
Zveřejněný strop zdrojového rozlišení je 2560×1440. Tento postup zvětšuje způsobilý zdroj směrem ke 4K a výše; nepřijímá již větší zdroj jen proto, že je požadován vyšší výstup. Před použitím dokumentovaného profilu zdroj zmenšete nebo připravte vhodnou pracovní kopii. Původní nahrávku uchovejte odděleně, aby konečné porovnání nebylo omezeno na zmenšený mezivýsledek.
Připravte krátký, čitelný zdroj
Běžné pokyny výrobce k přípravě omezují zdroje na dvacet sekund a padesát MB. Klip se dodává pomocí URL videa nebo kódovaného MP4. Přesná reference uvádí, že zpracování pokrývá prvních dvacet sekund: malý přesah délky může být zpracován jen do této značky, zatímco výrazně delší klip je odmítnut. Číselná tolerance zveřejněna není. Ořízněte klip na zamýšlený úsek nejvýše dvaceti sekund, místo spoléhání na toto neurčené hraniční chování.
Vyberte nejméně komprimovanou dostupnou verzi. Kompresní artefakty omezují množství skutečných detailů, které může zvětšovač obnovit, a kreativní vylepšení může vytvořit věrohodnou texturu, aniž by dokládalo obsah původní scény. Před zvětšováním vybraného klipu dokončete zamýšlený střih a ořez. Původní postup může nejprve dokončit produktový záběr, vybrat užitečný interval akce a poté zvětšit tento konečný výběr, při zachování nezměněného zdroje pro porovnání.
Výsledek zachovává původní zvukovou stopu. Zkontrolujte její časování vůči obrazu, zvláště na začátku a konci vybraného segmentu. Dokumentovaný profil neposkytuje nezávislou volbu snímkové frekvence, generování nového dialogu ani ovládání úprav pomocí obrazových referencí. Jeho účelem je větší video a vybrané zpracování detailů při zachování časového a zvukového materiálu zdroje ve zpracovaném segmentu.
Uchovejte a zkontrolujte dodaný klip
Postup výrobce je asynchronní: odeslaný úkol poskytne identifikátor a adresu pro zjišťování stavu a dokončený výsledek obsahuje podepsaný odkaz pro dodání MP4. Tento odkaz vyprší přibližně po jedné hodině. Uchovejte skutečný klip, zdroj, vybraný faktor, režim kreativity a popis obsahu, místo spoléhání na dočasné umístění. Stav selhání nebo moderace odlišujte od dokončeného videa.
Jednotlivé snímky kontrolujte z hlediska tváří, označení a změn povrchů, potom sledujte sekvenci kvůli návaznosti, pohybu a zarovnání zvuku. Přesné a kreativní výstupy odpovídají různým vizuálním požadavkům; užitečným výstupem je zvětšený klip splňující zvolený cíl věrnosti při zamýšlené velikosti zobrazení. Vyšší rozlišení samo není důkazem zachování původní identity, znění nebo jemných detailů.
Ailoot Ultra · Tvorba videa POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleÚvod
FLUX Video Upscale zvětšuje existující klip pomocí detailního vylepšení věrného zdroji nebo kreativního zpracování. Jeho dokumentovaný profil nabízí zvětšení 1.5×–3×, zachovává původní zvuk a rámování a omezuje délku zdroje, vstupní rozlišení i plochu výstupního snímku.
- Přijímané vstupy
- Text · Obrázky · Zvuk · Video
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Tvorba videa POST /v1/videos
- Vstup
text,image,audio,video- Výstup
video
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity black-forest-labs/flux-video-upscale | Výchozí— |
Poleinput_references | Typarray | PožadavekPovinné | Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 1 | Výchozí— |
Poleupscale_factor | Typnumber | PožadavekPovinné | Hodnoty a limity Minimum: 1,5 Maximum: 3 | Výchozí— |
Polecreativity | Typinteger | PožadavekPovinné | Hodnoty a limity 0, 1 | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, input_references, upscale_factor, creativity |
Parametrmaterial_types | Kontrakttext, image, audio, video |
Parametrmaterial_conditions | KontraktPoužijte právě jednu skutečnou URL obsahu dokončeného videosouboru spravovaného službou včetně vráceného podpisu. Vlastník souboru, jeho typ a uložený doklad o jeho bajtech musí odpovídat požadavku. |
Životní cyklus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · skutečně vrácené id nebo polling_url
GET /v1/videos/{request_id}/content
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Účtovací jednotka | Podmínky účtování | Pixely na megapixel | Poplatek |
|---|---|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Účtovací jednotka— | Podmínky účtování— | Pixely na megapixel— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza megapixel-sekundu | Podmínky účtováníkvalita: creative | Pixely na megapixel1 048 576 | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.21 za megapixel-sekundu |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza megapixel-sekundu | Podmínky účtováníquality: precise | Pixely na megapixel1 048 576 | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.15 za megapixel-sekundu |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Účtovací jednotka— | Podmínky účtování— | Pixely na megapixel— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.15 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
Ailoot Ultra · Tvorba videa
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.
Přijímání a ukládání výsledků
Ailoot Ultra · Tvorba videa
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Uložte všechny dokončené soubory
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
Uchovejte všechny dokončené výsledky
Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.
Pokud je nutné ověřit původní odpověď
Uchovejte X-Client-Request-ID, X-Ailoot-Task-Id a skutečně vrácené id/polling_url. Pokračujte v původní úloze; požadavek na vytvoření znovu neodesílejte.
Pole odpovědi
| Pole | Typ |
|---|---|
Poleid | Typ |
Polestatus | Typ |
Poledata[] | Typ |
Poleoutputs[] | Typ |
Aliasy
Aliasy modelu
Ailoot Ultra black-forest-labs/flux-video-upscale
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · Black Forest Labs: FLUX Video Upscale
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Jaká pole požadavek používá?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Jaké limity platí?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3