Comment utiliser l’API FLUX 3 : guide complet pour les développeurs

Réponse rapide

FLUX 3 est le modèle vidéo multimodal de Black Forest Labs pour la génération texte-vers-vidéo et image-vers-vidéo avec audio synchronisé. Sur CometAPI, l’ID de modèle en production est flux-3. Le flux asynchrone vérifié utilise POST /v1/videos pour créer une tâche, GET /v1/videos/{task_id} pour l’interroger, et GET /v1/videos/{task_id}/content pour télécharger le MP4 terminé.

Mise à jour de la disponibilité (vérifiée le 24 septembre 2026) : Black Forest Labs a dépassé la phase d’accès anticipé de juillet pour FLUX 3 Video et a rendu disponible de manière générale la première version texte-vers-vidéo et image-vers-vidéo via l’API BFL et des partenaires sélectionnés le 4 août 2026. CometAPI a ajouté l’ID de modèle de production flux-3 dans son format d’API Vidéo le 13 août 2026. Utilisez l’annonce de sortie de BFL et la page modèle CometAPI en direct comme source de référence pour la disponibilité, les champs et les prix.

Qu’est-ce qui a changé depuis l’accès anticipé à FLUX 3 ?

Le changement important concerne la disponibilité opérationnelle. Les premières couvertures se concentraient sur le déploiement de juillet basé sur candidature, mais la sortie d’août de BFL a introduit un point de terminaison vidéo appelable, des contraintes publiées et une tarification de production. CometAPI a ensuite exposé flux-3 via son flux API Vidéo unifié.

L’article antérieur de CometAPI, FLUX 3 API : disponibilité, accès anticipé, vidéo & dev, reste utile pour l’historique du lancement et l’évaluation préliminaire de juillet. La comparaison plus large Meilleures API vidéo IA en 2026 couvre la sélection au niveau du marché. Ce guide garde ces sujets concis et se concentre sur les requêtes opérationnelles, le polling, les prompts, le contrôle des coûts et la gestion en production.

Qu’est-ce que FLUX 3 ?

FLUX 3 est la famille de modèles multimodaux de BFL pour la vidéo, l’audio, les images et la prédiction liée aux actions. La version vidéo actuelle prend en charge texte-vers-vidéo, image-vers-vidéo et continuation de vidéo via un point de terminaison natif au fournisseur.

Pour les développeurs vidéo, les capacités phares sont jusqu’à 20 secondes à 24 fps, sortie HD ou Full HD, audio synchronisé, parole multilingue avec synchronisation labiale, plusieurs plans dans une même génération, et jusqu’à dix images clés épinglées pour le contrôle image-vers-vidéo.

Spécifications de l’API FLUX 3

Quelle est la qualité de FLUX 3 Video ?

BFL rapporte un score Elo all-vs-all de 1135 pour texte-vers-vidéo dans son évaluation de préférence humaine. Dans la même comparaison publiée, FLUX 3 est à égalité avec Seedance 2.0 en préférence image-vers-vidéo et classé devant les autres modèles testés.

Ces résultats sont des éléments de positionnement utiles, mais ce sont des évaluations de préférence humaine menées par le fournisseur, pas un benchmark de production indépendant. Ils ne mesurent pas la latence de la passerelle, la fiabilité de la file d’attente, la constance des coûts ou la stabilité des générations répétées ; les équipes de production doivent donc toujours évaluer leur propre ensemble de prompts.

Performances de benchmark FLUX 3

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

Ce dont vous avez besoin avant d’utiliser l’API FLUX 3

• Un compte CometAPI et une clé API stockée dans une variable d’environnement backend.
• Un prompt qui définit le sujet, le mouvement, la direction de la caméra, l’atmosphère et l’audio ou les dialogues requis.
• Un chemin de gestion de tâches durable, car la génération vidéo est asynchrone.
• Assez de crédit pour des tests itératifs ; la facturation dépend de la durée et de la résolution générées.

Créez la clé dans le tableau de bord API de CometAPI. Ne la placez pas dans du JavaScript frontend, des bundles mobiles, des dépôts publics ou des captures d’écran.

ID de modèle et points de terminaison FLUX 3

Comment utiliser l’API FLUX 3 avec CometAPI

Étape 1 : Définir votre clé API

Sur macOS ou Linux :

export COMETAPI_KEY="your_api_key"

Sur Windows PowerShell :

$env:COMETAPI_KEY="your_api_key"

Étape 2 : Créer une vidéo FLUX 3

Le quickstart FLUX 3 actuel utilise une requête multipart avec model, prompt, seconds et size. Cet exemple demande un clip de cinq secondes en 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"

