Come usare l'API di FLUX 3: guida completa per sviluppatori

Risposta rapida

FLUX 3 è il modello video multimodale di Black Forest Labs per generazione da testo a video e da immagine a video con audio sincronizzato. Su CometAPI, l’ID del modello di produzione è flux-3. Il flusso asincrono verificato usa POST /v1/videos per creare un task, GET /v1/videos/{task_id} per pollarlo e GET /v1/videos/{task_id}/content per scaricare l’MP4 completato.

Aggiornamento della disponibilità (verificato il 24 settembre 2026): Black Forest Labs ha superato la fase di Early Access di luglio per FLUX 3 Video e ha reso disponibile la prima release da testo a video e da immagine a video tramite la BFL API e partner selezionati il 4 agosto 2026. CometAPI ha aggiunto l’ID modello di produzione flux-3 nel suo formato Video API il 13 agosto 2026. Usa il comunicato di BFL e la pagina modello live di CometAPI come fonte autorevole per disponibilità, campi e prezzi.

Cosa è cambiato rispetto alla Early Access di FLUX 3?

Il cambiamento importante riguarda la disponibilità operativa. Le prime informazioni trattavano il rollout di luglio basato su candidatura; la release di agosto di BFL ha introdotto un endpoint video invocabile, vincoli pubblicati e prezzi di produzione. In seguito CometAPI ha esposto flux-3 tramite il suo flusso unificato Video API.

L’articolo precedente di CometAPI, FLUX 3 API: Availability, Early Access, Video & Dev, resta utile per la cronologia del lancio e la valutazione preliminare di luglio. Il confronto più ampio Best AI Video APIs in 2026 copre la selezione a livello di mercato. Questa guida mantiene concisi quei temi e si concentra su richieste operative, polling, prompt, controllo dei costi e gestione in produzione.

Che cos’è FLUX 3?

FLUX 3 è la famiglia di modelli multimodali di BFL per video, audio, immagini e previsione di azioni. L’attuale release video supporta testo‑a‑video, immagine‑a‑video e continuazione video tramite un endpoint nativo del provider.

Per gli sviluppatori video, le capacità di rilievo sono fino a 20 secondi a 24 fps, output HD o Full HD, audio sincronizzato, parlato multilingue con lip‑sync, più shot in una generazione e fino a dieci keyframe fissati per il controllo immagine‑a‑video.

Specifiche API di FLUX 3

Quanto è valido FLUX 3 Video?

BFL riporta un punteggio Elo testo‑a‑video di 1135 nella sua valutazione all‑vs‑all basata su preferenze umane. Nello stesso confronto pubblicato, FLUX 3 è a pari merito con Seedance 2.0 in image‑to‑video e si classifica davanti agli altri modelli testati.

Questi risultati sono utili come elementi di posizionamento, ma sono valutazioni basate su preferenze umane gestite dal fornitore, non un benchmark di produzione indipendente. Non misurano latenza del gateway, affidabilità della coda, coerenza dei costi o stabilità su generazioni ripetute; i team di produzione dovrebbero comunque valutare il proprio set di prompt.

Prestazioni di benchmark di FLUX 3

Fonte: Black Forest Labs — FLUX 3 Video, Part 1: Generation.

Cosa ti serve prima di usare l’API di FLUX 3

• Un account CometAPI e una chiave API archiviata in una variabile d’ambiente nel backend.
• Un prompt che definisca soggetto, movimento, direzione della camera, atmosfera e ogni audio o dialogo richiesto.
• Un percorso di gestione job affidabile, poiché la generazione video è asincrona.
• Credito sufficiente per test iterativi; la fatturazione dipende da durata e risoluzione generate.

Crea la chiave nella dashboard dell’API di CometAPI. Non inserirla nel JavaScript del frontend, nei bundle mobile, in repository pubblici o in screenshot.

ID modello di FLUX 3 ed endpoint

Come usare l’API di FLUX 3 con CometAPI

Passaggio 1: imposta la tua chiave API

Su macOS o Linux:

export COMETAPI_KEY="your_api_key"

Su Windows PowerShell:

$env:COMETAPI_KEY="your_api_key"

