Utilisez l'API RunComfy pour exécuter minimax/minimax-h3/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/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
"reference_images": [
"https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
],
"aspect_ratio": "16:9",
"duration": 5,
"resolution": "2k"
}'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/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
"reference_images": [
"https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
],
"aspect_ratio": "16:9",
"duration": 5,
"resolution": "2k"
}'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",
"aspect_ratio",
"duration",
"resolution"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Description de la scène, des interactions, du mouvement et du style visuel. De 1 à 4000 caractères.",
"type": "string",
"default": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look."
},
"reference_images": {
"title": "Images de référence",
"description": "Images de référence qui guident le sujet, le produit, le style ou la composition. Jusqu’à 9. Au moins une image ou une vidéo de référence est obligatoire.",
"type": "array",
"default": [
"https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
],
"items": {
"type": "string",
"format": "image_uri"
},
"maxItems": 9
},
"reference_videos": {
"title": "Vidéos de référence",
"description": "Vidéos de référence qui guident le mouvement, le rythme ou les interactions. Jusqu’à 3. Au moins une image ou une vidéo de référence est obligatoire.",
"type": "array",
"items": {
"type": "string",
"format": "video_uri"
},
"maxItems": 3
},
"reference_audios": {
"title": "Fichiers audio de référence",
"description": "Fichiers audio de référence facultatifs. Jusqu’à 3. Ils ne peuvent pas être fournis sans image ou vidéo de référence.",
"type": "array",
"items": {
"type": "string",
"format": "audio_uri"
},
"maxItems": 3
},
"aspect_ratio": {
"title": "Rapport d’aspect",
"description": "Rapport d’aspect de la vidéo de sortie.",
"type": "string",
"enum": [
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"default": "16:9"
},
"duration": {
"title": "Durée",
"description": "Durée de la vidéo générée en secondes.",
"type": "integer",
"minimum": 5,
"maximum": 15,
"default": 5
},
"resolution": {
"title": "Résolution",
"description": "Résolution de la vidéo de sortie.",
"type": "string",
"enum": [
"2k"
],
"default": "2k"
}
}
}{
"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.