Black Forest Labs: FLUX Video Upscale

FLUX Video Upscale zväčšuje existujúci klip pomocou vylepšenia detailov verného zdroju alebo tvorivého vylepšenia. Dokumentovaný profil ponúka zväčšenie 1.5×–3×, zachováva zdrojový zvuk a záber a obmedzuje dĺžku zdroja, vstupné rozlíšenie a plochu výstupnej snímky.

Ailoot Ultra · Generovanie videa POST /v1/videos black-forest-labs/flux-video-upscale

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

FLUX Video Upscale je postup superrozlíšenia videa od Black Forest Labs využívajúci FLUX 3. Prijíma existujúci klip a vracia zväčšené MP4 so zdrojovým záberom a zvukom prenesenými do výsledku. Krátky voliteľný opis môže usmerniť vylepšené vizuálne detaily. Dva režimy predstavujú zmysluplnú voľbu medzi blízkosťou k dodanému vzhľadu a agresívnejším generovaním detailov namiesto považovania každého väčšieho obrazu za rovnako vernú rekonštrukciu.

Vyberte presné alebo tvorivé vylepšenie

Režim vyberá nastavenie creativity. Hodnota 0 predstavuje presný profil verný zdroju: výrobca ho odporúča, keď si tvár, produkt alebo značkový materiál musia zachovať identitu. Hodnota 1 zapína tvorivé vylepšenie detailov a je predvolená. Môže agresívnejšie obnovovať alebo vymýšľať textúru, čo je užitočné pre generované zábery, krajinu, davy alebo povrchy, ktorých detaily možno tvorivo rozvíjať.

Výrobca výslovne upozorňuje, že tvorivé vylepšenie nezachováva tváre a produkty tak striktne. Skontrolujte vlastnosť, ktorá musí zostať identifikovateľná: vzhľad tváre, obrys produktu, písmo, vzor materiálu alebo logo. Vizuál pôsobiaci ostrejšie stále môže obsahovať zmenený alebo novo vymyslený detail. Pri produktovej ukážke použite ako kritérium kontroly zamýšľaný vzhľad produktu namiesto výberu verzie len pre prepracovanejšiu textúru.

Voliteľný prompt opisuje obsah klipu na usmernenie vylepšenia; prázdny opis žiada neutrálne zväčšenie. Pôvodné zadanie generovanej scény môže identifikovať machom pokrytú kamennú stenu, jemné denné svetlo a jemnú textúru listov. Znenie sústreďte na materiál, ktorý sa má zdokonaliť. Požiadavka nahradiť predmet, prestavať prostredie alebo zmeniť dialóg patrí k rozhodnutiu o úprave, kým tento profil zachováva zdrojovú zvukovú stopu.

Mierka a plocha výstupnej snímky

Dokumentovaný upscale_factor má rozsah 1.5 až 3 s predvolenou hodnotou 2. Zväčšuje zdrojové rozlíšenie pri zachovaní pomeru strán. Zvolený faktor a vstupné rozmery určujú zamýšľaný výstup, preto treba širokouhlý klip aj zvislú kompozíciu plánovať podľa skutočných snímok. Pred výberom užitočnej miery zväčšenia pripravte cieľovú veľkosť zobrazenia.

Presná špecifikácia obmedzuje každú výstupnú snímku na 13.75 megapixelových jednotiek výrobcu. Dokumentácia definuje jednu takú jednotku ako 1 048 576 pixelov, čo dáva strop 14 417 920 pixelov, približne 14.4 milióna. To vysvetľuje zaokrúhlené znenie 14.4 megapixela v príručke. Veľký zdroj preto môže dostať menšie zväčšenie než požadovaný faktor. Skontrolujte dodané rozmery a nepredpokladajte, že požiadavka 3× vždy vytvorí trojnásobok každého zdrojového rozmeru.

Publikovaný strop zdrojového rozlíšenia je 2560×1440. Tento postup zväčšuje zdroj spĺňajúci vstupné podmienky smerom k 4K a vyššie; neprijíma už väčší zdroj len preto, že sa požaduje vyšší výstup. Pred použitím dokumentovaného profilu zmenšite zdroj alebo pripravte vhodnú pracovnú kópiu. Pôvodnú nahrávku uchovajte oddelene, aby konečné porovnanie nebolo obmedzené na zmenšený medzivýsledok.

Pripravte krátky, čitateľný zdroj

Bežné prípravné odporúčania výrobcu obmedzujú zdroje na dvadsať sekúnd a päťdesiat MB. Klip sa dodáva cez URL videa alebo kódované MP4. Presná referencia uvádza, že spracovanie pokrýva prvých dvadsať sekúnd: malé prekročenie dĺžky možno spracovať len po túto hranicu, kým podstatne dlhší klip sa odmieta. Číselná tolerancia nie je publikovaná. Orežte klip na zamýšľaný segment s dĺžkou najviac dvadsať sekúnd a nespoliehajte sa na toto neurčené hraničné správanie.

Vyberte najmenej komprimovanú dostupnú verziu. Kompresné artefakty obmedzujú množstvo skutočných detailov, ktoré zväčšovač dokáže obnoviť, a tvorivé vylepšenie môže vytvoriť vierohodnú textúru bez potvrdenia obsahu pôvodnej scény. Pred zväčšením vybraného klipu dokončite zamýšľanú úpravu a orezanie. Pôvodný postup môže najprv dokončiť produktový záber, vybrať užitočný interval akcie a potom zväčšiť tento konečný výber pri zachovaní neupraveného zdroja na porovnanie.

