Utilisez l'API RunComfy pour exécuter alibaba/happyhorse-1.1/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/alibaba/happyhorse-1.1/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
"prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
}'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/alibaba/happyhorse-1.1/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
"prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
}'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_1",
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Décrivez la scène, l’action, le mouvement de caméra et l’atmosphère à créer autour des images de référence. Maximum : 5000 caractères non chinois ou 2500 caractères chinois ; les saisies plus longues sont tronquées.",
"type": "string",
"default": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit.",
"maxLength": 5000
},
"ratio": {
"title": "Rapport d’aspect",
"description": "Format d’image de la vidéo générée.",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
],
"default": "16:9"
},
"duration": {
"title": "Durée",
"description": "Durée de la vidéo générée en secondes. Valeurs autorisées : 3-15.",
"type": "integer",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"default": 5
},
"image_url_1": {
"title": "Image de référence 1",
"description": "Image de référence principale dont le sujet, le style ou la composition guide la vidéo. Formats : JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp"
},
"image_url_2": {
"title": "Image de référence 2",
"description": "Image de référence supplémentaire facultative. Formats : JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_3": {
"title": "Image de référence 3",
"description": "Image de référence supplémentaire facultative. Formats : JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_4": {
"title": "Image de référence 4",
"description": "Image de référence supplémentaire facultative. Formats : JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_5": {
"title": "Image de référence 5",
"description": "Image de référence supplémentaire facultative. Formats : JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_6": {
"title": "Image de référence 6",
"description": "Image de référence supplémentaire facultative. Formats : JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_7": {
"title": "Image de référence 7",
"description": "Image de référence supplémentaire facultative. Formats : JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_8": {
"title": "Image de référence 8",
"description": "Image de référence supplémentaire facultative. Formats : JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"image_url_9": {
"title": "Image de référence 9",
"description": "Image de référence supplémentaire facultative. Vous pouvez combiner jusqu’à 9 images de référence. Formats : JPEG, JPG, PNG ou WEBP.",
"type": "string",
"default": ""
},
"resolution": {
"title": "Résolution",
"description": "Résolution de la vidéo générée. Happy Horse 1.1 reference to video prend en charge 720P et 1080P.",
"type": "string",
"enum": [
"720P",
"1080P"
],
"default": "1080P"
},
"seed": {
"title": "Seed",
"description": "Seed facultatif pour obtenir des résultats reproductibles. Avec 0, le fournisseur choisit une valeur aléatoire.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"default": 0
},
"watermark": {
"title": "Filigrane",
"description": "Indique si le filigrane du fournisseur doit être conservé sur la vidéo générée.",
"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.