Come si usa l'API di FLUX.3 Video? Tutorial in cinese su text-to-video, image-to-video e continuazione video

TL;DR

• FLUX.3 Video è un modello video di Black Forest Labs; su HiAPI ha un solo nome modello, flux-3, e supporta contemporaneamente text-to-video, image-to-video (1–10 keyframe) e continuazione video, con clip da 5–20 secondi e audio sincronizzato incluso per impostazione predefinita. Apri la pagina del modello per generare online; i nuovi utenti ricevono 200 crediti alla registrazione.
• Fatturazione al secondo: 720p a $0.25 al secondo, 1080p a $0.42 al secondo; la modalità di anteprima Draft costa solo $0.09 al secondo. Un'anteprima Draft da 5 secondi costa $0.45.
• Quando metti a punto il prompt, attiva sempre prima draft: true: solo prompt è obbligatorio, ma anche senza specificare altri parametri verrà addebitata la tariffa standard.

Prima guarda il risultato

Esempio dalla pagina del modello, 720p, 5 secondi, con audio:

A silent maglev train glides through a vast solar-panel field at golden hour, reflective silver body catching warm directional light, low tracking shot alongside the train, distant maintenance drones crossing the sky, cinematic composition, rich cohesive color grade, premium commercial finish, subtle film grain, high dynamic range, smooth natural motion, stable cinematic camera movement, consistent lighting across frames

Genera con questo prompt → (5 secondi, 720p)

Esempio dalla pagina del modello flux-3, 720p, 5 secondi, con audio. Con la tariffa standard costa $1.25, con l'anteprima Draft $0.45.

Prezzi

Modalità	720p / secondo	1080p / secondo
Generazione standard (text-to-video, image-to-video)	$0.25	$0.42
Anteprima Draft	$0.09	Non supportato
Continuazione video (passando start_video)	$0.59	$0.76
Draft + continuazione video	$0.18	Non supportato

Prezzi attuali di HiAPI, verificati il 15 ottobre 2026. L'attivazione o meno dell'audio non influisce sul prezzo.

Durata	Draft 720p	Standard 720p	Standard 1080p
5 secondi	$0.45	$1.25	$2.10
10 secondi	$0.90	$2.50	$4.20
20 secondi	$1.80	$5.00	$8.40

Flusso consigliato: metti a punto prompt e movimento in Draft (a partire da $0.45 per clip), poi, una volta definito, genera in 720p o 1080p con la tariffa standard.

curl: esegui prima un Draft

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3",
    "input": {
      "prompt": "一架纸飞机滑过洒满阳光的办公室，慢动作，镜头跟随",
      "duration": 5,
      "aspect_ratio": "16:9",
      "draft": true
    }
  }'

Draft da 5 secondi, $0.45. Dopo aver ricevuto il taskId, controlla il risultato:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Quando status è success, scarica il video da output[0].url; l'audio è già incluso nello stesso MP4.

Python: invio, polling, download

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(timeout_s=900, **params):
    body = {"model": "flux-3", "input": params}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 定稿后出正式 1080p
url = generate(
    prompt="一架纸飞机滑过洒满阳光的办公室，慢动作，镜头跟随",
    duration=8, resolution="1080p", aspect_ratio="16:9",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Questo clip da 8 secondi in 1080p costa $3.36.

Image-to-video: 1 primo frame oppure fino a 10 keyframe

Aggiungi images (non image_urls) in input; l'utilizzo dipende dal numero di immagini:

• 1 immagine: primo frame.
• 2 immagini: primo frame + ultimo frame; il modello riempie la transizione intermedia.
• 3–10 immagini: storyboard di keyframe, distribuiti uniformemente lungo l'intero video.

{
  "model": "flux-3",
  "input": {
    "prompt": "从日出平滑过渡到霓虹闪烁的夜晚城市，镜头稳定",
    "images": [
      "https://your-cdn.example.com/start.webp",
      "https://your-cdn.example.com/end.webp"
    ],
    "resolution": "1080p",
    "duration": 8
  }
}

Le immagini supportano PNG, JPEG, WebP. Image-to-video e text-to-video hanno lo stesso prezzo.

Continuazione video: proseguire da un video esistente

Passa start_video e il modello continuerà la generazione dalla fine di quel video:

{
  "model": "flux-3",
  "input": {
    "prompt": "镜头继续向前推进，列车驶入明亮的山间隧道",
    "start_video": "https://your-cdn.example.com/source.mp4",
    "duration": 5,
    "draft": true
  }
}

• start_video supporta solo MP4, massimo 15 secondi, massimo 50 MB.
• images e start_video non possono essere passati contemporaneamente.
• La continuazione ha un prezzo unitario più alto: 720p a $0.59 al secondo, continuazione Draft a $0.18 al secondo.

Panoramica dei parametri

Parametro	Valori	Descrizione
prompt	stringa, obbligatorio	Scena, azione, movimento di camera, dialoghi e audio vanno scritti qui
duration	intero da 5 a 20, predefinito 5	Unità: secondi
resolution	720p / 1080p, predefinito 720p	Draft supporta solo 720p; Draft con 1080p viene rifiutato
aspect_ratio	auto 21:9 2:1 16:9 4:3 1:1 3:4 9:16, predefinito auto
draft	predefinito false	Modalità di anteprima a basso costo
generate_audio	predefinito true	Disattivandolo si ottiene un video senza audio, il prezzo non cambia
images	fino a 10	Image-to-video
start_video	URL MP4	Continuazione video

Note prima della messa in produzione

• Usa i callback invece del polling: aggiungi al livello superiore della richiesta (stesso livello di input) "callback": {"url": "https://tuo-dominio/hiapi/callback"} e deduplica in base a taskId.
• Salva subito: output[0].url è un link temporaneo; appena ottenuto, salvalo nel tuo storage.
• Riprova con la chiave di idempotenza: aggiungi l'header Idempotency-Key; riprovando con la stessa chiave viene creato un solo task e non vengono addebitati costi doppi.
• Rimborso automatico in caso di errore: viene addebitato solo il video generato con successo.

Domande frequenti

Quanto può durare al massimo una clip?

20 secondi. Per una durata maggiore, usa la continuazione video per proseguire la generazione.

Si può disattivare l'audio? Costa meno?

Sì, con generate_audio: false. Il prezzo dipende solo da risoluzione, Draft e presenza di continuazione; disattivare l'audio non riduce il costo.

Quanto costa in meno il Draft rispetto alla modalità standard?

720p a $0.09 contro $0.25 al secondo: Draft costa circa il 64% in meno ed è anche più veloce, ideale per mettere a punto i prompt.

Perché il nome del modello non ha il suffisso /text-to-video?

FLUX.3 unisce text-to-video, image-to-video e continuazione in un unico flux-3, distinguendoli in base alla presenza o meno di images e start_video.

Se vuoi provarne una clip, vai alla pagina del modello per generare. Per confrontare i prezzi di altri modelli video, consulta la pagina dei prezzi.