Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale forstørrer et eksisterende klip med kildetro eller kreativ detaljeforbedring. Den dokumenterede profil tilbyder skalering på 1.5×–3×, bevarer kildelyd og indramning og begrænser kildelængde, inputopløsning og outputbilledareal.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
FLUX Video Upscale er Black Forest Labs' arbejdsgang til videosuperopløsning drevet af FLUX 3. Den modtager et eksisterende klip og returnerer en forstørret MP4 med kildens indramning og lyd videreført til resultatet. En kort valgfri beskrivelse kan styre de forbedrede visuelle detaljer. De to tilstande giver et meningsfuldt valg mellem at holde sig tæt til det leverede udseende og generere mere omfattende detaljer frem for at behandle ethvert større billede som en lige troværdig rekonstruktion.
Vælg præcis eller kreativ forbedring
Indstillingen creativity vælger tilstanden. Værdien 0 er den præcise, kildetro profil: producenten anbefaler den, når et ansigt, et produkt eller et brandaktiv skal bevare sin identitet. Værdien 1 aktiverer kreativ detaljeforbedring og er standard. Den kan genskabe eller opfinde tekstur mere aggressivt, hvilket er nyttigt til genererede optagelser, landskaber, menneskemængder eller overflader, hvis detaljer kan udvikles kreativt.
Producenten advarer udtrykkeligt om, at kreativ forbedring ikke bevarer ansigter og produkter lige så strengt. Kontrollér det træk, der skal kunne identificeres: ansigtsudseende, et produkts omrids, bogstaver, et materialemønster eller et logo. Et billede, der ser skarpere ud, kan stadig indeholde en ændret eller nyopfundet detalje. Til en produktdemonstration skal det tilsigtede produktudseende være vurderingskriteriet frem for at vælge en version alene, fordi dens tekstur er mere udførlig.
Den valgfrie prompt beskriver klippets indhold for at styre forbedringen; en tom beskrivelse anmoder om neutral opskalering. En oprindelig brief til en genereret scene kan identificere en mosdækket stenmur, blødt dagslys og fin bladtekstur. Hold ordlyden rettet mod det materiale, der skal forfines. En anmodning om at erstatte et objekt, genopbygge omgivelserne eller ændre dialog er en redigeringsbeslutning, mens denne profil bevarer kildens lydspor.
Skalering og outputbilledareal
Den dokumenterede upscale_factor spænder fra 1.5 til 3 med 2 som standard. Den forstørrer kildeopløsningen og bevarer billedformatet. Den valgte faktor og inputdimensionerne bestemmer det ønskede output, så et landskabsklip og en portrætkomposition skal planlægges ud fra deres faktiske billeder. Forbered målvisningens størrelse, før du vælger, hvor meget forstørrelse der er nyttig.
Den præcise specifikation begrænser hvert outputbillede til 13.75 af producentens megapixelenheder. Dokumentationen definerer én sådan enhed som 1.048.576 pixels, hvilket giver et loft på 14.417.920 pixels, cirka 14.4 millioner. Det forklarer vejledningens afrundede formulering på 14.4 megapixels. En stor kilde kan derfor blive forstørret mindre end den ønskede faktor. Kontrollér de leverede dimensioner frem for at antage, at en 3×-anmodning altid giver tre gange hver kildedimension.
Det offentliggjorte loft for kildeopløsning er 2560×1440. Denne arbejdsgang løfter en egnet kilde mod 4K og derover; den accepterer ikke en allerede større kilde alene, fordi et højere output ønskes. Nedskaler eller forbered en passende arbejdskopi, før den dokumenterede profil bruges. Gem originaloptagelsen separat, så den endelige sammenligning ikke begrænses til et størrelsesændret mellemprodukt.
Forbered en kort, tydelig kilde
Producentens almindelige forberedelsesvejledning begrænser kilder til tyve sekunder og halvtreds MB. Et klip leveres via en video-URL eller kodet MP4. Den præcise reference bemærker, at behandlingen omfatter de første tyve sekunder: en lille overskridelse kan kun behandles frem til den grænse, mens et væsentligt længere klip afvises. Ingen numerisk tolerance er offentliggjort. Trim til det ønskede segment på tyve sekunder eller mindre frem for at være afhængig af den uspecificerede grænseadfærd.
Vælg den mindst komprimerede tilgængelige version. Komprimeringsartefakter begrænser den mængde reelle detaljer, som opskaleringen kan genskabe, og kreativ forbedring kan skabe en plausibel tekstur uden at fastslå, hvad originalscenen indeholdt. Færdiggør den tilsigtede redigering og trimning, før det valgte klip forstørres. En oprindelig arbejdsgang kan først færdiggøre en produktindstilling, vælge det nyttige handlingsinterval og derefter opskalere dette endelige valg, mens den uændrede kilde bevares til sammenligning.
Resultatet beholder kildens lydspor. Undersøg timingen med billedet, især i begyndelsen og slutningen af et valgt segment. Den dokumenterede profil tilbyder ikke en uafhængig billedhastighedsvælger, generering af ny dialog eller redigeringskontroller med billedreferencer. Formålet er den større video og den valgte detaljebehandling med kildens tidsmæssige materiale og lydmateriale bevaret i det behandlede segment.
Gem og kontrollér det leverede klip
Producentens arbejdsgang er asynkron: en indsendt opgave leverer en identitet og en statusplacering, og det færdige resultat indeholder et signeret MP4-leveringslink. Linket udløber efter cirka én time. Gem selve klippet, kilden, den valgte faktor, kreativitetstilstanden og indholdsbeskrivelsen frem for at stole på den midlertidige placering. Hold fejlet eller modereret status adskilt fra en færdig video.
Gennemgå enkeltbilleder for ansigter, markeringer og overfladeændringer, og se derefter sekvensen for kontinuitet, bevægelse og synkronisering mellem lyd og billede. Præcise og kreative output opfylder forskellige visuelle krav; den nyttige leverance er det forstørrede klip, der opfylder det valgte mål for kildetrohed ved den tilsigtede visningsstørrelse. Højere opløsning alene er ikke bevis for, at oprindelig identitet, ordlyd eller fine detaljer forblev korrekte.
Ailoot Ultra · Videoer POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleStart
FLUX Video Upscale forstørrer et eksisterende klip med kildetro eller kreativ detaljeforbedring. Den dokumenterede profil tilbyder skalering på 1.5×–3×, bevarer kildelyd og indramning og begrænser kildelængde, inputopløsning og outputbilledareal.
- Accepterede input
- Tekst · Billeder · Lyd · Video
- Resultater
- Video
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Videoer POST /v1/videos
- Inputtyper
text,image,audio,video- Outputtyper
video
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser black-forest-labs/flux-video-upscale | Standard— |
Feltinput_references | Typearray | KravPåkrævet | Værdier og grænser Minimumsantal elementer: 1 Maksimalt antal elementer: 1 | Standard— |
Feltupscale_factor | Typenumber | KravPåkrævet | Værdier og grænser Minimum: 1,5 Maksimum: 3 | Standard— |
Feltcreativity | Typeinteger | KravPåkrævet | Værdier og grænser 0, 1 | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, input_references, upscale_factor, creativity |
Parametermaterial_types | Kontrakttext, image, audio, video |
Parametermaterial_conditions | KontraktBrug præcis én faktisk indholds-URL til et færdigt videoaktiv, du ejer, med den returnerede signatur. Aktivets ejer, type og den gemte dokumentation for dets bytes skal stemme overens med forespørgslen. |
Livscyklus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · det faktisk returnerede id eller polling_url
GET /v1/videos/{request_id}/content
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregningsenhed | Afregningsbetingelser | Pixel pr. megapixel | Beløb |
|---|---|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Afregningsbetingelser— | Pixel pr. megapixel— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationVideopris | Takstplan— | Forventet mængde— | Afregningsenhedpr. megapixelsekund | Afregningsbetingelserkvalitet: creative | Pixel pr. megapixel1.048.576 | Beløb Output · Videopris · Estimat kun til sammenligning $0.21 pr. megapixelsekund |
| KonfigurationVideopris | Takstplan— | Forventet mængde— | Afregningsenhedpr. megapixelsekund | Afregningsbetingelserquality: precise | Pixel pr. megapixel1.048.576 | Beløb Output · Videopris · Estimat kun til sammenligning $0.15 pr. megapixelsekund |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Afregningsbetingelser— | Pixel pr. megapixel— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.15 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Videoer
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.
Hent og gem resultater
Ailoot Ultra · Videoer
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Gem alle færdige filer
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
Behold alle færdige resultater
Gem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Behold X-Client-Request-ID, X-Ailoot-Task-Id og det faktisk returnerede id/polling_url. Fortsæt det oprindelige job; indsend ikke oprettelsen igen.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Type |
Feltstatus | Type |
Feltdata[] | Type |
Feltoutputs[] | Type |
Aliaser
Modelaliaser
Ailoot Ultra black-forest-labs/flux-video-upscale
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · Black Forest Labs: FLUX Video Upscale
- Hvilke input og resultater er tilgængelige?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Hvilke felter bruger anmodningen?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Hvilke grænser gælder?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3