Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale förstorar ett befintligt klipp genom källtrogen eller kreativ detaljförbättring. Den dokumenterade profilen erbjuder 1,5×–3× skalning, bevarar källans ljud och bildutsnitt och begränsar källängd, indataupplösning och den resulterande bildrutans yta.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
FLUX Video Upscale är Black Forest Labs arbetsflöde för videosuperupplösning, drivet av FLUX 3. Det tar emot ett befintligt klipp och returnerar en förstorad MP4, med källans bildutsnitt och ljud överförda till resultatet. En kort valfri beskrivning kan styra de förbättrade visuella detaljerna. Dess två lägen ger ett meningsfullt val mellan att hålla sig nära angivet utseende och att generera mer aggressiva detaljer, i stället för att behandla varje större bild som en lika trogen rekonstruktion.
Välj precis eller kreativ förbättring
Inställningen creativity väljer läget. Värdet 0 är den precisa, källtrogna profilen: tillverkaren rekommenderar det när ett ansikte, en produkt eller en varumärkesresurs behöver behålla sin identitet. Värdet 1 aktiverar kreativ detaljförbättring och är standard. Det kan återställa eller hitta på textur mer aggressivt, vilket är användbart för genererat material, landskap, folkmassor eller ytor vars detaljer kan utvecklas kreativt.
Tillverkaren varnar uttryckligen för att kreativ förbättring inte bevarar ansikten och produkter lika strikt. Kontrollera egenskapen som måste förbli identifierbar: ansiktsutseende, en produktkontur, text, ett materialmönster eller en logotyp. En bild som ser skarpare ut kan fortfarande innehålla en ändrad eller nyskapad detalj. Använd det avsedda produktutseendet som granskningskriterium för en produktdemonstration i stället för att välja en version bara för att dess textur är mer utarbetad.
Den valfria prompten beskriver klippets innehåll för att styra förbättringen; en tom beskrivning begär neutral uppskalning. Ett ursprungligt uppdrag för en genererad scen kan identifiera en mossklädd stenmur, mjukt dagsljus och fin bladtextur. Håll formuleringen till det material som ska förfinas. En begäran att ersätta ett objekt, bygga om miljön eller ändra dialog hör till ett redigeringsbeslut, medan den här profilen behåller källans ljudspår.
Skala och den resulterande bildrutans yta
Det dokumenterade upscale_factor sträcker sig från 1.5 till 3, med 2 som standard. Det förstorar källupplösningen och bevarar bildförhållandet. Den valda faktorn och indatadimensionerna bestämmer avsedda utdata, så ett liggande klipp och en stående komposition behöver planeras utifrån sina faktiska bildrutor. Förbered målvisningsstorleken innan du väljer hur mycket förstoring som är användbar.
Den exakta specifikationen begränsar varje utdatabildruta till 13,75 av tillverkarens megapixelenheter. Dokumentationen definierar en sådan enhet som 1 048 576 pixlar, vilket ger ett tak på 14 417 920 pixlar, cirka 14,4 miljoner. Det förklarar guidens avrundade formulering om 14,4 megapixlar. En stor källa kan därför få mindre förstoring än den begärda faktorn. Kontrollera levererade dimensioner i stället för att anta att en 3×-begäran alltid ger tre gånger varje källdimension.
Det publicerade taket för källupplösning är 2560×1440. Arbetsflödet förstorar en källa som uppfyller indatakraven mot 4K och högre; det accepterar inte en redan större källa bara för att högre utdata önskas. Skala ned eller förbered en lämplig arbetskopia innan den dokumenterade profilen används. Spara originalinspelningen separat så att slutjämförelsen inte begränsas till ett storleksändrat mellanresultat.
Förbered en kort, tydlig källa
Tillverkarens vanliga förberedelsevägledning begränsar källor till tjugo sekunder och femtio MB. Ett klipp anges genom en video-URL eller kodad MP4. Den exakta referensen noterar att bearbetningen omfattar de första tjugo sekunderna: en liten längdöverskridning kan bearbetas enbart till den punkten, medan ett avsevärt längre klipp avvisas. Ingen numerisk tolerans publiceras. Trimma till avsett segment på högst tjugo sekunder i stället för att förlita dig på detta ospecificerade gränsbeteende.
Välj den minst komprimerade version som finns. Komprimeringsartefakter begränsar mängden verkliga detaljer som uppskalaren kan återvinna, och kreativ förbättring kan skapa en trovärdig textur utan att fastställa vad originalscenen innehöll. Slutför avsedd redigering och trimning före förstoring av valt klipp. Ett ursprungligt arbetsflöde kan först färdigställa en produkttagning, välja det användbara handlingsintervallet och sedan skala upp slutvalet, med oförändrad källa sparad för jämförelse.
Resultatet behåller källans ljudspår. Granska dess timing mot bilden, särskilt i början och slutet av ett valt segment. Den dokumenterade profilen erbjuder inte en oberoende väljare för bildfrekvens, generering av ny dialog eller redigeringskontroller för bildreferens. Syftet är den större videon och vald detaljbehandling, med källans tidsmässiga och ljudmässiga material bevarat inom det bearbetade segmentet.
Spara och kontrollera det levererade klippet
Producentens arbetsflöde är asynkront: en inskickad uppgift ger en identitet och statusadress och dess färdiga resultat innehåller en signerad MP4-leveranslänk. Länken upphör att gälla efter cirka en timme. Spara det faktiska klippet, källan, vald faktor, creativity-läge och innehållsbeskrivning i stället för att förlita dig på den tillfälliga adressen. Håll misslyckad eller modererad status separat från en färdig video.
Granska enskilda bildrutor för ansikten, märkningar och ytförändringar och se sedan hela sekvensen för kontinuitet, rörelse och ljudsynkronisering. Precisa och kreativa utdata svarar mot olika visuella krav; den användbara leveransen är det förstorade klippet som uppfyller valt mål för trohet vid avsedd visningsstorlek. En större upplösning är i sig inget bevis för att ursprunglig identitet, ordalydelse eller fina detaljer förblev korrekta.
Ailoot Ultra · Videor POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleStart
FLUX Video Upscale förstorar ett befintligt klipp genom källtrogen eller kreativ detaljförbättring. Den dokumenterade profilen erbjuder 1,5×–3× skalning, bevarar källans ljud och bildutsnitt och begränsar källängd, indataupplösning och den resulterande bildrutans yta.
- Godkända indata
- Text · Bilder · Ljud · Video
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Videor POST /v1/videos
- Indatatyper
text,image,audio,video- Utdatatyper
video
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser black-forest-labs/flux-video-upscale | Standard— |
Fältinput_references | Typarray | KravObligatoriskt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 1 | Standard— |
Fältupscale_factor | Typnumber | KravObligatoriskt | Värden & gränser Minimum: 1,5 Maximum: 3 | Standard— |
Fältcreativity | Typinteger | KravObligatoriskt | Värden & gränser 0, 1 | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, input_references, upscale_factor, creativity |
Parametermaterial_types | Avtaltext, image, audio, video |
Parametermaterial_conditions | AvtalAnvänd exakt en faktisk URL till innehållet i en färdig videotillgång som du äger, med dess returnerade signatur. Tillgångens ägare, typ och lagrade bytebelägg måste motsvara begäran. |
Livscykel: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · faktiskt returnerat id eller polling_url
GET /v1/videos/{request_id}/content
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Debiteringsvillkor | Pixlar per megapixel | Avgift |
|---|---|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Debiteringsenhet— | Debiteringsvillkor— | Pixlar per megapixel— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Debiteringsenhetper megapixelsekund | Debiteringsvillkorkvalitet: creative | Pixlar per megapixel1 048 576 | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.21 per megapixelsekund |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Debiteringsenhetper megapixelsekund | Debiteringsvillkorquality: precise | Pixlar per megapixel1 048 576 | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.15 per megapixelsekund |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | Debiteringsvillkor— | Pixlar per megapixel— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.15 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Videor
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.
Ta emot och spara resultat
Ailoot Ultra · Videor
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Spara alla färdiga resurser
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
Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.
Om det ursprungliga svaret behöver kontrolleras
Behåll X-Client-Request-ID, X-Ailoot-Task-Id och faktiskt returnerat id/polling_url. Fortsätt med det ursprungliga jobbet; skicka inte skapandebegäran igen.
Svarsfält
| Fält | Typ |
|---|---|
Fältid | Typ |
Fältstatus | Typ |
Fältdata[] | Typ |
Fältoutputs[] | Typ |
Alias
Modellalias
Ailoot Ultra black-forest-labs/flux-video-upscale
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · Black Forest Labs: FLUX Video Upscale
- Vilka indata och resultat finns?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Vilka fält använder begäran?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Vilka gränser gäller?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3