POST /flux/videos per completare la generazione video, image-to-video da fotogrammi chiave, continuazione video e miglioramento delle bozze. action=generate (predefinito), mode seleziona la modalità di generazione; per interrogare i risultati si utilizza uniformemente l’esistente POST /flux/tasks.
Attualmente in Beta. Sono disponibili text-to-video, image-to-video, continuazione video e miglioramento delle bozze. HTTP 200 e l’ID attività indicano solo che l’attività è stata accettata; è necessario continuare a interrogare il risultato finale.
1. Ottenere il Token API
- Registrati o accedi nella console di Ace Data Cloud, crea un’applicazione e ottieni il Token API. Un Token API universale può richiamare i servizi della piattaforma; verifica che l’applicazione disponga dei permessi per richiamare il servizio Flux e di un saldo disponibile.
- Visualizza i piani e i prezzi delle singole operazioni nella pagina del servizio Flux. Se il saldo è insufficiente, ricarica nella pagina saldo della console.
- Le richieste utilizzano
Authorization: Bearer <il tuo Token>. Il Token deve essere conservato nelle variabili d’ambiente del server; non scriverlo nelle pagine frontend, nei repository pubblici, negli screenshot o negli URL di callback.
Il codice di questo documento legge uniformemente la variabile d’ambiente:
Per i campi completi e il debug online, consulta Flux Videos API; per l’interrogazione delle attività, consulta Flux Tasks API.
2. Scegliere l’operazione e l’input
Il modello di generazione è
flux-3, con action impostato su generate (predefinito). Tramite mode si selezionano text-to-video, image-to-video, continuazione video o miglioramento della bozza.
Parametri generali di generazione
L’URL della risorsa deve poter essere letto dal servizio. Se si utilizza un URL firmato temporaneo, è necessario riservare un periodo di validità sufficiente per il download e l’elaborazione. Non utilizzare l’indirizzo di una pagina web come indirizzo di un file immagine o video.
3. Text-to-video: richiesta completa testata e risultato
La seguente richiesta è stata eseguita con successo sull’interfaccia di produzione prima dell’adeguamento dei prezzi del 2026-10-02. L’omissione diaction ha verificato il comportamento predefinito di generazione; async=true evita una lunga attesa della connessione HTTP.
task_id nella tua risposta e continua a interrogare; non utilizzare l’ID attività dell’esempio della documentazione per interrogare i risultati di altri account.
response restituito dall’interrogazione dell’attività contiene il risultato finale di business. Di seguito è riportato il response riuscito di questo test effettivo, omettendo i metadati dell’attività esterna. L’URL del video nella documentazione è stato sostituito con una copia dello stesso file su CDN di esempio a lungo termine (SHA-256 identico); la chiamata effettiva restituirà l’URL del risultato dell’attività corrente:
Questo è un test storico precedente all’adeguamento dei prezzi:
list_amount=2.9871876975 Credits, l’account godeva allora di uno sconto sul consumo del 10%, e l’effettivo amount=2.68846892775 Credits. Il nuovo prezzo del 2026-10-02 è stato ridotto di circa il 6.33%; la stessa bozza di 5.041667 secondi al prezzo attuale è di 2.798125185 Credits (prima dello sconto sul consumo) e, se si gode ancora di uno sconto sul consumo del 10%, è di 2.5183126665 Credits. Le fatture delle attività storiche non vengono ricalcolate. I piani e gli sconti di altri account potrebbero essere diversi; questo non è un prezzo fisso in dollari USA per tutti gli utenti.
4. Da immagine a video: normale e con fotogrammi chiave temporizzati
Di seguito sono riportati esempi di parametri; è necessario sostituire gli URL delle risorse e non costituiscono una dichiarazione che l’esempio sia già stato eseguito con successo. Dopo il completamento della generazione, eseguire la query seguendo il processo sopra indicato; la struttura del risultato è la stessa. Una o due immagini utilizzano un array normale:[secondi, URL immagine]:
Output testato da immagine a video
L’input corrispondente di questo test è il seguente (solo la stringa descrittiva sostituisce il base64 completo, mentre gli altri campi sono la richiesta reale):
Dopo aver scaricato questo fotogramma chiave PNG, è possibile usare base64.b64encode(image_bytes).decode("ascii") di Python per ottenere la stringa originale e inserirla nell’array keyframes. Non utilizzare il testo descrittivo nel documento come input immagine.
Di seguito è riportata la response finale reale di un’attività di produzione del 2026-10-01 (non una risposta simulata); solo l’URL del video è stato sostituito con una copia di esempio a lungo termine con lo stesso hash. L’input testato utilizza la stringa base64 originale di un PNG 1280×720 come singolo fotogramma chiave; l’input URL sopra è un esempio di parametro indipendente.
5. Continuazione del video
Passare un indirizzo di file video esistente instart_video, con mode=v2v, durata massima di 15 secondi.
Output testato della continuazione del video
L’input completo di questo test è il seguente; quando si riproduce l’enhancement della bozza, è necessario sostituirlo con il proprio ID bozza. L’URL del materiale utilizza una copia di esempio a lungo termine dello stesso file:start_video testato è il video bozza completato, gli altri parametri sono duration=5、resolution=hd、generate_audio=false。
6. Prima bozza, poi enhancement
- Generare una bozza con
draft=true、resolution=hde attendere il successo. - Estrarre l’ID bozza della piattaforma da
data[0].draft_task_idfinale. - Inviare la richiesta di enhancement usando le credenziali dell’applicazione con la stessa appartenenza:
prompt、duration、aspect_ratio、version、generate_audio、draft、keyframes、start_video per sovrascrivere il contenuto originale. La cache della bozza è una risorsa temporanea, eseguire tempestivamente l’enhancement; non è garantita la conservazione permanente né un numero fisso di giorni di conservazione. Le bozze non proprie/non dell’applicazione corrente, le bozze non completate e le cache scadute non possono essere riutilizzate. La bozza e l’enhancement sono due attività, e vengono fatturati separatamente dopo il successo.
Output testato dell’enhancement della bozza
L’input completo di questo test è il seguente; quando si riproduce l’enhancement della bozza, è necessario sostituirlo con il proprio ID bozza. L’URL del materiale utilizza una copia di esempio a lungo termine dello stesso file:7. Chiamata Python end-to-end
Installarerequests, impostare il proprio Token ed eseguire lo script seguente per completare “un invio → polling → output dell’URL del video”. Sia la query sia i tentativi di rete devono utilizzare l’originale task_id, per evitare di inviare nuovamente attività a pagamento.
task_id, continua a interrogare quell’attività; registra task_id e trace_id per facilitare la diagnosi. L’interfaccia di polling stessa non addebita costi di generazione.
8. Utilizzo dei callback
Aggiungicallback_url durante l’invio; al completamento dell’attività verrà inviato a quell’indirizzo il risultato JSON finale tramite POST. La struttura in caso di successo è coerente con la precedente response, mentre in caso di errore include error.
9. Tariffazione attuale e listino prezzi
Aggiornato il 2026-10-02: i prezzi unitari per ciascuna fascia di questa interfaccia video sono stati ridotti di circa il 6,33%; le modalità di misurazione, i pacchetti e le regole di sconto sui consumi rimangono invariati. Il cost nelle response storiche effettive riportate sopra è la fattura al completamento dell’attività e non rappresenta l’attuale quotazione. La generazione video viene fatturata in base ai secondi effettivamente prodotti. Di seguito sono riportati i prezzi unitari attuali in Credits prima dell’applicazione degli sconti sui consumi dell’account, coerenti con le regole della pagina prezzi Flux.
Conversione in dollari USA:
costo effettivo (USD) = cost.amount (Credits) × prezzo del pacchetto / amount del pacchetto. Le fasce di ricarica e gli sconti sui consumi influenzano il prezzo effettivo; i Credits non possono essere considerati direttamente come USD. Le attività non riuscite non comportano costi di generazione; l’importo finale fa fede in base al risultato di completamento e ai registri delle chiamate nella console.
10. Domande frequenti e risoluzione dei problemi
Quando fornisci feedback, includi task_id, trace_id, l’orario della richiesta e i parametri anonimizzati, ma non inviare l’API Token. Per ulteriori modalità, consulta la guida di integrazione Flux MCP.