Výsledok zachováva zdrojovú zvukovú stopu. Skontrolujte jej časovanie s obrazom, najmä na začiatku a konci vybraného segmentu. Dokumentovaný profil neposkytuje nezávislý výber snímkovej frekvencie, generovanie nového dialógu ani ovládanie úpravy podľa obrazovej referencie. Jeho účelom je väčšie video a zvolené spracovanie detailov so zachovaním časového a zvukového materiálu zdroja v spracovanom segmente.

Uchovajte a skontrolujte dodaný klip

Postup výrobcu je asynchrónny: odoslaná úloha poskytne identitu a adresu stavu a dokončený výsledok obsahuje podpísaný odkaz na dodanie MP4. Tento odkaz vyprší približne po jednej hodine. Uchovajte skutočný klip, zdroj, zvolený faktor, režim tvorivosti a opis obsahu namiesto spoliehania sa na dočasnú adresu. Neúspešný alebo moderovaný stav odlišujte od dokončeného videa.

Jednotlivé snímky skontrolujte z hľadiska tvárí, označení a zmien povrchov, potom sledujte postupnosť z hľadiska kontinuity, pohybu a zarovnania zvuku. Presný a tvorivý výstup spĺňajú odlišné vizuálne požiadavky; užitočným výsledkom je zväčšený klip spĺňajúci zvolený cieľ vernosti pri zamýšľanej veľkosti zobrazenia. Samotné väčšie rozlíšenie nie je dôkazom zachovania správnej pôvodnej identity, znenia alebo jemných detailov.

Ailoot Ultra · Generovanie videa POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

Black Forest Labs /black-forest-labs/flux-video-upscale

Úvod

Povolené vstupy: Text · Obrázky · Audio · Video
Výsledky: Video

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Generovanie videa POST /v1/videos

Vstup: text, image, audio, video
Výstup: video

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity black-forest-labs/flux-video-upscale	Predvolené—
Pole`input_references`	Typ`array`	PožiadavkaPovinné	Hodnoty a limity Minimálny počet položiek: 1 Maximálny počet položiek: 1	Predvolené—
Pole`upscale_factor`	Typ`number`	PožiadavkaPovinné	Hodnoty a limity Minimum: 1,5 Maximum: 3	Predvolené—
Pole`creativity`	Typ`integer`	PožiadavkaPovinné	Hodnoty a limity 0, 1	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, input_references, upscale_factor, creativity
Parameter`material_types`	Špecifikáciatext, image, audio, video
Parameter`material_conditions`	ŠpecifikáciaPoužite presne jednu skutočnú URL obsahu dokončeného videosúboru vo vašom vlastníctve s vráteným podpisom. Vlastník súboru, jeho typ a uložený doklad o jeho bajtoch musia zodpovedať požiadavke.

Životný cyklus: asynchronous_job_then_owned_outputs

GET /v1/videos/{request_id} · skutočne vrátené id alebo polling_url

GET /v1/videos/{request_id}/content

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Účtovacia jednotka	Podmienky účtovania	Pixely na megapixel	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Účtovacia jednotka—	Podmienky účtovania—	Pixely na megapixel—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaCena videa	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza megapixel-sekundu	Podmienky účtovaniakvalita: creative	Pixely na megapixel1 048 576	Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.21 za megapixel-sekundu
KonfiguráciaCena videa	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza megapixel-sekundu	Podmienky účtovaniaquality: precise	Pixely na megapixel1 048 576	Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.15 za megapixel-sekundu
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Účtovacia jednotka—	Podmienky účtovania—	Pixely na megapixel—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.15 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Generovanie videa

Použite skutočné vstupné údaje a uchovajte úplný výsledok

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.

Prijať a uložiť výsledky

Ailoot Ultra · Generovanie videa

GET /v1/videos/{request_id}
GET /v1/videos/{request_id}/content

Uložiť všetky dokončené podklady

GET všetky dokončené podklady

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

Uchovať všetky dokončené výsledky

Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.

Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.

Ak treba overiť pôvodnú odpoveď

Zachovajte X-Client-Request-ID, X-Ailoot-Task-Id a skutočne vrátené id/polling_url. Pokračujte v pôvodnej úlohe; vytvorenie znova neodosielajte.

Polia odpovede

Pole	Typ
Pole`id`	Typ
Pole`status`	Typ
Pole`data[]`	Typ
Pole`outputs[]`	Typ

Aliasy

Aliasy modelov

Ailoot Ultra black-forest-labs/flux-video-upscale

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

black-forest-labs/flux-video-upscale

FAQ · Black Forest Labs: FLUX Video Upscale

Aké vstupy a výsledky sú dostupné?: POST /v1/videos · black-forest-labs/flux-video-upscale: text, image, audio, video → video
Aké polia používa požiadavka?: POST /v1/videos · black-forest-labs/flux-video-upscale: model, input_references, upscale_factor, creativity
Aké limity platia?: POST /v1/videos · black-forest-labs/flux-video-upscale: upscale_factor.minimum: 1.5; upscale_factor.maximum: 3

Black Forest Labs: FLUX Video Upscale