Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale ingrandisce un clip esistente migliorando i dettagli in modo fedele alla sorgente oppure creativo. Il profilo documentato offre fattori di scala da 1.5× a 3×, preserva audio e inquadratura originali e pone limiti alla durata e alla risoluzione di ingresso e all’area dei fotogrammi di uscita.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
FLUX Video Upscale è il flusso di super-risoluzione video di Black Forest Labs basato su FLUX 3. Riceve un clip esistente e restituisce un MP4 ingrandito, mantenendo nel risultato l’inquadratura e l’audio sorgenti. Una breve descrizione facoltativa può guidare il miglioramento dei dettagli visivi. Le due modalità offrono una scelta sostanziale tra restare vicini all’aspetto fornito e generare dettagli più marcati, invece di considerare ogni immagine più grande una ricostruzione altrettanto fedele.
Scegliere un miglioramento preciso o creativo
L’impostazione creativity seleziona la modalità. Il valore 0 corrisponde al profilo preciso, fedele alla sorgente: il produttore lo consiglia quando un volto, un prodotto o una risorsa di marca devono mantenere la propria identità. Il valore 1 abilita il miglioramento creativo dei dettagli ed è l’impostazione predefinita. Può recuperare o inventare texture in modo più aggressivo, utile per filmati generati, paesaggi, folle o superfici i cui dettagli possono essere sviluppati creativamente.
Il produttore avverte esplicitamente che il miglioramento creativo non preserva volti e prodotti con lo stesso rigore. Controlla la caratteristica che deve rimanere riconoscibile: aspetto del volto, sagoma del prodotto, scritte, motivo di un materiale o logo. Un’immagine che sembra più nitida può comunque contenere un dettaglio modificato o inventato. Per una dimostrazione di prodotto, usa come criterio di verifica l’aspetto previsto del prodotto, invece di scegliere una versione soltanto perché la sua texture è più elaborata.
Il prompt facoltativo descrive il contenuto del clip per guidare il miglioramento; una descrizione vuota richiede un ingrandimento neutro. Il brief originale di una scena generata potrebbe identificare un muro di pietra coperto di muschio, luce diurna morbida e una texture fine delle foglie. Concentra il testo sul materiale da perfezionare. Chiedere di sostituire un oggetto, ricostruire l’ambientazione o cambiare un dialogo riguarda una decisione di modifica, mentre questo profilo conserva la traccia audio sorgente.
Fattore di scala e area del fotogramma di uscita
Il parametro documentato upscale_factor va da 1.5 a 3, con 2 come valore predefinito. Ingrandisce la risoluzione sorgente preservando il rapporto d’aspetto. Il fattore scelto e le dimensioni di ingresso determinano l’output previsto, quindi un clip orizzontale e una composizione verticale vanno pianificati a partire dai loro fotogrammi effettivi. Definisci le dimensioni di visualizzazione desiderate prima di scegliere quanto ingrandimento sia utile.
La specifica esatta limita ogni fotogramma di uscita a 13.75 delle unità megapixel del produttore. La documentazione definisce ciascuna di queste unità come 1.048.576 pixel, per un limite di 14.417.920 pixel, circa 14,4 milioni. Questo spiega la formulazione arrotondata di 14,4 megapixel nella guida. Una sorgente grande può quindi ricevere un ingrandimento inferiore al fattore richiesto. Controlla le dimensioni consegnate invece di presumere che una richiesta 3× produca sempre il triplo di ogni dimensione sorgente.
Il limite pubblicato per la risoluzione sorgente è 2560×1440. Questo flusso porta una sorgente idonea verso il 4K e oltre; non accetta una sorgente già più grande soltanto perché si desidera un output superiore. Riduci la risoluzione o prepara una copia di lavoro appropriata prima di usare il profilo documentato. Conserva separatamente la registrazione originale, così il confronto finale non è limitato a un intermedio ridimensionato.
Preparare una sorgente breve e leggibile
Le normali indicazioni di preparazione del produttore limitano le sorgenti a venti secondi e cinquanta MB. Il clip viene fornito tramite un URL video o un MP4 codificato. Il riferimento tecnico esatto precisa che l’elaborazione riguarda i primi venti secondi: un piccolo superamento della durata può essere elaborato soltanto fino a quel punto, mentre un clip notevolmente più lungo viene rifiutato. Non è pubblicata alcuna tolleranza numerica. Taglia il segmento desiderato a venti secondi o meno, invece di affidarti a quel comportamento di confine non specificato.
Scegli la versione meno compressa disponibile. Gli artefatti di compressione limitano la quantità di dettagli reali recuperabili, e il miglioramento creativo può produrre una texture plausibile senza dimostrare che fosse presente nella scena originale. Completa il montaggio e il taglio previsti prima di ingrandire il clip selezionato. Un flusso di lavoro può prima completare un’inquadratura di prodotto, scegliere l’intervallo di azione utile e poi ingrandire quella selezione finale, conservando la sorgente invariata per il confronto.
Il risultato mantiene la traccia audio sorgente. Controllane la sincronizzazione con le immagini, soprattutto all’inizio e alla fine del segmento selezionato. Il profilo documentato non offre un selettore indipendente del frame rate, la generazione di nuovi dialoghi o controlli di modifica tramite immagini di riferimento. Il suo scopo è ottenere un video più grande con il trattamento dei dettagli scelto, mantenendo il materiale temporale e sonoro della sorgente all’interno del segmento elaborato.
Conservare e controllare il clip consegnato
Il flusso del produttore è asincrono: una task inviata fornisce un identificatore e un indirizzo per consultarne lo stato, e il risultato completato contiene un link firmato per la consegna del MP4. Il link scade dopo circa un’ora. Conserva il clip effettivo, la sorgente, il fattore scelto, la modalità di creatività e la descrizione del contenuto, invece di affidarti all’indirizzo temporaneo. Distingui uno stato di errore o di moderazione da un video completato.
Controlla i singoli fotogrammi per volti, segni e cambiamenti delle superfici, quindi guarda la sequenza per verificarne continuità, movimento e allineamento audio. Gli output precisi e creativi rispondono a esigenze visive differenti; il risultato utile è il clip ingrandito che soddisfa l’obiettivo di fedeltà scelto alle dimensioni di visualizzazione previste. Una risoluzione superiore da sola non dimostra che identità originale, scritte o dettagli fini siano rimasti corretti.
Ailoot Ultra · Generazione video POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleIntroduzione
FLUX Video Upscale ingrandisce un clip esistente migliorando i dettagli in modo fedele alla sorgente oppure creativo. Il profilo documentato offre fattori di scala da 1.5× a 3×, preserva audio e inquadratura originali e pone limiti alla durata e alla risoluzione di ingresso e all’area dei fotogrammi di uscita.
- Input accettati
- Testo · Immagini · Audio · Video
- Risultati
- Video
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Generazione video POST /v1/videos
- Tipi di input
text,image,audio,video- Tipi di output
video
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti black-forest-labs/flux-video-upscale | Predefinito— |
Campoinput_references | Tipoarray | RequisitoObbligatorio | Valori e limiti Numero minimo di elementi: 1 Numero massimo di elementi: 1 | Predefinito— |
Campoupscale_factor | Tiponumber | RequisitoObbligatorio | Valori e limiti Minimo: 1,5 Massimo: 3 | Predefinito— |
Campocreativity | Tipointeger | RequisitoObbligatorio | Valori e limiti 0, 1 | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, input_references, upscale_factor, creativity |
Parametromaterial_types | Contrattotext, image, audio, video |
Parametromaterial_conditions | ContrattoUsa esattamente un URL reale del contenuto di una risorsa video completata di tua proprietà con la firma restituita. Il proprietario della risorsa, il tipo e la prova dei byte memorizzati devono corrispondere alla richiesta. |
Ciclo di vita: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id o polling_url effettivamente restituito
GET /v1/videos/{request_id}/content
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Unità di fatturazione | Condizioni di fatturazione | Pixel per megapixel | Costo |
|---|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Unità di fatturazione— | Condizioni di fatturazione— | Pixel per megapixel— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper megapixel-secondo | Condizioni di fatturazionequalità: creative | Pixel per megapixel1.048.576 | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.21 per megapixel-secondo |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper megapixel-secondo | Condizioni di fatturazionequality: precise | Pixel per megapixel1.048.576 | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.15 per megapixel-secondo |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Unità di fatturazione— | Condizioni di fatturazione— | Pixel per megapixel— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.15 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
Ailoot Ultra · Generazione video
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.
Ricevi e salva i risultati
Ailoot Ultra · Generazione video
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Salva tutte le risorse completate
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
Conserva tutti i risultati completati
Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva la risposta completa e gli header, ogni output effettivo, gli identificatori originali restituiti e tutti i campi di utilizzo. Recupera l'operazione originale senza inviare nuovamente la richiesta di creazione.
Se occorre verificare la risposta originale
Conserva X-Client-Request-ID, X-Ailoot-Task-Id e id/polling_url effettivamente restituiti. Prosegui con l'attività originale; non inviare nuovamente la richiesta di creazione.
Campi della risposta
| Campo | Tipo |
|---|---|
Campoid | Tipo |
Campostatus | Tipo |
Campodata[] | Tipo |
Campooutputs[] | Tipo |
Alias
Alias del modello
Ailoot Ultra black-forest-labs/flux-video-upscale
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · Black Forest Labs: FLUX Video Upscale
- Quali input e risultati sono disponibili?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Quali campi usa la richiesta?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Quali limiti si applicano?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3