Black Forest Labs

FLUX 3 Video

flux-3-video

Il primo modello video di Black Forest Labs, architettura multimodale unificata, supporta text-to-video, image-to-video e continuazione tramite keyframe, generazione sincronizzata di immagini e audio nativo, fino a circa 20 secondi HD per singola generazione

flux-3-video

Prova flux-3-video

Input

Draft

Creazioni

Vedi tutte le creazioni

Output

video

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

flux-3-video per second

Specifiche	720P	1080P
With Reference Videos	—	$0.760
Without Reference Videos	—	$0.420
Draft Off · Without Reference Videos	$0.250	—
Draft Off · With Reference Videos	$0.590	—
Draft On · Without Reference Videos	$0.090	—
Draft On · With Reference Videos	$0.180	—

Panoramica e posizionamento

FLUX 3 Video è un modello di generazione video lanciato da Black Forest Labs, basato su un'architettura multimodale unificata addestrata congiuntamente su immagini, video, audio e movimento; supporta tre tipi di attività — testo-video, immagine-video e continuazione video — e genera contemporaneamente un audio nativo coerente con le immagini. Gli sviluppatori possono richiamarlo tramite l'interfaccia unificata di HiAPI.ai e ottenere clip da 5 a 20 secondi a 720p o 1080p. È adatto ai team pubblicitari e di short video che necessitano di produrre rapidamente materiali commerciali con audio, nonché ai creatori della fase di pre-produzione cinematografica che devono estendere le inquadrature o previsualizzare il controllo dei fotogrammi chiave.

Punti di forza principali

Un unico set di parametri per tre tipi di attività video — lo stesso modello copre contemporaneamente testo-video, immagine-video e continuazione video; cambiare attività non richiede di modificare il metodo di accesso né di ricostruire il flusso di lavoro.
Generazione sincronizzata di immagini e audio nativo — per impostazione predefinita vengono generati suoni ambientali, dialoghi ed effetti sonori insieme alle immagini, eliminando le fasi separate di doppiaggio e allineamento; è possibile disattivarli per ottenere clip mute.
Più immagini per comporre storyboard o fotogrammi chiave — 1 immagine definisce il primo fotogramma, 2 definiscono il primo e l'ultimo, 3–10 compongono uno storyboard su una linea temporale uniforme, facilitando il controllo del ritmo delle inquadrature.
Modalità bozza per prove a basso costo — attivando la modalità bozza si ottiene un'anteprima a 720p più rapida ed economica, utile per verificare prompt e composizione prima della versione definitiva.

Descrizione delle capacità

Testo-video: genera una clip completa solo da un prompt testuale; il prompt viene analizzato ed esteso prima della generazione, ideale per costruire inquadrature da zero senza materiale di riferimento.

Immagine-video e controllo dei fotogrammi chiave: carica da 1 a 10 immagini per guidare il movimento: una singola immagine definisce il primo fotogramma, due definiscono il primo e l'ultimo, più immagini compongono uno storyboard su una linea temporale uniforme, per controllare con precisione inizio, fine e ritmo dell'inquadratura.

Continuazione video: è possibile fornire un MP4 di massimo 15 secondi e 50 MB per continuare la generazione dal fotogramma finale, estendendo una clip esistente o realizzando un passaggio di inquadratura; questo parametro è mutualmente esclusivo con l'input di immagini.

Durata e risoluzione controllabili: durata della clip da 5 a 20 secondi, risoluzione selezionabile a 720p o 1080p, con proporzioni supportate da 21:9 a 9:16 per un totale di otto preset più la selezione automatica auto.

Generazione audio nativo: per impostazione predefinita genera suoni ambientali, dialoghi ed effetti sonori sincronizzati con le immagini; disattivandola si ottiene una clip muta, utile per aggiungere in post-produzione musica o doppiaggio separati.

Casi d'uso

