Black Forest Labs: FLUX Video Upscale
A FLUX Video Upscale meglévő klipet nagyít forráshű vagy kreatív részletjavítással. Dokumentált működése 1,5×–3× nagyítást kínál, megőrzi a forrás hangját és képkivágását, és korlátozza a forráshosszt, bemeneti felbontást és kimeneti képkockaterületet.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A FLUX Video Upscale a Black Forest Labs FLUX 3-alapú videó-szuperfelbontási munkafolyamata. Meglévő klipet fogad, és nagyított MP4-et ad vissza, átvíve a forrás képkivágását és hangját az eredménybe. Rövid opcionális leírás irányíthatja a javított vizuális részleteket. Két módja érdemi választást ad a megadott megjelenés szoros követése és erőteljesebb részletgenerálás között, ahelyett hogy minden nagyobb képet egyformán hű rekonstrukciónak tekintene.
Válassz pontos vagy kreatív javítást
A creativity beállítás választja ki a módot. A 0 érték a pontos, forráshű működés: a gyártó ezt ajánlja, ha arcnak, terméknek vagy márkaanyagnak meg kell őriznie azonosságát. Az 1 érték kreatív részletjavítást engedélyez, és ez az alapérték. Erőteljesebben állíthat helyre vagy találhat ki textúrát, ami generált felvételekhez, tájhoz, tömeghez vagy kreatívan fejleszthető részletű felületekhez hasznos.
A gyártó kifejezetten figyelmeztet, hogy a kreatív javítás kevésbé szigorúan őrzi meg az arcokat és termékeket. Ellenőrizd az azonosíthatónak maradó jellemzőt: arcmegjelenést, termékkörvonalat, betűket, anyagmintát vagy logót. Egy élesebbnek látszó kép továbbra is tartalmazhat megváltozott vagy újonnan kitalált részletet. Termékbemutatónál a kívánt termékmegjelenés legyen az ellenőrzés mércéje, ne csak a gazdagabb textúra miatt válassz változatot.
Az opcionális prompt a klip tartalmát írja le a javítás irányításához; üres leírás semleges nagyítást kér. Egy eredeti generáltjelenet-feladat mohás kőfalat, lágy nappali fényt és finom levéltextúrát azonosíthat. A megfogalmazás a finomítandó anyagról szóljon. Tárgycsere, helyszín-újraépítés vagy párbeszédváltás kérése szerkesztési döntés, míg ez a leírás megtartja a forrás hangsávját.
Nagyítás és kimeneti képkockaterület
A dokumentált upscale_factor 1.5–3 közötti, 2 alapértékkel. A forrásfelbontást a képarány megtartásával növeli. A kiválasztott szorzó és a bemeneti méretek határozzák meg a kívánt kimenetet, ezért fekvő klipet és álló kompozíciót tényleges képkockáikból kell tervezni. A célszerű nagyítás kiválasztása előtt készítsd elő a megcélzott megjelenítési méretet.
A pontos specifikáció minden kimeneti képkockát a gyártó megapixelegységének 13,75-szeresére korlátoz. Dokumentációja egy ilyen egységet 1 048 576 pixelként határoz meg, így a felső határ 14 417 920 pixel, hozzávetőleg 14,4 millió. Ez magyarázza az útmutató kerekített 14,4 megapixeles megfogalmazását. Egy nagy forrás ezért a kért szorzónál kisebb nagyítást kaphat. Ellenőrizd az átadott méreteket, ne feltételezd, hogy a 3× kérés mindig háromszorosára növeli minden forrásméretet.
A közzétett forrásfelbontási felső határ 2560×1440. Ez a munkafolyamat alkalmas forrást növel 4K felé és azon túl; nem fogad már eleve nagyobb forrást pusztán azért, mert magasabb kimenet a cél. A dokumentált működés használata előtt kicsinyíts vagy készíts megfelelő munkamásolatot. Az eredeti felvételt külön tartsd meg, hogy a végső összehasonlítás ne korlátozódjon az átméretezett köztes anyagra.
Rövid, jól értelmezhető forrás előkészítése
A gyártó szokásos előkészítési útmutatója húsz másodpercre és ötven MB-ra korlátozza a forrást. A klip videó-URL-lel vagy kódolt MP4-ként adható meg. Pontos referenciája szerint a feldolgozás az első húsz másodpercet fedi: kis hossztúllépés csak eddig dolgozható fel, míg lényegesen hosszabb klip elutasításra kerül. Számszerű tűréshatárt nem közölnek. Vágd a kívánt húsz másodperces vagy rövidebb szegmensre ahelyett, hogy erre a meghatározatlan határviselkedésre hagyatkoznál.
A legkevésbé tömörített elérhető változatot válaszd. A tömörítési hibák korlátozzák a nagyító által helyreállítható valós részletet, a kreatív javítás pedig hihető textúrát készíthet anélkül, hogy igazolná az eredeti jelenet tartalmát. A kiválasztott klip nagyítása előtt fejezd be a kívánt szerkesztést és vágást. Egy eredeti munkafolyamat előbb befejezhet egy terméksnittet, kiválaszthatja a hasznos cselekményintervallumot, majd nagyíthatja a végső választást, az összehasonlításhoz megtartva a módosítatlan forrást.
Az eredmény megőrzi a forrás hangsávját. Vizsgáld meg időzítését a képpel együtt, különösen egy kiválasztott szegmens elején és végén. A dokumentált működés nem ad független képkockasebesség-választót, új párbeszédgenerálást vagy képreferenciás szerkesztési vezérlőket. Célja a nagyobb videó és választott részletkezelés, a feldolgozott szegmensen belül megőrzött időbeli és hangi forrásanyaggal.
Az átadott klip megtartása és ellenőrzése
A gyártó munkafolyamata aszinkron: a beküldött feladat azonosítót és állapotlekérdezési címet ad, kész eredménye pedig aláírt MP4-letöltési linket tartalmaz. A link körülbelül egy óra után lejár. A tényleges klipet, forrást, kiválasztott szorzót, kreativitási módot és tartalomleírást őrizd meg, ne az ideiglenes helyre támaszkodj. A sikertelen vagy moderált állapotot különítsd el a kész videótól.
Egyes képkockákon ellenőrizd az arcokat, jelöléseket és felületváltozásokat, majd a sorozatban a folytonosságot, mozgást és hangilleszkedést. A pontos és kreatív kimenetek eltérő vizuális igényekre válaszolnak; a hasznos anyag az a nagyított klip, amely a kívánt megjelenítési méreten teljesíti a választott hűségcélt. A nagyobb felbontás önmagában nem bizonyítja, hogy az eredeti azonosság, megfogalmazás vagy finom részlet helyes maradt.
Ailoot Ultra · Videó POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleKezdő lépések
A FLUX Video Upscale meglévő klipet nagyít forráshű vagy kreatív részletjavítással. Dokumentált működése 1,5×–3× nagyítást kínál, megőrzi a forrás hangját és képkivágását, és korlátozza a forráshosszt, bemeneti felbontást és kimeneti képkockaterületet.
- Elfogadott bemenetek
- Szöveg · Képek · Hang · Videó
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Videó POST /v1/videos
- Bemenet
text,image,audio,video- Kimenet
video
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok black-forest-labs/flux-video-upscale | Alapértelmezett— |
Mezőinput_references | Típusarray | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 1 | Alapértelmezett— |
Mezőupscale_factor | Típusnumber | KövetelményKötelező | Értékek és korlátok Minimum: 1,5 Maximum: 3 | Alapértelmezett— |
Mezőcreativity | Típusinteger | KövetelményKötelező | Értékek és korlátok 0, 1 | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, input_references, upscale_factor, creativity |
Paramétermaterial_types | Szerződéstext, image, audio, video |
Paramétermaterial_conditions | SzerződésPontosan egy tényleges, elkészült, Önhöz tartozó videóállomány tartalom-URL-címét használja a visszaadott aláírásával. Az állomány tulajdonosának, típusának és tárolt bájtigazolásának egyeznie kell a kéréssel. |
Életciklus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · a ténylegesen visszaadott id vagy polling_url
GET /v1/videos/{request_id}/content
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Elszámolási egység | Elszámolási feltételek | Pixel megapixelenként | Díj |
|---|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Elszámolási egység— | Elszámolási feltételek— | Pixel megapixelenként— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységmegapixel-másodpercenként | Elszámolási feltételekminőség: kreatív | Pixel megapixelenként1 048 576 | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra $0.21 megapixel-másodpercenként |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységmegapixel-másodpercenként | Elszámolási feltételekquality: precise | Pixel megapixelenként1 048 576 | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra $0.15 megapixel-másodpercenként |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Elszámolási egység— | Elszámolási feltételek— | Pixel megapixelenként— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.15 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot Ultra · Videó
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.
Eredmények fogadása és mentése
Ailoot Ultra · Videó
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Mentsen minden elkészült médiafájlt
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
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.
Ha az eredeti választ ellenőrizni kell
Őrizze meg az X-Client-Request-ID és X-Ailoot-Task-Id fejléceket, valamint a ténylegesen visszaadott id/polling_url értékeket. Folytassa az eredeti feladatot; ne küldje be újra a létrehozási kérést.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőid | Típus |
Mezőstatus | Típus |
Meződata[] | Típus |
Mezőoutputs[] | Típus |
Álnevek
Modell álnevei
Ailoot Ultra black-forest-labs/flux-video-upscale
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Black Forest Labs: FLUX Video Upscale
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Mely mezőket használja a kérés?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Milyen korlátok érvényesek?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3