Comment utiliser l'API vidéo FLUX.3 ? Tutoriel en chinois sur le texte-vers-vidéo, l'image-vers-vidéo et la continuation vidéo

TL;DR

• FLUX.3 Video est un modèle vidéo de Black Forest Labs ; sur HiAPI, il n'y a qu'un seul nom de modèle, flux-3, qui prend en charge à la fois le texte-vers-vidéo, l'image-vers-vidéo (1 à 10 images clés) et la continuation vidéo, pour des clips de 5 à 20 secondes avec, par défaut, une piste audio synchronisée. Ouvrez la page du modèle pour générer en ligne ; les nouveaux utilisateurs reçoivent 200 crédits à l'inscription.
• Facturation à la seconde : 720p à $0.25 par seconde, 1080p à $0.42 par seconde ; le mode aperçu Draft ne coûte que $0.09 par seconde. Un aperçu Draft de 5 secondes coûte $0.45.
• Pour ajuster un prompt, activez toujours d'abord draft: true : seul le champ prompt est obligatoire, mais si vous ne renseignez rien d'autre, la facturation se fait au tarif standard.

Voir d'abord le résultat

Exemple de la page du modèle, 720p, 5 secondes, avec son :

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

Générer avec ce prompt → (5 secondes, 720p)

Exemple de la page du modèle flux-3, 720p, 5 secondes, avec son. Au tarif standard : $1.25 ; avec l'aperçu Draft : $0.45.

Prix

Mode	720p / seconde	1080p / seconde
Génération standard (texte, image)	$0.25	$0.42
Aperçu Draft	$0.09	Non pris en charge
Continuation vidéo (avec start_video)	$0.59	$0.76
Draft + continuation vidéo	$0.18	Non pris en charge

Tarif actuel de HiAPI, vérifié le 15 octobre 2026. Activer ou non le son n'affecte pas le prix.

Durée	Draft 720p	Standard 720p	Standard 1080p
5 secondes	$0.45	$1.25	$2.10
10 secondes	$0.90	$2.50	$4.20
20 secondes	$1.80	$5.00	$8.40

Flux recommandé : ajustez le prompt et les mouvements en Draft (à partir de $0.45 par clip), puis générez la version finale en 720p ou 1080p au tarif standard.

curl : lancez d'abord 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 de 5 secondes, $0.45. Après réception du taskId, récupérez le résultat :

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

Une fois que status vaut success, téléchargez la vidéo depuis output[0].url ; le son est déjà intégré dans le même fichier MP4.

Python : soumission, polling, téléchargement

# 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)

Ce clip de 8 secondes en 1080p coûte $3.36.

Image-vers-vidéo : 1 première image, ou jusqu'à 10 images clés

Ajoutez images dans input (et non image_urls) ; l'usage dépend du nombre d'images :

• 1 image : première image.
• 2 images : première image + dernière image, le modèle génère la transition intermédiaire.
• 3 à 10 images : storyboard d'images clés, réparties uniformément sur toute la vidéo.

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

Les images peuvent être au format PNG, JPEG ou WebP. L'image-vers-vidéo est au même prix que le texte-vers-vidéo.

Continuation vidéo : poursuivre une vidéo existante

Passez start_video ; le modèle continue la génération à partir de la fin de cette vidéo :

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

• start_video ne prend en charge que le MP4, 15 secondes maximum et 50 Mo maximum.
• images et start_video ne peuvent pas être transmis en même temps.
• La continuation coûte plus cher : 720p à $0.59 par seconde, continuation Draft à $0.18 par seconde.

Vue d'ensemble des paramètres

Paramètre	Valeurs	Description
prompt	chaîne de caractères, obligatoire	Scène, action, mouvement de caméra, dialogue et son s'écrivent ici
duration	entier de 5 à 20, valeur par défaut 5	en secondes
resolution	720p / 1080p, valeur par défaut 720p	Draft n'accepte que 720p ; Draft avec 1080p est refusé
aspect_ratio	auto 21:9 2:1 16:9 4:3 1:1 3:4 9:16, valeur par défaut auto
draft	valeur par défaut false	mode aperçu à bas prix
generate_audio	valeur par défaut true	désactivé, la vidéo est muette, sans changement de prix
images	10 images maximum	image-vers-vidéo
start_video	URL MP4	continuation vidéo

À vérifier avant la mise en production

• Préférez un callback au polling : au niveau racine de la requête (au même niveau que input), ajoutez "callback": {"url": "https://votre-domaine/hiapi/callback"}, puis dédupliquez par taskId.
• Copiez rapidement le fichier : output[0].url est un lien temporaire ; enregistrez-le aussitôt dans votre propre stockage.
• Retry avec clé d'idempotence : ajoutez l'en-tête Idempotency-Key ; une nouvelle tentative avec la même clé ne crée la tâche qu'une seule fois, sans double facturation.
• Remboursement automatique en cas d'échec : seules les vidéos générées avec succès sont facturées.

Questions fréquentes

Quelle est la durée maximale d'un clip ?

20 secondes. Pour aller plus loin, utilisez la continuation vidéo pour poursuivre la génération.

Peut-on désactiver le son ? Est-ce moins cher ?

Oui, generate_audio: false. Le prix dépend uniquement de la résolution, du mode Draft et de la continuation ; désactiver le son ne réduit pas le prix.

Quel est l'écart entre Draft et le tarif standard ?

En 720p, $0.09 par seconde contre $0.25 : Draft est environ 64 % moins cher et génère plus vite, idéal pour ajuster les prompts.

Pourquoi le nom du modèle n'a-t-il pas le suffixe /text-to-video ?

FLUX.3 regroupe texte-vers-vidéo, image-vers-vidéo et continuation dans un seul flux-3, et distingue les usages selon que l'on transmet ou non images et start_video.

Pour essayer un premier clip, allez générer sur la page du modèle. Pour comparer les prix des autres modèles vidéo, consultez la page des tarifs.