Passaggio 2: crea un video FLUX 3

L’attuale quickstart di FLUX 3 usa una richiesta multipart con model, prompt, seconds e size. Questo esempio richiede una clip di cinque secondi in 720p:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=flux-3" \
  -F "prompt=A paper boat glides across a still pond in soft morning light" \
  -F "seconds=5" \
  -F "size=1280x720"

Questa richiesta avvia un job. Non progettare l’applicazione aspettandosi di ricevere un MP4 finale nella stessa risposta HTTP.

Passaggio 3: salva l’ID del task

Conserva l’identificatore subito dopo che la richiesta di creazione ha avuto esito positivo:

{
  "id": "video_task_id",
  "status": "queued"
}

Archivia l’ID del task insieme all’utente o al record del job prima di iniziare il polling. Un riavvio del processo non dovrebbe perdere una generazione già fatturata.

Passaggio 4: esegui il polling dello stato del video

curl https://api.cometapi.com/v1/videos/{task_id} \
  -H "Authorization: Bearer $COMETAPI_KEY"

Inizia con un intervallo moderato, ad esempio dieci secondi. Considera completed, succeeded o success come stati di successo terminali; considera failed, failure, cancelled o canceled come failure terminali.

Passaggio 5: scarica l’MP4

curl https://api.cometapi.com/v1/videos/{task_id}/content \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output flux3_output.mp4

Dopo il completamento, copia il file nel tuo storage oggetti o pipeline media invece di mantenere un URL temporaneo del provider come asset permanente.

Workflow Python completo per la generazione video con FLUX 3

Il seguente esempio crea un job, salva il suo ID, effettua polling fino al termine, verifica gli stati di errore, valida la signature MP4 e scrive l’output su disco.

import os
import time
from pathlib import Path

import requests

api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files={
        "model": (None, "flux-3"),
        "prompt": (
            None,
            "A product bottle rotates slowly on wet black stone, "
            "soft rim lighting, macro lens, realistic reflections.",
        ),
        "seconds": (None, "5"),
        "size": (None, "1280x720"),
    },
    timeout=120,
)
response.raise_for_status()

task = response.json()
data = task.get("data") or {}
task_id = (
    task.get("id")
    or task.get("task_id")
    or data.get("id")
    or data.get("task_id")
)
if not task_id:
    raise RuntimeError(f"Create response has no task ID: {task}")

while True:
    response = requests.get(
        f"{base_url}/v1/videos/{task_id}",
        headers=headers,
        timeout=60,
    )
    response.raise_for_status()
    task = response.json()
    data = task.get("data") or {}
    status = str(task.get("status") or data.get("status") or "").lower()
    progress = task.get("progress") or data.get("progress") or "unknown"
    print(f"Status: {status or 'unknown'}; progress: {progress}")

    if status in {"failed", "failure", "cancelled", "canceled"}:
        raise RuntimeError(f"Video generation failed: {task}")
    if status in {"completed", "succeeded", "success"} or progress == "100%":
        break
    time.sleep(10)

response = requests.get(
    f"{base_url}/v1/videos/{task_id}/content",
    headers=headers,
    timeout=300,
)
response.raise_for_status()
video = response.content

if len(video) < 12 or video[4:8] != b"ftyp":
    raise RuntimeError("Content response is not a non-empty MP4 file")

output_dir = Path("output")
output_dir.mkdir(parents=True, exist_ok=True)
output_path = output_dir / f"{task_id}.mp4"
output_path.write_bytes(video)
print(f"Saved: {output_path} ({len(video)} bytes)")

Come usare image‑to‑video e i keyframe

La pagina FLUX 3 di CometAPI elenca image‑to‑video tra le funzionalità supportate. Il suo esempio pubblico attuale mostra testo‑a‑video, quindi verifica la documentazione live del gateway prima di presumere che un campo reference‑image copiato da un altro modello funzioni invariato.

L’API nativa BFL è esplicita: image‑to‑video usa mode i2v e il campo keyframes. Un’immagine blocca il frame iniziale, due immagini possono fissare inizio e fine, e fino a dieci immagini temporizzate possono storyboardare una clip continua.

Esempio di keyframe nativo BFL