Team pubblicitari e di brand: generare una clip promozionale da una singola immagine di prodotto — carica l'immagine del prodotto e descrivi il movimento della camera per ottenere materiale da 5 a 20 secondi con suoni ambientali, da usare direttamente per campagne social o per la prima schermata del sito web.
Creatori della pre-produzione cinematografica: previsualizzazione delle inquadrature con fotogrammi chiave — usa da 2 a 10 immagini di storyboard per fissare il ritmo e ottenere clip di previsualizzazione dinamiche, utili a regista e direttore della fotografia per confermare movimenti di macchina e punti di montaggio.
Gestione di short video: estendere inquadrature da materiale esistente — fornisci un MP4 di massimo 15 secondi e continua dal finale per ottenere segmenti più lunghi, riducendo rigirazioni e riprese aggiuntive.
Marketing multilingue: materiali localizzati con sincronizzazione labiale — specifica lingua e dialoghi nel prompt per ottenere brevi video localizzati con audio e immagini sincronizzati, da usare per versioni destinate a diverse regioni.

Limitazioni e consigli sulla scelta

La durata massima di una singola generazione è di 20 secondi; contenuti più lunghi richiedono generazione a segmenti e unione tramite continuazione video; la fatturazione avviene in base ai secondi di output, quindi clip lunghe o rigenerazioni ripetute aumentano i costi. L'audio nativo viene generato in sincronia con le immagini e lo spazio per regolazioni indipendenti della traccia in post-produzione è limitato; per un missaggio accurato si consiglia di disattivare l'audio e realizzarlo separatamente. I parametri di input immagine e continuazione video sono mutualmente esclusivi e non possono essere usati nella stessa richiesta; la modalità bozza è limitata a 720p. Se l'attività richiede inquadrature continue superiori a 20 secondi o un controllo audio preciso fotogramma per fotogramma, valutare soluzioni di unione a segmenti o altri strumenti dedicati.

Novità

Vedi il changelog →

Nuovo modello Il modello di generazione video flux-3-video è online Oct 31, 2026

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.

Idempotency-KeystringOpzionale

Chiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.

Chiave di idempotenza

In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.

Corpo

modelstringObbligatorio

Valore fisso attuale: flux-3-video

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per flux-3-video e la route default — vedi la tabella dei parametri sotto.

draftbooleanOpzionalePredefinito: false

Generate a faster, lower-cost 720p preview instead of a full-quality clip.

imagesarrayOpzionaleminItems 1maxItems 10

Optional PNG, JPEG, or WebP images. One image sets the opening frame, two set opening and closing frames, and 3-10 images form an evenly timed storyboard. Cannot be combined with start_video.

Array [ string ]

promptstringObbligatoriominLength 1maxLength 4700

Describe the scene, action, camera movement, dialogue, and sound. The prompt is interpreted and expanded before generation.

durationintegerOpzionalePredefinito: 5min 5max 20

Generated clip duration in seconds. HiAPI uses an explicit 5-20 second duration for deterministic billing.

resolutionstringOpzionalePredefinito: "720p"

Output resolution. Draft generation is available at 720p only.

Opzioni:720p1080p

start_videostringOpzionale

Optional MP4 to continue from its final frames. Maximum 50 MB and 15 seconds. Cannot be combined with images.

aspect_ratiostringOpzionalePredefinito: "auto"

Output aspect ratio. Auto selects a ratio from the prompt and media inputs.

Opzioni:auto21:92:116:94:31:13:49:16

generate_audiobooleanOpzionalePredefinito: true

Generate synchronized ambient sound, dialogue, and effects. Disable for a silent clip.

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.

urlstringObbligatorio

Obbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.

whenstringOpzionalePredefinito: "final"

Al momento è supportato solo final: notifica sia su success sia su fail.

Opzioni:final

storagestringOpzionalePredefinito: "temp"

Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.

Opzioni:temppersistent

Esempi di richiesta

# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-3-video",
  "input": {
    "draft": false,
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "flux-3-video",
    input: {
      "draft": false,
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "auto",
      "generate_audio": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "flux-3-video",
        "input": {
          "draft": False,
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "auto",
          "generate_audio": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Ottieni i dettagli dell'attività

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

queued In coda, non avviata. handling In elaborazione. archiving Elaborazione conclusa, preparazione artefatti. success Terminale: completato, artefatti disponibili (restituisce output). fail Terminale: errore (restituisce error). Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi Unix dello stato terminale; 0 finché non terminale.

outputarrayOpzionale

Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).

Array [ object ]

Elementi dell'array

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione dell'errore.

Esempi di risposta

Successo

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In elaborazione (non terminale)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Non riuscito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}