Cette requête lance un job. Ne concevez pas l’application autour de la réception d’un MP4 terminé dans la même réponse HTTP.

Étape 3 : Enregistrer l’ID de tâche

Conservez l’identifiant immédiatement après la réussite de la requête de création :

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

Stockez l’ID de tâche à côté de l’utilisateur ou du dossier de job avant que le polling ne commence. Un redémarrage de processus ne doit pas perdre une génération déjà facturée.

Étape 4 : Sonder l’état de la vidéo

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

Commencez avec un intervalle modéré comme dix secondes. Considérez completed, succeeded ou success comme des états finaux de réussite ; considérez failed, failure, cancelled ou canceled comme des échecs finaux.

Étape 5 : Télécharger le MP4

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

Après l’achèvement, copiez le fichier dans votre propre stockage d’objets ou pipeline média plutôt que de conserver une URL fournisseur temporaire comme actif permanent.

Flux Python complet pour la génération vidéo FLUX 3

L’exemple suivant crée un job, enregistre son ID, sonde jusqu’à l’achèvement, vérifie les états d’échec, valide la signature MP4 et écrit la sortie sur disque.

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

Comment utiliser image-vers-vidéo et les images clés

La page FLUX 3 de CometAPI mentionne la prise en charge image-vers-vidéo. Son exemple public actuel démontre texte-vers-vidéo ; vérifiez la documentation de la passerelle en direct avant de supposer qu’un champ d’image de référence copié d’un autre modèle fonctionnera tel quel.

L’API native de BFL est explicite : image-vers-vidéo utilise mode i2v et le champ keyframes. Une image épingle l’image de départ, deux images peuvent épingler le début et la fin, et jusqu’à dix images minutées peuvent scénariser un clip continu.

Exemple d’images clés natif 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
  }'

Conservez les paramètres natifs du fournisseur et de la passerelle dans des adaptateurs distincts. BFL utilise des champs tels que mode, keyframes, start_video, resolution et draft ; l’exemple vérifié de CometAPI utilise model, prompt, seconds et size.

Paramètres de l’API FLUX 3 expliqués

Comment écrire de meilleurs prompts FLUX 3

Le guide de prompting vidéo de BFL recommande une direction claire pour le sujet et l’action, la caméra, la scène et l’atmosphère, la qualité du mouvement, et la continuité. Pour les scènes menées par l’audio, spécifiez les dialogues, la voix, les effets sonores et l’ambiance.

Structure de prompt pratique

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

Prompt cinématographique

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 produit

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 de dialogue et audio natif

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 tel que « make a cinematic ramen shop video » laisse le mouvement, le cadrage, le son et la continuité non spécifiés. Une direction explicite produit un brief de production plus testable.

Tarification de l’API FLUX 3

La tarification BFL est spécifique au flux : les rendus complets texte-vers-vidéo et image-vers-vidéo coûtent 0,17 $/s en HD ou 0,29 $/s en FHD, avec le mode Draft HD à 0,06 $/s. La continuation de vidéo coûte 0,43 $/s en HD ou 0,54 $/s en FHD, avec des drafts HD à 0,12 $/s. CometAPI liste actuellement flux-3 à 0,136 $/s pour 720p et 0,232 $/s pour 1080p. Vérifiez les prix en direct avant un grand lot.

Lecture des deux dernières colonnes : les valeurs sont indiquées d’abord pour HD/720p puis pour FHD/1080p.

Comment réduire les coûts d’itération

• Prototyper en 720p avant de passer un prompt sélectionné en 1080p.
• Utiliser des clips de cinq secondes pour valider la composition, le mouvement et l’interprétation du prompt.
• Changer une variable majeure du prompt à la fois.
• Lors de l’utilisation de l’API native BFL, tester le mode Draft avant un rendu en pleine qualité.
• Stocker les prompts réussis et les décisions de référence dans les métadonnées de l’application.

FLUX 3 vs Wan 3.0 vs Seedance 2.5

Comparez FLUX 3, Wan 3.0 et Seedance 2.5 par flux de travail plutôt que de rechercher un gagnant universel. Les liens de spécification faisant autorité restent dans l’en-tête du tableau ci-dessous.

Note de tarification : les prix de départ ne sont pas une comparaison qualitative ou de résolution équivalente. Utilisez le tableau de résolution spécifique sur chaque page modèle en direct pour budgéter.

Quelle API vidéo choisir ?

