Utilisez l'API RunComfy pour exécuter blackforestlabs/flux-3/video. Pour les entrées et sorties acceptées, voir le schéma.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A powerful dappled-grey stallion gallops across a windswept green moor under a brooding storm sky, mane and tail streaming, clumps of turf kicking up in slow motion, distant thunder rumbling and hooves pounding the earth, cinematic low-angle tracking shot, moody desaturated color, anamorphic look."
}'Définissez la variable d'environnement YOUR_API_TOKEN avec votre clé API (gestion dans Profil) et incluez à chaque requête un jeton Bearer dans l'en-tête Authorization : Authorization: Bearer $YOUR_API_TOKEN.
Soumettez une tâche de génération asynchrone et recevez immédiatement un request_id ainsi que des URLs pour le statut, les résultats et l'annulation.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A powerful dappled-grey stallion gallops across a windswept green moor under a brooding storm sky, mane and tail streaming, clumps of turf kicking up in slow motion, distant thunder rumbling and hooves pounding the earth, cinematic low-angle tracking shot, moody desaturated color, anamorphic look."
}'Récupère l'état actuel pour un request_id (« in_queue », « in_progress », « completed » ou « cancelled »).
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Récupère les sorties finales et métadonnées pour le request_id ; si le travail n'est pas terminé, la réponse indique l'état actuel pour poursuivre le polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Annule un travail en file d'attente via request_id ; les travaux en cours ne peuvent pas être annulés.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Fournissez une URL HTTPS accessible publiquement. L'hôte doit autoriser les récupérations côté serveur (sans login/cookies), sans limitation de débit ni blocage des bots. Recommandé : images ≤ 50 Mo (~4K), vidéos ≤ 100 Mo (~2–5 min en 720p). Préférez des URL stables ou pré-signées pour les actifs privés.
{
"type": "object",
"title": "Schéma d'entrée",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Prompt textuel pour la vidéo (recommandation : environ 500 caractères maximum en chinois ou 1 000 mots maximum en anglais). ",
"type": "string",
"default": "A powerful dappled-grey stallion gallops across a windswept green moor under a brooding storm sky, mane and tail streaming, clumps of turf kicking up in slow motion, distant thunder rumbling and hooves pounding the earth, cinematic low-angle tracking shot, moody desaturated color, anamorphic look."
},
"images": {
"title": "Images",
"description": "Images de référence pour le mode de référence multimodal (0 à 9). Formats pris en charge : JPEG, PNG, WebP, BMP, TIFF et GIF.",
"type": "array",
"items": {
"type": "string",
"format": "image_uri"
},
"maxItems": 9
},
"videos": {
"title": "Vidéos",
"description": "Vidéos de référence pour le mode de référence multimodal (0 à 3). Formats pris en charge : MP4 et MOV. Chaque vidéo doit durer entre 2 et 15 secondes.",
"type": "array",
"items": {
"type": "string",
"format": "video_uri"
},
"maxItems": 3
},
"audios": {
"title": "URL audio",
"description": "Fichiers audio de référence pour le mode de référence multimodal (0 à 3). Formats pris en charge : WAV et MP3. Chaque fichier doit durer entre 2 et 15 secondes et peser moins de 15 Mo.",
"type": "array",
"items": {
"type": "string",
"format": "audio_uri"
},
"maxItems": 3
},
"aspect_ratio": {
"title": "Format d’image (L:H)",
"description": "Le réglage par défaut est adaptatif : le modèle choisit le format le plus proche et le format réel est renvoyé lors de la consultation de la tâche.",
"type": "string",
"enum": [
"adaptive",
"16:9",
"9:16",
"4:3",
"3:4",
"1:1",
"21:9"
],
"default": "adaptive"
},
"duration": {
"title": "Durée (secondes)",
"description": "Nombre entier de secondes compris dans l’intervalle [4, 15].",
"type": "integer",
"minimum": 4,
"maximum": 15,
"default": 5
},
"resolution": {
"title": "Résolution",
"description": "",
"type": "string",
"enum": [
"480p",
"720p",
"1080p",
"4k"
],
"default": "720p"
},
"generate_audio": {
"title": "Générer l’audio",
"description": "Lorsque cette option est activée, le modèle produit une vidéo avec un son synchronisé (voix, effets sonores et musique). ",
"type": "boolean",
"default": true
},
"seed": {
"title": "Graine",
"description": "Graine aléatoire utilisée pour générer la vidéo. ",
"type": "integer"
},
"tools": {
"title": "Recherche Web",
"description": " Lorsque `web_search` est activé, le modèle peut effectuer une recherche en ligne en fonction du prompt, par exemple sur un produit précis ou la météo actuelle. Les informations peuvent ainsi être plus à jour, au prix d’un temps de traitement plus long. ",
"type": "boolean",
"default": false
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "URL d'une seule image"
},
"video": {
"type": "string",
"format": "uri",
"description": "URL d'une seule vidéo"
},
"images": {
"type": "array",
"description": "plusieurs URLs d'images",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "plusieurs URLs de vidéos",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy est la première ComfyUI plateforme, offrant des ComfyUI en ligne environnement et services, ainsi que des workflows ComfyUI proposant des visuels époustouflants. RunComfy propose également AI Models, permettant aux artistes d'utiliser les derniers outils d'IA pour créer des œuvres d'art incroyables.