Black Forest Labs
FLUX 3 Max
flux-3-max/text-to-video
Modèle de génération vidéo prenant en charge la génération à partir de texte et à partir d'image, axé sur une production rapide à faible latence ; selon les benchmarks publics, un clip de 10 secondes est généré en environ 11 à 12 secondes, ce qui le rend adapté à l'itération créative et aux contenus de vidéos courtes.
Essayer flux-3-max/text-to-video
Entrée
Créations
Voir toutes les créationsSortie
videoTarifs
flux-3-max/text-to-video per second
| Spécifications | Prix unitaire |
|---|---|
| 720P | $0.0608 |
| 1080P | $0.1036 |
Présentation
flux-3-max/text-to-video est la voie de génération vidéo du série flux-3-max destinée à une entrée purement textuelle : le développeur n'a qu'à soumettre une invite pour générer, selon la durée, la résolution et le format d'image spécifiés, un clip vidéo accompagné d'un audio synchronisé. Cette voie prend en charge des durées de 5 à 20 secondes, deux résolutions (720p et 1080p) et propose un réglage de l'intensité de raisonnement, afin d'arbitrer entre la restitution de scènes complexes et la latence de génération. Elle convient aux créateurs et aux équipes produit qui ont besoin de valider rapidement des concepts, de réaliser des storyboards et des courts métrages marketing ; l'appel passe par l'interface unifiée de HiAPI.ai, sans avoir à assembler plusieurs protocoles amont.
Points clés
- Une invite suffit pour produire une vidéo, sans matériel source — il suffit de soumettre une invite textuelle pour générer la vidéo, ce qui convient à l'exploration créative à partir de zéro comme à la production en série.
- Large plage de durée et de format — la durée peut être fixée entre 5 et 20 secondes, et huit formats sont disponibles, de 21:9 à 9:16, pour s'aligner directement sur les ratios des canaux de diffusion.
- Audio synchronisé natif — un audio synchronisé est généré par défaut avec la vidéo, ce qui évite l'étape séparée de doublage et de calage en post-production.
- Intensité de raisonnement réglable — reasoning_level propose deux niveaux, low et high ; high convient mieux aux scènes complexes, tandis que low privilégie la réduction du temps d'attente.
Description des capacités
Génération vidéo directement à partir de texte : une invite de 6000 caractères maximum constitue la seule entrée obligatoire, et le service renvoie un fichier vidéo complet, idéal pour transformer rapidement un script textuel en support animé prévisualisable.
Configuration de la durée et de la résolution : chaque génération peut spécifier une durée de 5 à 20 secondes et choisir entre 720p et 1080p, afin d'adapter la netteté et le budget de durée au support de diffusion.
Sortie multi-formats : huit ratios sont pris en charge — auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4 et 9:16 —, ce qui permet de produire des vidéos verticales courtes et des contenus grand écran sur la même voie.
Génération audio synchronisée : generate_audio est activé par défaut ; la piste audio synchronisée est produite en même temps que l'image, ce qui réduit les étapes de post-traitement.
Commutation de l'intensité de raisonnement de l'invite : reasoning_level contrôle la profondeur d'analyse de l'invite ; high est adapté aux scénarios de mise en scène complexes, low privilégie le débit.
Cas d'usage
- Validation de concepts de script par les équipes créatives — générer directement un court métrage à partir d'une idée textuelle pour les revues internes et le tri des pistes, en réduisant les allers-retours entre storyboard et rendu.
- Production de vidéos courtes marketing et pour les réseaux sociaux — générer en série des contenus vidéo produits et de marque aux ratios 9:16 ou 16:9, directement intégrables aux flux de diffusion et de montage.
- Prévisualisation de storyboard et production de brouillons — générer des séquences de 5 à 20 secondes avec des invites de niveau cinématographique, comme brouillon animé de référence avant la production finale.
- Expérimentation vidéo pour créateurs indépendants — grâce à l'intensité de raisonnement réglable et aux options multi-formats, tester à moindre coût différents styles visuels et rythmes.
Limites et conseils de choix
Cette voie n'accepte que du texte en entrée ; pour contraindre l'image à l'aide d'une image de référence, il faut se tourner vers la voie image-vers-vidéo ou image-clé de la même série. Les informations publiques couvrent principalement la spécification 720p et environ 10 secondes ; lorsque la description de l'invite est trop complexe ou que la durée s'allonge, il est conseillé de générer d'abord un petit lot pour vérifier que l'image et l'audio sont conformes. Les données de vitesse de génération des benchmarks publics proviennent de l'environnement côté fournisseur ; le temps réel dépend de l'invite, de la charge et des conditions de déploiement. Pour les projets exigeant une qualité d'image déterministe et une narration longue, il est recommandé d'évaluer un échantillon avant de passer à grande échelle.
Nouveautés
Voir le journal des modifications →- Nouveau modèle Le modèle de génération vidéo flux-3-max/text-to-video est disponible
- Mise à jour des prix Ajustement tarifaire de flux-3-max/text-to-video
- Mise à jour des prix Ajustement tarifaire de flux-3-max/image-to-video : nouveau prix de 0,0608 $
Questions fréquentes
Voir toutes les questions →-
Quelles entrées sont nécessaires pour FLUX 3 Max image-to-video ?
Les champs obligatoires sont prompt et image_url (image de première frame, formats PNG/JPEG/WebP pris en charge). Les champs facultatifs incluent end_image_url comme dernière frame, ainsi que duration, resolution, aspect_ratio, generate_audio et reasoning_level.
-
Peut-on définir la durée d'une vidéo ?
Oui. duration prend un entier compris entre 5 et 20 secondes, par pas de 1 seconde, avec une valeur par défaut de 5 secondes ; la génération vidéo à partir d'image et la génération vidéo à partir de texte partagent la même tarification à la seconde. Commencez par 5 secondes pour vérifier la stabilité de l'image source, puis augmentez la durée.
-
Qu'est-ce qui détermine le format d'image ?
aspect_ratio est par défaut sur auto, la sortie suit le ratio de l'image de la première frame ; vous pouvez aussi spécifier manuellement 21:9, 2:1, 16:9, 4:3, 1:1, 3:4 ou 9:16. En cas d'incohérence entre la spécification manuelle et le ratio de l'image, l'image peut être rognée.
-
Comment utiliser la dernière image ?
Passez la première image dans image_url et la dernière image dans end_image_url ; la vidéo effectuera une transition de la première à la dernière image. Dans le prompt, décrivez uniquement les changements qui se produisent entre les deux ; plus le cadrage et l'éclairage des deux images sont proches, plus la transition est fluide.
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.
Idempotency-KeystringOptionnelClé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.
En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.
Corps
modelstringRequisValeur fixe actuelle : flux-3-max/text-to-video
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour flux-3-max/text-to-video et la route default — voir le tableau des paramètres ci-dessous.
promptstringRequisminLength 1maxLength 6000Description textuelle de la vidéo à générer, qui détermine le contenu de l'image et l'évolution de la scène.
durationintegerOptionnelDéfaut: 5min 5max 20Durée de la vidéo de sortie, en secondes, comprise entre 5 et 20, valeur par défaut 5.
resolutionstringOptionnelDéfaut: "720p"Résolution de la vidéo de sortie, 720p par défaut.
720p1080paspect_ratiostringOptionnelDéfaut: "auto"Rapport largeur/hauteur de la vidéo de sortie, auto par défaut, c'est-à-dire qu'il suit l'image d'entrée.
auto21:92:116:94:31:13:49:16generate_audiobooleanOptionnelDéfaut: trueIndique s'il faut générer un audio synchronisé avec la vidéo, true par défaut.
reasoning_levelstringOptionnelDéfaut: "high"Contrôle l'intensité du raisonnement lors de l'analyse du prompt ; régler sur high peut améliorer le rendu des scènes complexes, mais augmente la latence ; high par défaut.
lowhighcallbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.
urlstringRequisObligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.
whenstringOptionnelDéfaut: "final"Seul final est pris en charge pour l'instant — notifié sur success et fail.
finalstoragestringOptionnelDéfaut: "temp"Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.
temppersistentExemples de requête
# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-3-max/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true,
"reasoning_level": "high"
}
}' 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-max/text-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true,
"reasoning_level": "high"
}
}),
});
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-max/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": True,
"reasoning_level": "high"
}
},
)
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"
} Obtenir le détail de la tâche
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
queued En file, pas encore démarrée.
handling En cours de traitement.
archiving Traitement terminé, préparation des artefacts.
success Terminal : terminé, artefacts disponibles (output renvoyé).
fail Terminal : échec (error renvoyé).
Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes Unix de l'état terminal ; 0 tant que non terminal.
outputarrayOptionnel
Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).
Array [ object ]
Éléments du tableau
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription de l'erreur.
Exemples de réponse
Succès
{
"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
}
]
}
} En cours (non terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Échec
{
"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"
}
}
} Articles
Voir tous les articles →-
Tutoriel
Comment utiliser kling-4.0/text-to-video via l'API HiAPI : curl, Python et un exemple de requête fonctionnel
Guide pratique pour les développeurs : prompts cinématographiques, audio synchronisé, interrogation asynchrone et téléchargement des sorties
-
Tutoriel
Comment appeler hailuo-2.3-fast/image-to-video via l'API HiAPI : curl et Python en pratique
La première requête exploitable du palier image-vers-vidéo rapide et économique — de l'ID du modèle au téléchargement du MP4
-
Tutoriel
Comment appeler hailuo-2.3/text-to-video via l'API HiAPI : curl, Python et exemples de requêtes exécutables
-
Tutoriel
Tutoriel pour kandinsky-6.0-pro/image-to-video sur HiAPI : curl + Python
Lancer une requête image-vers-vidéo exploitable sur HiAPI : de l'envoi de la première image à l'interrogation asynchrone jusqu'au téléchargement final
-
Tutoriel
Utiliser Kandinsky 6.0 Pro texte-vers-vidéo sur HiAPI : tutoriel curl et Python
Démonstration pratique axée sur la requête : construire l'appel du prompt au clip vidéo, soumettre la requête, interroger l'état d'achèvement et télécharger le résultat
-
Tutoriel
Comment appeler kling-4.0/image-to-video sur HiAPI : curl, Python et interrogation périodique
Modèles associés
Voir tous les modèles →Même type
-
Kandinsky 6.0 Pro $1.93 /vidéo -
Seedance 2.5 ByteDance $0.121 /seconde -
Hailuo 2.3 MiniMax $0.270 /vidéo -
Veo 3.1 Fast Google $0.170 /seconde -
Kling AI Avatar Kuaishou -- -
Grok Imagine 1.5 xAI $0.011 /seconde -
Gemini Omni 1.1 Flash Google $0.450 /vidéo -
Grok Imagine 1.5 Lite xAI $0.029 /seconde -
HappyHorse 1.0 Alibaba $0.168 /seconde -
Seedance 2.0 ByteDance $0.017 /seconde -
LTX 2.5 Fast Lightricks $0.086 /seconde -
Vidu Q3 Vidu $0.149 /seconde
Même fournisseur
-
FLUX.2 Klein 9B Black Forest Labs $0.0086 /image -
FLUX.1 Kontext Max Black Forest Labs $0.071 /image -
FLUX 3 Image Black Forest Labs $0.041 /image -
FLUX.1 Fill Pro Black Forest Labs $0.071 /image -
FLUX 1.1 Pro Black Forest Labs $0.050 /image -
FLUX 3 Video Black Forest Labs $0.090 /seconde -
FLUX.1 Schnell Black Forest Labs $0.005 /image -
FLUX.2 Black Forest Labs $0.035 /image -
FLUX 3 Max Black Forest Labs $0.061 /seconde -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /image