Utilisez l'API RunComfy pour exécuter pixverse/pixverse-v6/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/pixverse/pixverse-v6/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A trail runner sprints along a red-rock canyon ridge at golden hour; dust kicks up behind each stride as the camera tracks from the side, athletic cinematic motion."
}'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/pixverse/pixverse-v6/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A trail runner sprints along a red-rock canyon ridge at golden hour; dust kicks up behind each stride as the camera tracks from the side, athletic cinematic motion."
}'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": "Invite",
"description": "Décrivez la scène, l'action, le mouvement de la caméra et la manière dont les références doivent guider le résultat.",
"type": "string",
"default": "A trail runner sprints along a red-rock canyon ridge at golden hour; dust kicks up behind each stride as the camera tracks from the side, athletic cinematic motion."
},
"images": {
"title": "Images de référence",
"description": "URL d'images utilisées pour guider des sujets, des objets ou une identité visuelle.",
"type": "array",
"default": [
"https://playgrounds-storage-public.runcomfy.net/tools/7445/media-files/input.webp"
],
"items": {
"type": "string",
"format": "image_uri"
},
"maxItems": 7
},
"videos": {
"title": "Vidéos de référence",
"description": "URL de vidéo facultatives utilisées pour guider le mouvement ou l'apparence ; Les analyses de référence vidéo utilisent le taux 2x documenté.",
"type": "array",
"items": {
"type": "string",
"format": "video_uri"
}
},
"aspect_ratio": {
"title": "Rapport hauteur/largeur",
"description": "Forme du cadre pour la vidéo générée.",
"type": "string",
"default": "16:9",
"enum": [
"16:9",
"4:3",
"1:1",
"3:4",
"9:16",
"2:3",
"3:2",
"21:9"
]
},
"resolution": {
"title": "Résolution",
"description": "Niveau de qualité de sortie affiché sous forme de résolution vidéo.",
"type": "string",
"default": "720p",
"enum": [
"360p",
"540p",
"720p",
"1080p"
]
},
"duration": {
"title": "Durée",
"description": "Durée de sortie demandée en secondes, de 1 à 15. L'API en amont peut utiliser 0 lorsque les références vidéo déterminent le timing ; l'interface utilisateur expose 1 à 15 pour le mode image uniquement.",
"type": "integer",
"default": 5,
"minimum": 1,
"maximum": 15
},
"generate_audio_switch": {
"title": "Générer de l'audio",
"description": "Générez une piste audio native facultative avec la vidéo.",
"type": "boolean",
"default": false
},
"seed": {
"title": "Semence",
"description": "Semence utilisée pour reproduire ou varier une génération.",
"type": "integer",
"default": 0
}
}
}{
"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.