Utilisez l'API RunComfy pour exécuter blackforestlabs/flux-3-max/image-to-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-max/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7473/media-files/ref-promo.webp",
"prompt": "She lowers her hand, turns toward the sea, and the ivory scarf lifts in the wind. A slow push-in. Dry grass shifts. Wind and one distant gull. No text."
}'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-max/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7473/media-files/ref-promo.webp",
"prompt": "She lowers her hand, turns toward the sea, and the ivory scarf lifts in the wind. A slow push-in. Dry grass shifts. Wind and one distant gull. No text."
}'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": [
"image_url",
"prompt"
],
"properties": {
"image_url": {
"title": "URL de l'image",
"description": "Démarrer l'image. PNG, JPEG ou WebP.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7473/media-files/ref-promo.webp"
},
"prompt": {
"title": "Prompt",
"description": "Décrivez ce qui devrait bouger après l'image de départ, y compris la caméra et le son.",
"type": "string",
"default": "She lowers her hand, turns toward the sea, and the ivory scarf lifts in the wind. A slow push-in. Dry grass shifts. Wind and one distant gull. No text."
},
"end_image_url": {
"title": "Fin de l'URL de l'image",
"description": "Dernière image optionnelle. PNG, JPEG ou WebP. Laissez vide pour que le clip se termine tout seul.",
"type": "string"
},
"aspect_ratio": {
"title": "Format d'image",
"description": "Forme du cadre de sortie. auto suit la première image.",
"type": "string",
"enum": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"default": "auto"
},
"resolution": {
"title": "Résolution",
"description": "Résolution de sortie. 720p est la valeur par défaut. 1080p est l'option la plus nette.",
"type": "string",
"enum": [
"720p",
"1080p"
],
"default": "720p"
},
"duration": {
"title": "Durée",
"description": "Durée du clip en secondes entières.",
"type": "integer",
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20
],
"default": 5
},
"generate_audio": {
"title": "Générer de l'audio",
"description": "Créez une piste audio avec la vidéo. Désactivez ceci pour un clip silencieux.",
"type": "boolean",
"default": true
},
"reasoning_level": {
"title": "Niveau de raisonnement",
"description": "low revient plus tôt. high passe plus de temps sur l'invite et est plus lent.",
"type": "string",
"enum": [
"low",
"high"
],
"default": "high"
},
"seed": {
"title": "Seed",
"description": "Optionnel. Laissez vide et le modèle choisira une graine aléatoire.",
"type": "integer"
}
}
}{
"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.