Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale vergroot een bestaande clip met brongetrouwe of creatieve detailverbetering. Het gedocumenteerde profiel biedt een schaalfactor van 1,5×–3×, behoudt bronaudio en kadrering en begrenst bronlengte, invoerresolutie en uitvoeroppervlakte per frame.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
FLUX Video Upscale is de videosuperresolutieworkflow van Black Forest Labs op basis van FLUX 3. Het ontvangt een bestaande clip en geeft een vergrote MP4 terug, met de oorspronkelijke kadrering en audio in het resultaat. Een korte optionele beschrijving kan het verbeterde visuele detail sturen. De twee modi bieden een betekenisvolle keuze tussen dicht bij het aangeleverde uiterlijk blijven en ingrijpender detail genereren, in plaats van elk groter beeld als een even getrouwe reconstructie te behandelen.
Precieze of creatieve verbetering kiezen
De instelling creativity selecteert de modus. Een waarde van 0 is het precieze, brongetrouwe profiel: de fabrikant beveelt dit aan wanneer een gezicht, product of merkuiting de eigen identiteit moet behouden. Een waarde van 1 schakelt creatieve detailverbetering in en is de standaard. Deze modus kan textuur ingrijpender herstellen of verzinnen, wat nuttig is voor gegenereerd beeldmateriaal, landschappen, menigten of oppervlakken waarvan het detail creatief kan worden uitgewerkt.
De maker waarschuwt expliciet dat creatieve verbetering gezichten en producten minder strikt behoudt. Controleer het kenmerk dat herkenbaar moet blijven: het uiterlijk van een gezicht, een productomtrek, opschriften, een materiaalpatroon of een logo. Een beeld dat scherper lijkt, kan nog steeds een gewijzigd of nieuw verzonnen detail bevatten. Gebruik voor een productdemonstratie het bedoelde productuiterlijk als beoordelingscriterium, in plaats van een versie alleen te selecteren omdat de textuur uitgebreider is.
De optionele prompt beschrijft de inhoud van de clip om de verbetering te sturen; een lege beschrijving vraagt om een neutrale upscale. Een oorspronkelijke briefing voor een gegenereerde scène kan een met mos bedekte stenen muur, zacht daglicht en fijne bladtextuur benoemen. Houd de formulering gericht op het materiaal dat moet worden verfijnd. Een verzoek om een object te vervangen, de omgeving opnieuw op te bouwen of dialoog te veranderen hoort bij een bewerkingskeuze; dit profiel behoudt de oorspronkelijke audiotrack.
Schaal en uitvoeroppervlakte per frame
De gedocumenteerde upscale_factor loopt van 1.5 tot 3, met 2 als standaard. Deze vergroot de bronresolutie met behoud van de beeldverhouding. De geselecteerde factor en invoerafmetingen bepalen de bedoelde uitvoer, dus een liggende clip en een staande compositie moeten op basis van hun werkelijke frames worden gepland. Bereid de beoogde weergavegrootte voor voordat u kiest hoeveel vergroting nuttig is.
De exacte specificatie begrenst elk uitvoerframe op 13,75 megapixeleenheden volgens de definitie van de fabrikant. De documentatie definieert één zo'n eenheid als 1.048.576 pixels, wat een maximum van 14.417.920 pixels oplevert, ongeveer 14,4 miljoen. Dat verklaart de afgeronde formulering van 14,4 megapixel in de gids. Een grote bron kan daardoor minder worden vergroot dan de gevraagde factor. Controleer de geleverde afmetingen in plaats van aan te nemen dat een 3×-verzoek elke bronafmeting altijd verdrievoudigt.
De gepubliceerde maximale bronresolutie is 2560×1440. Deze workflow vergroot een geschikte bron richting 4K en hoger; de workflow accepteert geen al grotere bron alleen omdat hogere uitvoer gewenst is. Verklein de bron of bereid een passende werkkopie voor voordat u dit gedocumenteerde profiel gebruikt. Bewaar de oorspronkelijke opname afzonderlijk zodat de uiteindelijke vergelijking niet beperkt is tot een tussenbestand met aangepaste afmetingen.
Een korte, goed leesbare bron voorbereiden
De gewone voorbereidingsrichtlijnen van de maker beperken bronnen tot twintig seconden en vijftig MB. Een clip wordt via een video-URL of gecodeerde MP4 aangeleverd. De exacte referentie vermeldt dat de verwerking de eerste twintig seconden omvat: een kleine overschrijding van de lengte kan slechts tot die grens worden verwerkt, terwijl een aanzienlijk langere clip wordt geweigerd. Er is geen numerieke tolerantie gepubliceerd. Knip tot het bedoelde segment van twintig seconden of korter in plaats van op dat ongespecificeerde grensgedrag te vertrouwen.
Kies de minst gecomprimeerde beschikbare versie. Compressieartefacten beperken de hoeveelheid echt detail die de upscaler kan herstellen en creatieve verbetering kan een geloofwaardige textuur maken zonder vast te stellen wat de oorspronkelijke scène bevatte. Voltooi de bedoelde bewerking en inkorting voordat u de geselecteerde clip vergroot. Een oorspronkelijke workflow kan eerst een productshot afronden, het bruikbare actie-interval kiezen en vervolgens die uiteindelijke selectie upscalen, met behoud van de ongewijzigde bron voor vergelijking.
Het resultaat behoudt de oorspronkelijke audiotrack. Controleer de timing ten opzichte van het beeld, vooral aan het begin en einde van een geselecteerd segment. Het gedocumenteerde profiel biedt geen afzonderlijke keuze van framefrequentie, nieuwe dialooggeneratie of bewerkingsregelaars met beeldreferenties. Het doel is de grotere video en de gekozen behandeling van detail, met behoud van het tijdsverloop en geluidsmateriaal van de bron binnen het verwerkte segment.
De geleverde clip bewaren en controleren
De workflow van de producent is asynchroon: een ingediende taak levert een identificatie en statuslocatie op en het voltooide resultaat bevat een ondertekende MP4-leveringslink. Die link verloopt na ongeveer één uur. Bewaar de daadwerkelijke clip, bron, geselecteerde factor, creativiteitsmodus en inhoudsbeschrijving in plaats van op de tijdelijke locatie te vertrouwen. Houd een mislukte of gemodereerde status gescheiden van een voltooide video.
Controleer individuele frames op gezichten, markeringen en oppervlakteveranderingen en bekijk daarna de reeks op continuïteit, beweging en audio-uitlijning. Precieze en creatieve uitvoer beantwoorden aan verschillende visuele eisen; het bruikbare resultaat is de vergrote clip die het gekozen doel voor brongetrouwheid op de bedoelde weergavegrootte bereikt. Een grotere resolutie alleen bewijst niet dat de oorspronkelijke identiteit, formulering of fijne details correct zijn gebleven.
Ailoot Ultra · Videogeneratie POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleAan de slag
FLUX Video Upscale vergroot een bestaande clip met brongetrouwe of creatieve detailverbetering. Het gedocumenteerde profiel biedt een schaalfactor van 1,5×–3×, behoudt bronaudio en kadrering en begrenst bronlengte, invoerresolutie en uitvoeroppervlakte per frame.
- Toegestane invoer
- Tekst · Afbeeldingen · Audio · Video
- Resultaten
- Video
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Videogeneratie POST /v1/videos
- Invoer
text,image,audio,video- Uitvoer
video
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten black-forest-labs/flux-video-upscale | Standaard— |
Veldinput_references | Typearray | VereisteVereist | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 1 | Standaard— |
Veldupscale_factor | Typenumber | VereisteVereist | Waarden en limieten Minimum: 1,5 Maximum: 3 | Standaard— |
Veldcreativity | Typeinteger | VereisteVereist | Waarden en limieten 0, 1 | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, input_references, upscale_factor, creativity |
Parametermaterial_types | Contracttext, image, audio, video |
Parametermaterial_conditions | ContractGebruik precies één werkelijke inhouds-URL van een voltooide video-asset die je toebehoort, met de teruggestuurde handtekening. De eigenaar, het type en het opgeslagen bewijs van de bytes van de asset moeten overeenkomen met de aanvraag. |
Levenscyclus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · werkelijk teruggestuurde id of polling_url
GET /v1/videos/{request_id}/content
Tarieven
Zo worden de uiteindelijke kosten berekend
De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Factureringsvoorwaarden | Pixels per megapixel | Kosten |
|---|---|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Factureringsvoorwaarden— | Pixels per megapixel— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieVideoprijs | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper megapixelseconde | Factureringsvoorwaardenkwaliteit: creative | Pixels per megapixel1.048.576 | Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.21 per megapixelseconde |
| ConfiguratieVideoprijs | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper megapixelseconde | Factureringsvoorwaardenquality: precise | Pixels per megapixel1.048.576 | Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.15 per megapixelseconde |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Factureringsvoorwaarden— | Pixels per megapixel— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.15 schatting vóór generatie Deze raming is geen extra kost of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Videogeneratie
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.
Resultaten ophalen en opslaan
Ailoot Ultra · Videogeneratie
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Alle voltooide bestanden opslaan
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
Alle voltooide resultaten bewaren
Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Bewaar de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar X-Client-Request-ID, X-Ailoot-Task-Id en de werkelijk teruggestuurde id/polling_url. Zet de oorspronkelijke opdracht voort; dien de aanmaakaanvraag niet opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldid | Type |
Veldstatus | Type |
Velddata[] | Type |
Veldoutputs[] | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra black-forest-labs/flux-video-upscale
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Black Forest Labs: FLUX Video Upscale
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Welke velden gebruikt het verzoek?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Welke limieten gelden?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3