FLUX 3 API
L'API FLUX 3 de Black Forest Labs est disponible sur WaveSpeedAI avec des endpoints texte vers vidéo, image vers vidéo, vidéo image de début/fin, extension vidéo, Draft et upscale vidéo. Générez des clips de 5 à 20 secondes en 720P ou 1080P, avec audio synchronisé en option, via une seule API prête pour la production.
Ce guide de l'API FLUX 3 présente les endpoints WaveSpeedAI disponibles, les tarifs, les exemples, le flux d'intégration, les variantes Draft et les workflows vidéo de production. Le playground, les cartes d'endpoints, les tarifs, les exemples et les extraits d'API ci-dessous utilisent tous la famille black-forest-labs/flux-3 en production.
Présentation
À propos de FLUX 3 API
Ce que fait FLUX 3, sa place dans la gamme de modèles Black Forest Labs, et pourquoi les équipes l’adoptent.
FLUX 3 est un modèle de génération vidéo proposé par Black Forest Labs, disponible via l’API REST de WaveSpeedAI. L'API FLUX 3 de Black Forest Labs est disponible sur WaveSpeedAI avec des endpoints texte vers vidéo, image vers vidéo, vidéo image de début/fin, extension vidéo, Draft et upscale vidéo. Générez des clips de 5 à 20 secondes en 720P ou 1080P, avec audio synchronisé en option, via une seule API prête pour la production.
Ce guide de l'API FLUX 3 présente les endpoints WaveSpeedAI disponibles, les tarifs, les exemples, le flux d'intégration, les variantes Draft et les workflows vidéo de production. Le playground, les cartes d'endpoints, les tarifs, les exemples et les extraits d'API ci-dessous utilisent tous la famille black-forest-labs/flux-3 en production.
La famille FLUX 3 sur WaveSpeedAI propose 12 points d’accès REST couvrant les workflows Video-To-Video, Upscale-Video, Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. Chaque variante a ses propres tarifs, paramètres et exemples de résultats — choisissez celle qui correspond à votre type d’entrée et à vos contraintes de production, ou appelez-en plusieurs avec la même clé API pour composer des pipelines en plusieurs étapes.
Exécutez FLUX 3 avec la même clé API, le même compte de facturation et les mêmes limites de débit que pour les plus de 1 000 autres modèles IA de WaveSpeedAI. Pas de configuration fournisseur distincte, pas de SDK par fournisseur, pas de limites de débit par fournisseur — une seule intégration couvre tout, du texte vers image et du texte vers vidéo à la synthèse audio, la génération 3D, l’agrandissement et l’édition.
Caractéristiques
Capacités de FLUX 3 API et état de sortie
Les détails propres au modèle que les développeurs recherchent avant de choisir une API : disponibilité, durée de sortie attendue, prise en charge des références et alternative active actuelle.
Disponibilité
Disponible
Neuf endpoints FLUX 3 sont disponibles dans le catalogue WaveSpeedAI pour la génération, l'extension, l'itération en Draft et l'upscale vidéo, via le flux de prédiction REST standard.
Durée de la vidéo
5 à 20 secondes
Générez des clips de 5 à 20 secondes à partir de texte, d'une image source, d'images de début et de fin, ou prolongez une vidéo existante par une nouvelle suite.
Sortie
720P / 1080P
Les endpoints de génération standard prennent en charge la sortie 720P et 1080P avec audio synchronisé en option. L'upscale vidéo prend en charge une mise à l'échelle configurable de 1,5x à 3x.
Itération
Endpoints Draft
Les variantes Draft pour texte vers vidéo, image vers vidéo, start-end-to-video et extension vidéo offrent une voie moins coûteuse pour itérer sur le prompt et le mouvement.
Points d’accès
Tous les points d’accès de l’API FLUX 3
12 points d’accès FLUX 3 disponibles dès maintenant sur WaveSpeedAI — choisissez la variante qui correspond à votre workflow.
/filters:quality(82)/media/images/1789113620754515887_hYMV3cmw.webp)
Flux 3 Video Edit
FLUX 3 Video Edit applies prompt-guided changes to existing videos while preserving motion, timing, and framing, supporting precise video modification, visual style updates, scene refinements, creative edits, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1787298940011758698_4IrBKT1b.webp)
Flux 3 Video Upscale
FLUX Video Upscale enhances MP4 videos with source-faithful or creative detail reconstruction, configurable 1.5x to 3x scaling, and improved visual clarity for video restoration, social content, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1790921290885950224_DdmvFOAJ.webp)
Flux 3 Image Edit
FLUX 3 Image Edit transforms and combines up to 10 input images using natural-language instructions, with flexible 1K / 2K / 4K output for multi-image composition, visual refinements, creative edits, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1790921222365478560_RbW6fpyI.webp)
Flux 3 Text To Image
FLUX 3 Text-to-Image generates high-quality images from text prompts with detailed composition, strong typography, and flexible 1K / 2K / 4K output for creative visuals, marketing assets, product imagery, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1786251291501821218_QDkaw5jG.webp)
Flux 3 Video Extend Draft
FLUX 3 Video Extend Draft quickly continues a required input video into a draft clip with prompt-guided next-scene motion, optional synchronized audio, and flexible 5-20 second duration for rapid iteration.
/filters:quality(82)/media/images/1786251321454460317_x5e3clvE.webp)
Flux 3 Text To Video Draft
FLUX 3 Text-to-Video Draft generates short draft videos from text prompts with coherent motion, prompt-guided camera direction, optional synchronized audio, and pricing optimized for rapid iteration.
/filters:quality(82)/media/images/1786251351572590694_qiqJaC8C.webp)
Flux 3 Image To Video Draft
FLUX 3 Image-to-Video Draft quickly animates a required reference image into a draft clip with prompt-guided motion, optional synchronized audio, and flexible 5-20 second duration for rapid visual iteration.
/filters:quality(82)/media/images/1786251386747220978_8aWoJ0iz.webp)
Flux 3 Start End To Video Draft
FLUX 3 Start-End-to-Video Draft quickly generates a transition between required start and end images, with prompt-guided motion, optional synchronized audio, and flexible 5-20 second duration for rapid keyframe iteration.
/filters:quality(82)/media/images/1785952605637015407_SuDLV4DN.webp)
Flux 3 Text To Video
FLUX 3 Text-to-Video generates cinematic 5-20 second videos from text prompts, with coherent motion, cinematic composition, optional synchronized audio, and 720P / 1080P output for creative videos, social content, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785953660196858181_bUeDcy0o.webp)
Flux 3 Video Extend
FLUX 3 Video Extend continues input videos into new 5-20 second clips, using prompt guidance to control the next action, camera movement, visual style, motion continuity, and optional synchronized audio at 720P / 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785952695147978688_UKcluENW.webp)
Flux 3 Start End To Video
FLUX 3 Start-End-to-Video generates 5-20 second transition videos between required start and end images, using prompt guidance to control action, camera movement, visual style, motion continuity, and optional synchronized audio at 720P / 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785952675883482836_NxW5IR09.webp)
Flux 3 Image To Video
FLUX 3 Image-to-Video animates a required reference image into a 5-20 second video, preserving subject appearance while using prompt control to guide motion, camera movement, visual style, and optional synchronized audio at 720P / 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Exemples
FLUX 3 en action
De vrais résultats générés par l’API FLUX 3. Survolez une vidéo pour la prévisualiser, cliquez pour ouvrir la visionneuse en taille réelle.
Mode d’emploi
Comment utiliser l’API FLUX 3
Quatre étapes de l’inscription à une génération terminée. Des exemples complets en Python, Node.js et cURL se trouvent dans la section API ci-dessous.
- 01
Obtenez une clé API
Créez un compte WaveSpeedAI et copiez votre clé API depuis le tableau de bord. Les nouveaux comptes reçoivent des crédits de démarrage gratuits — de quoi utiliser le playground quelques dizaines de fois avant le début de la facturation.
- 02
Soumettez une prédiction
Envoyez votre entrée en JSON par POST à https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video. Le point d’accès renvoie immédiatement un identifiant de prédiction — les générations sont asynchrones, vous ne gardez donc pas de connexion ouverte pendant l’inférence.
- 03
Interrogez jusqu’à la fin
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Retournez les outputs sur completed ; arrêtez avec une erreur sur failed, cancelled, timeout ou deleted ; continuez d’interroger pour tout autre statut.
- 04
Lisez l’URL du résultat
Une fois le statut "completed", lisez l’URL dans data.outputs[0]. Elle pointe vers votre média généré sur le CDN de WaveSpeedAI — fichier image, vidéo, audio ou 3D selon la variante FLUX 3 appelée.
Cas d’usage
Ce que vous pouvez créer avec FLUX 3
Les workflows courants pour lesquels développeurs et créateurs utilisent l’API FLUX 3.
Texte vers vidéo avec audio synchronisé en option
Générez directement à partir de prompts des clips cinématographiques de 5 à 20 secondes, avec action, direction de caméra et composition maîtrisées, sortie en 720P ou 1080P et audio synchronisé en option.
Image vers vidéo avec continuité du sujet
Animez une image source obligatoire et utilisez le prompt pour guider le mouvement, les déplacements de caméra et le style visuel, sans avoir à reconstruire la composition de départ à partir de texte.
Transitions image de début/fin
Fournissez une image de début et une image de fin (obligatoires) pour générer une transition contrôlée entre des images clés validées, avec un prompt pour guider l'action, le trajet de caméra, le style et la continuité du mouvement.
Prolonger une vidéo existante
Prolongez une vidéo source avec un nouveau clip de 5 à 20 secondes. Décrivez la prochaine action, le mouvement de caméra et la direction visuelle : FLUX 3 reporte le mouvement dans la suite.
Workflow de production en Draft d'abord
Utilisez un endpoint Draft pour tester la direction du prompt, les images sources et le mouvement à moindre coût, puis passez l'entrée validée à l'endpoint standard correspondant pour une livraison en 720P ou 1080P.
Upscale vidéo et reconstruction des détails
Améliorez un MP4 avec une reconstruction des détails fidèle à la source ou créative, et une mise à l'échelle configurable de 1,5x à 3x, pour la restauration, la diffusion sur les réseaux sociaux et les exports de production.
Conseils
Conseils pour rédiger vos prompts avec FLUX 3
Des conseils pratiques pour obtenir de meilleurs résultats avec FLUX 3 — tirés des pratiques qui fonctionnent sur les modèles vidéo dans les pipelines de production.
- 01
Choisissez l'endpoint selon le matériau source
Utilisez texte vers vidéo pour un plan à partir d'un simple prompt, image vers vidéo lorsque la première frame est validée, start-end-to-video lorsque les deux frames limites sont fixées, et video-extend lorsque le nouveau clip doit prolonger des images existantes.
- 02
Prototypez en Draft avant le rendu de livraison
Des variantes Draft existent pour texte vers vidéo, image vers vidéo, start-end-to-video et l'extension vidéo. Validez d'abord la direction du prompt, les images sources et le mouvement, puis passez l'entrée validée à l'endpoint standard correspondant.
- 03
Décrivez séparément le mouvement et la direction de la caméra
Indiquez ce que fait le sujet, puis décrivez le mouvement de caméra, l'échelle du plan et le rythme. Expliciter l'action et la cinématographie donne au modèle un plan temporel plus clair pour un clip de 5 à 20 secondes.
- 04
Utilisez des frames de début et de fin pour des transitions maîtrisées
Lorsque les compositions d'ouverture et de clôture sont déjà validées, fournissez les deux images et concentrez le prompt sur la transition : mouvement du sujet, trajet de la caméra, changement d'environnement et manière d'atteindre la frame finale.
- 05
Agrandissez une fois la direction créative arrêtée
Utilisez video-upscale après avoir validé le rythme, le mouvement et la composition. Choisissez la reconstruction fidèle à la source lorsque la préservation de l'entrée compte, ou la reconstruction créative des détails lorsque la source a besoin de textures supplémentaires.
Tarifs
Tarifs de l’API FLUX 3
La tarification se fait par résultat. Le montant final dépend des paramètres définis dans le playground de chaque variante (résolution, durée, nombre de résultats, références).
| Point d’accès | Type | Prix de départ |
|---|---|---|
| black-forest-labs/ | video-to-video | $0.03 |
| black-forest-labs/ | upscale-video | $0.79 |
| black-forest-labs/ | image-to-image | $0.05 |
| black-forest-labs/ | text-to-image | $0.05 |
| black-forest-labs/ | video-extend | $0.12 |
| black-forest-labs/ | text-to-video | $0.06 |
| black-forest-labs/ | image-to-video | $0.06 |
| black-forest-labs/ | image-to-video | $0.06 |
| black-forest-labs/ | text-to-video | $0.17 |
| black-forest-labs/ | video-extend | $0.41 |
| black-forest-labs/ | image-to-video | $0.17 |
| black-forest-labs/ | image-to-video | $0.17 |
API
Appelez l’API FLUX 3
Obtenez une clé API sur wavespeed.ai/accesskey, puis soumettez une prédiction via REST. Le playground génère des exemples prêts à copier pour toute combinaison d’entrées.
POSThttps://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": True
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Comparer
FLUX 3 face aux alternatives
Quand choisir FLUX 3 plutôt que des modèles similaires sur WaveSpeedAI.
FLUX 3 vs Seedance 2.5
FLUX 3 propose des workflows texte, image, image de début/fin et extension de 5 à 20 secondes, ainsi que des endpoints Draft et d'upscale. Seedance 2.5 gère des clips jusqu'à 30 secondes, de plus grands lots de références et l'édition vidéo dédiée. Choisissez selon le matériau source et le workflow, plutôt que de considérer ces API comme interchangeables.
FLUX 3 vs Veo 3.1
Les deux familles prennent en charge la vidéo pilotée par prompt avec des variantes compatibles audio. FLUX 3 expose en plus les transitions image de début/fin, l'itération en Draft, l'extension vidéo et l'upscale vidéo dans une seule famille d'endpoints en production.
FLUX 3 vs Sora 2
FLUX 3 propose des endpoints explicites de 5 à 20 secondes pour le texte vers vidéo, l'image vers vidéo, l'image de début/fin, l'extension, le Draft et l'upscale. Comparez le format source requis, la durée et la résolution de livraison avant de choisir une famille.
FAQ
FLUX 3 API — Questions fréquentes
Tarifs, licence, intégration — les questions courantes sur l’utilisation de FLUX 3 sur WaveSpeedAI.
L'API FLUX 3 est-elle disponible sur WaveSpeedAI ?
Oui. Neuf endpoints black-forest-labs/flux-3 sont disponibles dans le catalogue WaveSpeedAI pour le texte vers vidéo, l'image vers vidéo, la vidéo image de début/fin, l'extension vidéo, l'itération en Draft et l'upscale vidéo.
Quel endpoint de l'API FLUX 3 dois-je utiliser ?
Utilisez texte vers vidéo pour un workflow à partir d'un simple prompt, image vers vidéo pour animer une image source, start-end-to-video pour relier deux images clés validées, video-extend pour prolonger un clip, une variante Draft pour itérer à moindre coût, ou video-upscale pour une amélioration de 1,5x à 3x.
Quelles durées et résolutions FLUX 3 prend-il en charge ?
Les endpoints de génération standard et d'extension prennent en charge des clips de 5 à 20 secondes en 720P ou 1080P, avec audio synchronisé en option. Les entrées requises varient selon l'endpoint : image vers vidéo exige une image source, start-end-to-video exige les deux images de début et de fin, et video-extend exige une vidéo source.
Comment intégrer l'API FLUX 3 ?
Utilisez le flux de prédiction WaveSpeedAI standard : authentifiez-vous avec votre clé API, envoyez en POST l'entrée propre à l'endpoint vers un chemin de modèle black-forest-labs/flux-3, puis interrogez l'identifiant de prédiction renvoyé jusqu'à ce que le résultat soit prêt. Le playground et les exemples de code de cette page montrent le schéma de requête actuel.
Qu’est-ce que l’API FLUX 3 ?
FLUX 3 est un modèle Black Forest Labs de génération vidéo exposé sous forme d’API REST sur WaveSpeedAI. L'API FLUX 3 de Black Forest Labs est disponible sur WaveSpeedAI avec des endpoints texte vers vidéo, image vers vidéo, vidéo image de début/fin, extension vidéo, Draft et upscale vidéo. Générez des clips de 5 à 20 secondes en 720P ou 1080P, avec audio synchronisé en option, via une seule API prête pour la production. Vous pouvez l’appeler par programmation ou l’essayer depuis le playground indiqué ci-dessus.
Comment appeler l’API FLUX 3 ?
Créez un compte WaveSpeedAI, copiez votre clé API depuis /accesskey, puis envoyez votre entrée en JSON par POST à https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video. Le point d’accès renvoie un identifiant de prédiction. Interrogez le point d’accès de résultat environ toutes les 2 secondes, augmentez l’intervalle pour les tâches longues et arrêtez-vous à tout statut final. Des exemples Python / Node.js / cURL orientés production figurent ci-dessus.
Combien coûte l’API FLUX 3 ?
FLUX 3 démarre à $0.03 par exécution. Le coût exact dépend des paramètres définis (résolution, durée, nombre de résultats, références). L’estimation en direct à côté du bouton Générer dans le playground affiche le prix exact pour votre saisie actuelle.
Quelles variantes de FLUX 3 sont disponibles ?
WaveSpeedAI héberge 12 points d’accès FLUX 3 actifs : black-forest-labs/flux-3/video-edit, black-forest-labs/flux-3/video-upscale, black-forest-labs/flux-3/image-edit, black-forest-labs/flux-3/text-to-image, black-forest-labs/flux-3/video-extend-draft, black-forest-labs/flux-3/text-to-video-draft, black-forest-labs/flux-3/image-to-video-draft, black-forest-labs/flux-3/start-end-to-video-draft, et d’autres. Chaque variante a sa propre page playground et ses propres tarifs.
Puis-je utiliser commercialement les résultats de FLUX 3 ?
Les droits d’usage commercial suivent la licence du modèle Black Forest Labs. La plupart des modèles Black Forest Labs autorisent l’usage commercial des résultats ; consultez la page playground de chaque modèle pour le résumé de sa licence, et les Conditions d’utilisation de WaveSpeedAI pour les conditions au niveau de la plateforme.
Pourquoi utiliser FLUX 3 sur WaveSpeedAI plutôt qu’en direct ?
Une seule clé API et un seul compte de facturation pour FLUX 3 ET plus de 1 000 autres modèles IA d’autres fournisseurs. Pas de configuration de SDK par fournisseur, pas de limites de débit distinctes, pas de code d’intégration à réécrire pour chaque fournisseur. Les tarifs sont généralement au niveau de l’API directe de Black Forest Labs, ou en dessous.
Fournisseur
À propos de Black Forest Labs
L’équipe derrière FLUX 3 et la gamme plus large de modèles Black Forest Labs sur WaveSpeedAI.
Black Forest Labs a créé la famille FLUX de modèles d'image open-weight. FLUX.2 [klein] propose des endpoints texte vers image et édition en 4B et 9B avec un réalisme accru, un rendu de texte plus net et la prise en charge native de LoRA — une alternative économique aux variantes FLUX plus grandes pour les pipelines d'images à gros volume.
Commencez à créer avec FLUX 3 sur WaveSpeedAI
Crédits de démarrage gratuits à l’inscription. Une seule clé API pour plus de 1 000 modèles IA de Black Forest Labs et de tous les autres fournisseurs.