• Choisissez FLUX 3 pour un mouvement réaliste, un son synchronisé, une logique multi-plans, des images clés natives ou la continuation.
• Choisissez Wan 3.0 quand le flux démarre avec de nombreux types d’entrée et qu’une fenêtre de génération de 30 secondes compte.
• Choisissez Seedance 2.5 pour une narration plus longue, riche en références, avec un fort contrôle d’identité, de produit et de style.

Bonnes pratiques de production pour l’API FLUX 3

Persister les jobs asynchrones comme état durable

Enregistrez l’ID de tâche immédiatement après la soumission. Un redémarrage serveur ou une relance de worker ne doit pas obliger l’utilisateur à payer pour une nouvelle génération parce que l’application a perdu la tâche originale.

Éviter un polling trop serré

Commencez près d’un intervalle de dix secondes, sauf recommandation contraire dans la documentation en direct. Sonder chaque seconde ajoute de la pression de requêtes sans améliorer sensiblement l’expérience.

Valider le téléchargement

Vérifiez la longueur du contenu et la signature MP4 avant de marquer un actif comme terminé. Une réponse HTTP réussie ne prouve pas toujours que le corps est une vidéo valide.

Séparer les schémas natifs et passerelle

Maintenez des adaptateurs distincts pour les requêtes natives BFL et CometAPI. Cela empêche des champs natifs tels que mode, keyframes et start_video de fuiter vers un appel passerelle qui attend model, prompt, seconds et size.

Stocker le contexte d’échec complet

Consignez le statut HTTP, le corps de réponse, l’ID de tâche, l’ID de modèle, la version du prompt, la taille, la durée et l’ID interne du job. Masquez la clé API.

Utiliser un petit ensemble d’évaluation avant la mise en production

Créez 10–30 prompts représentatifs couvrant le mouvement de caméra, les personnes, les produits, la typographie, les dialogues, les scènes à forte motion et les ratios d’image requis. Exécutez le même ensemble lorsqu’un modèle ou une version d’intégration change, et répétez les prompts importants car la génération vidéo est stochastique.

FAQ

Quel est l’ID de modèle FLUX 3 sur CometAPI ?

L’ID de modèle actuel est flux-3.

Quel point de terminaison CometAPI FLUX 3 utilise-t-il ?

Le flux API Vidéo vérifié utilise POST /v1/videos, suivi de GET /v1/videos/{task_id} et GET /v1/videos/{task_id}/content.

FLUX 3 est-il synchrone ?

Non. Traitez-le comme un job asynchrone : soumettre, persister l’ID de tâche, sonder et télécharger.

Combien de temps FLUX 3 peut-il générer ?

BFL documente 5–20 secondes pour T2V/I2V et 5–15 secondes pour la continuation.

FLUX 3 génère-t-il de l’audio ?

Oui. BFL documente un audio synchronisé activé par défaut dans son API native.

FLUX 3 prend-il en charge image-vers-vidéo ?

Oui. CometAPI liste la prise en charge image-vers-vidéo, tandis que l’API native de BFL l’implémente via le mode i2v et les images clés.

Puis-je utiliser les images clés BFL via CometAPI sans modification ?

Ne le supposez pas. Les schémas de requête diffèrent ; vérifiez le quickstart actuel de CometAPI avant de livrer un workflow de référence image via la passerelle.

Combien coûte une vidéo FLUX 3 de cinq secondes sur CometAPI ?

Aux tarifs actuellement listés par CometAPI, cinq secondes coûtent 0,68 $ en 720p ou 1,16 $ en 1080p. Voir le tableau de tarification consolidé ci-dessus pour le lien de référence en direct.

FLUX 3 est-il meilleur que Wan 3.0 ou Seedance 2.5 ?

Cela dépend du flux. FLUX 3 est convaincant pour des plans audiovisuels cohérents en mouvement et un contrôle natif d’images clés ou de continuation ; Wan 3.0 met l’accent sur l’ampleur des entrées ; Seedance 2.5 privilégie une narration plus longue, riche en références.

Conclusion

FLUX 3 dispose désormais d’un chemin API Vidéo asynchrone fonctionnel sur CometAPI, tandis que la documentation native de BFL expose des contrôles plus profonds pour les images clés, la continuation, l’audio et le mode Draft.

Un chemin d’intégration sûr est simple : commencez par une requête texte-vers-vidéo courte en 720p, persistez l’ID de tâche, sondez de manière conservatrice, téléchargez et validez le MP4, puis ajoutez des modèles de prompts, du stockage, une logique de retry et un ensemble d’évaluation répétable. Gardez les schémas natifs et passerelle séparés, et vérifiez la page du modèle en direct avant de figer des champs ou des prix.