Utilisez l'API RunComfy pour exécuter minimax/minimax-h3-open/reference-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/minimax/minimax-h3-open/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Use the woman from the reference image and keep her identity, hair, and emerald-green blazer. [0s-3s] she stands in a rainy neon alley and slowly lifts her gaze to camera as sign light flickers across her face. [3s-6s] she turns her shoulder and a faint smile forms while the camera pushes in and holds. Camera: slow dolly-in then hold, no cuts. Audio: soft night rain, distant city hum, low synth pad. No extra people, no text, no watermark.",
"reference_images": [
"https://playgrounds-storage-public.runcomfy.net/tools/7412/media-files/ref-promo.webp"
]
}'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/minimax/minimax-h3-open/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Use the woman from the reference image and keep her identity, hair, and emerald-green blazer. [0s-3s] she stands in a rainy neon alley and slowly lifts her gaze to camera as sign light flickers across her face. [3s-6s] she turns her shoulder and a faint smile forms while the camera pushes in and holds. Camera: slow dolly-in then hold, no cuts. Audio: soft night rain, distant city hum, low synth pad. No extra people, no text, no watermark.",
"reference_images": [
"https://playgrounds-storage-public.runcomfy.net/tools/7412/media-files/ref-promo.webp"
]
}'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",
"reference_images"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Décrivez la scène, le mouvement, la caméra et une ligne Audio :. Nommez ce que chaque référence fournit (identité, style, mouvement ou voix).",
"type": "string",
"default": "Use the woman from the reference image and keep her identity, hair, and emerald-green blazer. [0s-3s] she stands in a rainy neon alley and slowly lifts her gaze to camera as sign light flickers across her face. [3s-6s] she turns her shoulder and a faint smile forms while the camera pushes in and holds. Camera: slow dolly-in then hold, no cuts. Audio: soft night rain, distant city hum, low synth pad. No extra people, no text, no watermark."
},
"reference_images": {
"title": "Images de référence",
"description": "Jusqu'à 9 URL d'images de référence guidant le sujet, le produit, le style ou la composition. Au moins une image ou vidéo de référence est requise.",
"type": "array",
"default": [
"https://playgrounds-storage-public.runcomfy.net/tools/7412/media-files/ref-promo.webp"
],
"items": {
"type": "string",
"format": "image_uri"
},
"maxItems": 9
},
"reference_videos": {
"title": "Vidéos de référence",
"description": "Jusqu'à 3 URL vidéo de référence guidant le mouvement ou le rythme. Disponible en sortie 480p uniquement ; leurs bandes sonores sont utilisées automatiquement.",
"type": "array",
"items": {
"type": "string",
"format": "video_uri"
},
"maxItems": 3
},
"reference_audios": {
"title": "Audios de référence",
"description": "Jusqu'à 3 URL audio de référence (chacune réduite à 15 s). Ne peut être fourni sans une référence image ou vidéo.",
"type": "array",
"items": {
"type": "string",
"format": "audio_uri"
},
"maxItems": 3
},
"aspect_ratio": {
"title": "Format d'image",
"description": "Rapport hauteur/largeur de sortie.",
"type": "string",
"enum": [
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16",
"9:21"
],
"default": "16:9"
},
"resolution": {
"title": "Résolution",
"description": "Résolution de sortie. 480p est plus rapide/moins cher ; 768p est le canevas natif. Les vidéos de référence nécessitent 480p.",
"type": "string",
"enum": [
"480p",
"768p"
],
"default": "480p"
},
"duration": {
"title": "Durée",
"description": "Durée de la vidéo générée en secondes (5-15).",
"type": "integer",
"minimum": 5,
"maximum": 15,
"default": 5
},
"seed": {
"title": "Seed",
"description": "Graine fixe pour des résultats reproductibles. Utilisez -1 pour une graine aléatoire.",
"type": "integer",
"default": -1
}
}
}{
"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.