Black Forest Labs: FLUX Video Edit
FLUX Video Edit [fast] trasforma un clip esistente mediante un’istruzione scritta di modifica. Aggiungi, rimuovi o sostituisci elementi, cambia ambientazione o stile e modifica dialoghi esistenti rispettando i vincoli documentati di durata sorgente, inquadratura e audio.
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 Edit [fast] è il flusso di Black Forest Labs guidato da prompt per modificare un video esistente. Riceve un clip sorgente e un’istruzione che descrive la modifica, quindi restituisce un MP4 modificato. La sorgente definisce l’inquadratura: durata, composizione, movimento di camera e tempi forniscono la struttura di partenza. Usa il prompt per identificare ciò che deve cambiare, invece di scrivere la descrizione di una scena completamente nuova che lascia poco chiara la modifica desiderata.
Indicare la modifica e la sua posizione
Le modifiche documentate comprendono rimozione, aggiunta o sostituzione di oggetti e personaggi, ricostruzione dell’ambientazione, cambiamento dello stile di un clip, modifica del testo visibile e revisione di dialoghi o suoni. Inizia dall’elemento da modificare e dall’operazione. Un’istruzione può rimuovere una borsa da una sedia mantenendo la persona seduta e la stanza, oppure sostituire una tazza semplice con una tazza smaltata blu senza cambiare l’azione della mano. Se sono visibili più oggetti simili, distingui quello interessato tramite posizione, aspetto o ruolo.
Per un’aggiunta, descrivi posizione, scala e azione pertinente. Una lampada rossa alta accanto al divano è più specifica di una lampada aggiuntiva non meglio definita in qualche punto dell’inquadratura. Per una sostituzione, identifica che cosa deve diventare che cosa e il movimento o il contatto da mantenere. La guida ai prompt del produttore consiglia l’istruzione più breve che descriva completamente la modifica, aggiungendo dettagli quando necessari. Preserva deliberatamente le caratteristiche sorgenti invece di chiedere un miglioramento generale di cui non si può valutare la portata.
Ambientazioni, stili e animazione preliminare
Un cambiamento di ambientazione può ricostruire l’ambiente visibile mantenendo l’azione. Il produttore mostra la sostituzione di una superficie da arrampicata con una struttura diversa e la specifica dei nuovi punti di contatto, così mani e piedi del personaggio continuano ad avere una superficie sensata. In una scena pratica, descrivi il nuovo ambiente e la geometria su cui si basa il movimento esistente. Un nuovo sfondo è più facile da valutare quando l’azione originale ha un rapporto esplicito con esso.
La guida mostra anche la trasformazione di un’animazione preliminare in un trattamento visivo finito. Indica quali oggetti schematici diventano i veicoli o gli oggetti di scena previsti, quindi mantieni traiettorie, velocità e rapporto con la camera. Per un cambiamento di stile, descrivi materiali, superfici, luce e riflessi risultanti oltre all’estetica. Una scena dall’aspetto di argilla e una dall’aspetto fotografico richiedono indicazioni visive differenti anche quando seguono la stessa azione.
Un’ulteriore modifica può usare il primo risultato modificato come nuova sorgente. Conserva l’originale e ogni fase selezionata e assegna al passaggio successivo uno scopo chiaro. L’esempio documentato porta un’anteprima preliminare a un’ambientazione finita e poi a un altro trattamento dell’illuminazione. Dopo ogni passaggio, confronta il clip modificato con la sorgente precedente e controlla che le caratteristiche da mantenere siano ancora presenti.
Il dialogo deve rientrare nel tempo esistente
Il flusso mantiene l’audio sorgente, salvo quando l’istruzione richiede un cambiamento di dialogo o suono. Una sorgente muta restituisce un risultato muto, quindi non fornisce parlato esistente da modificare. Per una modifica del dialogo, cita la battuta desiderata, identifica chi parla e adatta le nuove parole al tempo occupato dalla battuta sorgente. La guida riporta il taglio di una sostituzione più lunga quando superava l’intervallo di parlato disponibile. Scrivere più parole non crea tempo aggiuntivo per parlare all’interno dell’inquadratura esistente.
Controlla la battuta udibile insieme alla recitazione visibile. Conserva una copia del testo sorgente e della sostituzione prevista, così da identificare una parola omessa, una frase fuori tempo o un cambiamento sonoro indesiderato. Il risultato utile è il momento parlato modificato all’interno della scena, non una trascrizione presumibilmente fedele soltanto perché il rendering è terminato.
Limiti della sorgente e output ereditato
Il profilo esatto del produttore richiede un video e un prompt di modifica. L’istruzione contiene da uno a 4.096 caratteri dopo la rimozione degli spazi bianchi iniziali e finali. Il clip viene fornito tramite un URL o un MP4 codificato, con durata massima di quindici secondi e limite di ingresso di cinquanta MiB. Ogni lato deve essere di almeno 160 pixel, e il clip normalizzato deve contenere almeno diciassette fotogrammi a 24 fps, circa sette decimi di secondo. Le sorgenti troppo lunghe vengono rifiutate anziché tagliate silenziosamente; quelle troppo piccole possono fallire durante l’elaborazione.
Il flusso documentato usa l’elaborazione a 24 fps e segue durata e rapporto d’aspetto della sorgente. Gli input superiori al profilo 720p vengono ridotti; il produttore mostra una sorgente 1920×1088 restituita a 1248×704. Durata, risoluzione e rapporto d’aspetto non sono impostazioni indipendenti di uscita in questo profilo di modifica. La procedura di campionamento viene gestita internamente e campi come mode, version, seed o generate_audio non sono accettati nel contratto di richiesta dichiarato.
Un video usato soltanto come ispirazione di movimento o stile per un’inquadratura nuova appartiene a un flusso diverso. Questo editor non accetta immagini di riferimento, input costituiti soltanto da audio, maschere o richieste di estensione del clip. Prepara il video effettivo da modificare e mantienine la durata scelta prima di scrivere l’istruzione. Dopo l’elaborazione asincrona, il produttore restituisce il MP4 modificato tramite un link temporaneo firmato, valido per circa un’ora. Salva il risultato e confronta oggetto modificato, fotogrammi circostanti, tempi e audio con la sorgente prima di usare il clip in un montaggio più lungo.
Ailoot Ultra · Generazione video POST /v1/videos black-forest-labs/flux-video-edit
black-forest-labs/flux-video-edit
black-forest-labs/flux-video-editIntroduzione
FLUX Video Edit [fast] trasforma un clip esistente mediante un’istruzione scritta di modifica. Aggiungi, rimuovi o sostituisci elementi, cambia ambientazione o stile e modifica dialoghi esistenti rispettando i vincoli documentati di durata sorgente, inquadratura e audio.
- 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-edit | Predefinito— |
Campoinput_references | Tipoarray | RequisitoObbligatorio | Valori e limiti Numero minimo di elementi: 1 Numero massimo di elementi: 1 | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, input_references, prompt |
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 | Costo |
|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Unità di fatturazione— | Condizioni di fatturazione— | 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 secondo di video | Condizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva. | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.06 per secondo di video |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Unità di fatturazione— | Condizioni di fatturazione— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.06 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_PROMPT:?Set the actual documented input value}"
export AILOOT_PROMPT
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-edit', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'prompt': '${ACTUAL_EDIT_PROMPT}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['prompt']=os.environ['AILOOT_PROMPT']
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-edit
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · Black Forest Labs: FLUX Video Edit
- Quali input e risultati sono disponibili?
POST /v1/videos·black-forest-labs/flux-video-edit:text,image,audio,video→video- Quali campi usa la richiesta?
POST /v1/videos·black-forest-labs/flux-video-edit:model,input_references,prompt