curl -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v",
    "prompt": "They sprint through the lantern-lit alley as the camera tracks behind them.",
    "keyframes": [
      [0, "data:image/png;base64,<first-frame>"],
      [8, "data:image/png;base64,<last-frame>"]
    ],
    "duration": 8
  }'

Mantieni separati i parametri nativi del provider e quelli del gateway in adapter distinti. BFL usa campi come mode, keyframes, start_video, resolution e draft; l’esempio verificato di CometAPI usa model, prompt, seconds e size.

Parametri dell’API di FLUX 3 spiegati

Come scrivere prompt migliori per FLUX 3

La guida al prompting video di BFL raccomanda indicazioni chiare su soggetto e azione, camera, scena e atmosfera, qualità del movimento e continuità. Per scene guidate dall’audio, specifica dialogo, voce, effetti sonori e ambiente.

Una struttura pratica per i prompt

Subject + Environment + Action + Camera + Lighting
+ Dialogue/Voice + Sound Effects + Ambience + Constraints

Prompt cinematografico

A lone cyclist rides through a rain-soaked neon street at midnight.
The camera begins low beside the rear wheel, then rises into a smooth tracking shot.
Reflections stretch across wet asphalt under moving cyan and magenta light.
Audio: steady rainfall, chain noise, distant traffic, no music, no dialogue.
Keep the same rider, bicycle, jacket, and weather throughout the shot.

Prompt di prodotto

A premium stainless-steel espresso machine stands on a dark stone counter.
Begin with a macro close-up of water droplets on the metal housing.
Orbit clockwise as the machine brews; steam catches warm side light.
Finish on a clean three-quarter hero angle with the cup in the foreground.
Audio: pump vibration, steam hiss, ceramic contact, quiet cafe ambience.
Do not change the product shape, logo placement, material, or color.

Prompt con dialogo e audio nativo

A young chef works alone in a compact Tokyo ramen shop at night.
Start close on boiling broth, then pull back as the chef sets down a bowl.
Warm tungsten lighting, natural reflections, documentary handheld motion.
The chef quietly says in Japanese: 「お待たせしました。」
Audio: bubbling broth, soft rain outside, distant street traffic.
No subtitles and no background music.

Un prompt come “make a cinematic ramen shop video” lascia indefiniti movimento, inquadratura, suono e continuità. Un’indicazione esplicita produce un brief di produzione più verificabile.

Prezzi dell’API di FLUX 3

La tariffazione BFL è specifica per workflow: i render completi testo‑a‑video e immagine‑a‑video costano $0.17/s in HD o $0.29/s in FHD, con Draft Mode in HD a $0.06/s. La continuazione video costa $0.43/s in HD o $0.54/s in FHD, con draft HD a $0.12/s. CometAPI attualmente elenca flux-3 a $0.136/s per 720p e $0.232/s per 1080p. Verifica i prezzi live prima di un batch ampio.

Lettura delle ultime due colonne: i valori sono mostrati prima per HD/720p e poi per FHD/1080p.

Come ridurre i costi di iterazione

• Prototipa a 720p prima di passare il prompt selezionato a 1080p.
• Usa clip di cinque secondi per validare composizione, movimento e interpretazione del prompt.
• Cambia una sola variabile principale del prompt alla volta.
• Quando usi l’API nativa BFL, testa la Draft Mode prima di un render a piena qualità.
• Archivia i prompt riusciti e le decisioni di riferimento nei metadati dell’applicazione.

FLUX 3 vs Wan 3.0 vs Seedance 2.5

Confronta FLUX 3, Wan 3.0 e Seedance 2.5 per workflow anziché cercare un unico vincitore universale. I link alle specifiche autorevoli restano nell’intestazione della tabella seguente.

Nota sui prezzi: i prezzi di partenza non sono un confronto paritetico per qualità o risoluzione. Usa la tabella specifica per risoluzione nella pagina live di ciascun modello per il budget.

Quale Video API scegliere?

• Scegli FLUX 3 per movimento realistico, suono sincronizzato, logica multi‑shot, keyframe nativi o continuazione.
• Scegli Wan 3.0 quando il workflow inizia con molti tipi di input e serve una finestra di generazione di 30 secondi.
• Scegli Seedance 2.5 per narrazioni più lunghe e ricche di riferimenti, con forte controllo di identità, prodotto e stile.

Best practice di produzione per l’API di FLUX 3

Persisti i job asincroni come stato durevole

Salva l’ID del task immediatamente dopo l’invio. Un riavvio del server o il retry di un worker non dovrebbero costringere l’utente a pagare un’altra generazione perché l’app ha perso il task originale.

Evita il polling troppo ravvicinato

Inizia intorno ai dieci secondi, salvo raccomandazioni diverse nella documentazione live. Pollare ogni secondo aumenta la pressione di richieste senza migliorare sensibilmente l’esperienza.

Convalida il download

Controlla la lunghezza del contenuto e la signature MP4 prima di contrassegnare un asset come completo. Una risposta HTTP di successo non prova sempre che il body sia un video valido.

Separa gli schemi nativi e quelli del gateway

Mantieni adapter separati per richieste BFL‑native e CometAPI. Questo impedisce a campi nativi come mode, keyframes e start_video di finire in una chiamata gateway che si aspetta model, prompt, seconds e size.

Memorizza il contesto completo dell’errore

Logga status HTTP, body della risposta, ID del task, ID del modello, versione del prompt, size, durata e ID interno del job. Redigi la chiave API.

Usa un piccolo set di valutazione prima della messa in produzione

Costruisci 10–30 prompt rappresentativi che coprano movimento di camera, persone, prodotti, tipografia, dialoghi, scene ad alto movimento e aspect ratio richiesti. Esegui lo stesso set quando cambia versione del modello o dell’integrazione, e ripeti prompt importanti perché la generazione video è stocastica.

FAQ

Qual è l’ID modello di FLUX 3 su CometAPI?

L’ID modello attuale è flux-3.

Quale endpoint CometAPI usa FLUX 3?

Il flusso Video API verificato usa POST /v1/videos, seguito da GET /v1/videos/{task_id} e GET /v1/videos/{task_id}/content.

FLUX 3 è sincrono?

No. Trattalo come un job asincrono: invia, persisti l’ID del task, polla e scarica.

Per quanto tempo può generare FLUX 3?

BFL documenta 5–20 secondi per T2V/I2V e 5–15 secondi per continuazione.

FLUX 3 genera audio?

Sì. BFL documenta audio sincronizzato abilitato per impostazione predefinita nella sua API nativa.

FLUX 3 supporta image‑to‑video?

Sì. CometAPI elenca il supporto image‑to‑video, mentre l’API nativa BFL lo implementa tramite modalità i2v e keyframe.

Posso usare i keyframe BFL tramite CometAPI senza modifiche?

Non darlo per scontato. Gli schema di richiesta differiscono; verifica il quickstart CometAPI live prima di pubblicare un workflow di reference‑image via gateway.

Quanto costa un video FLUX 3 di cinque secondi su CometAPI?

Alle tariffe attualmente elencate su CometAPI, cinque secondi costano $0.68 a 720p o $1.16 a 1080p. Vedi la tabella prezzi consolidata sopra per il link live di riferimento.

FLUX 3 è migliore di Wan 3.0 o Seedance 2.5?

Dipende dal workflow. FLUX 3 è convincente per shot audiovisivi coerenti nel movimento e per controllo nativo con keyframe o continuazione; Wan 3.0 enfatizza l’ampiezza degli input; Seedance 2.5 enfatizza narrazioni più lunghe e ricche di riferimenti.

Conclusione

FLUX 3 ora ha un percorso Video API asincrono funzionante su CometAPI, mentre la documentazione nativa di BFL espone controlli più profondi per keyframe, continuazione, audio e Draft Mode.

Un percorso di integrazione sicuro è lineare: inizia con una richiesta breve in 720p da testo‑a‑video, persisti l’ID del task, polla con moderazione, scarica e valida l’MP4, quindi aggiungi template di prompt, storage, logica di retry e un set di valutazione ripetibile. Tieni separati gli schema nativi e quelli del gateway e verifica la pagina live del modello prima di fare hard‑code di campi o prezzi.