Skip to main content

Édition vidéo 2.1

Le modèle d'édition vidéo universelle Wanxiang prend en charge les entrées multimodales (texte, image et vidéo) et offre cinq capacités principales : référence multi-images, repeinture vidéo, édition locale, extension vidéo et outpainting vidéo .

Périmètre d'application

  • Les modèles pris en charge varient selon la région. Les ressources sont isolées entre les régions. Pour consulter les modèles disponibles dans chaque région, reportez-vous à la console Model Studio.
  • Lors de l'appel, assurez-vous que votre modèle, votre URL d'endpoint et votre clé API appartiennent tous à la même région. Les appels interrégionaux échouent systématiquement.
Les exemples de code de cette rubrique s'appliquent à la région Singapour.

Capacités principales

Référence multi-images

Présentation de la fonctionnalité : Prise en charge de 3 images de référence maximum, pouvant inclure des sujets et des arrière-plans (personnes, animaux, vêtements, scènes, etc.). Le modèle fusionne plusieurs images pour générer un contenu vidéo cohérent. Paramètres :
  • function : Définissez cette valeur sur image_reference.
  • ref_images_url : Tableau d'URL. Fournissez de 1 à 3 images de référence.
  • obj_or_bg : Identifie chaque image comme sujet (obj) ou arrière-plan (bg). La longueur doit correspondre à celle de ref_images_url.
Prompt d'entréeImage de référence 1 (sujet de référence)Image de référence 2 (arrière-plan de référence)Vidéo générée
Dans la vidéo, une jeune fille sort des profondeurs d'une forêt ancienne et brumeuse. Ses pas sont légers et la caméra capture chacun de ses mouvements gracieux. Lorsqu'elle s'arrête pour observer les bois luxuriants qui l'entourent, un sourire de surprise et de joie illumine son visage. Cet instant, figé dans un jeu d'ombre et de lumière, immortalise sa merveilleuse rencontre avec la nature.
image
image
Avant d'effectuer un appel, vous devez d'abord obtenir une clé API, puis configurer la clé API comme variable d'environnement (à dépublier et fusionner dans Configurer la clé API).
  • curl
  • Python
  • Java
Étape 1 : Créer une tâche pour obtenir un ID de tâche
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wan2.1-vace-plus",
    "input": {
        "function": "image_reference",
        "prompt": "In the video, a girl gracefully emerges from a misty, ancient forest. Her steps are light, and the camera captures her every nimble moment. When she stops to look at the lush woods around her, a smile of surprise and joy blossoms on her face. This scene, frozen in an interplay of light and shadow, records her wonderful encounter with nature.",
        "ref_images_url": [
            "http://wanx.alicdn.com/material/20250318/image_reference_2_5_16.png",
            "http://wanx.alicdn.com/material/20250318/image_reference_1_5_16.png"
        ]
    },
    "parameters": {
        "prompt_extend": true,
        "obj_or_bg": ["obj","bg"],
        "size": "1280*720"
    }
}'
Étape 2 : Récupérer le résultat à partir de l'ID de tâcheRemplacez {task_id} par la valeur task_id retournée par l'appel API précédent. L'identifiant task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Repeinture vidéo

Présentation de la fonctionnalité : Extrait la pose et les actions du sujet, la composition et les contours de mouvement, ou la structure esquissée d'une vidéo d'entrée. Elle génère ensuite une nouvelle vidéo conservant ces mêmes caractéristiques dynamiques, guidée par un prompt textuel. Il est également possible de remplacer le sujet de la vidéo originale à l'aide d'une image de référence. Paramètres :
  • function : Définissez cette valeur sur video_repainting.
  • video_url : Obligatoire. URL de la vidéo d'entrée (format MP4, ≤ 50 Mo, ≤ 5 secondes).
  • control_condition : Obligatoire. Définit la méthode d'extraction des caractéristiques vidéo, déterminant ainsi quels éléments de la vidéo originale sont conservés dans la nouvelle vidéo.
    • posebodyface : Extrait les expressions faciales et les mouvements corporels (conserve les détails des expressions faciales).
    • posebody : Extrait uniquement les mouvements corporels, hors visage (contrôle seulement les actions du corps).
    • depth : Extrait la composition et les contours de mouvement (conserve la structure de la scène).
    • scribble : Extrait la structure esquissée (conserve les détails des contours de l'esquisse).
  • strength : Facultatif. Contrôle l'intensité de l'extraction des caractéristiques. Plage : [0,0, 1,0]. Valeur par défaut : 1,0. Une valeur élevée rapproche le résultat de la vidéo originale, tandis qu'une valeur faible offre davantage de liberté créative.
  • ref_images_url : Facultatif. Fournissez l'URL d'une image de référence pour remplacer le sujet de la vidéo d'entrée.
Prompt d'entréeVidéo d'entréeVidéo générée
La vidéo montre une voiture noire de style steampunk conduite par un gentleman, ornée d'engrenages et de tuyaux en cuivre. L'arrière-plan représente une confiserie à vapeur aux éléments rétro, créant une scène vintage et ludique.
  • curl
  • Python
  • Java
Étape 1 : Créer une tâche pour obtenir un ID de tâche
# The URL below is for the China (Beijing) region. Replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx2.1-vace-plus",
    "input": {
        "function": "video_repainting",
        "prompt": "The video shows a black steampunk-style car driven by a gentleman, adorned with gears and copper pipes. The background is a steam-powered candy factory with retro elements, creating a vintage and fun scene.",
        "video_url": "http://wanx.alicdn.com/material/20250318/video_repainting_1.mp4"
    },
    "parameters": {
        "prompt_extend": false,
        "control_condition": "depth"
    }
}'
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wan2.1-vace-plus",
    "input": {
        "function": "video_repainting",
        "prompt": "The video shows a black steampunk-style car driven by a gentleman, adorned with gears and copper pipes. The background is a steam-powered candy factory with retro elements, creating a vintage and fun scene.",
        "video_url": "http://wanx.alicdn.com/material/20250318/video_repainting_1.mp4"
    },
    "parameters": {
        "prompt_extend": false,
        "control_condition": "depth"
    }
}'
Étape 2 : Récupérer le résultat à partir de l'ID de tâcheRemplacez {task_id} par la valeur task_id retournée par l'appel API précédent. L'identifiant task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Édition locale

Présentation de la fonctionnalité : Effectue une édition précise sur des zones spécifiques d'une vidéo. Elle permet d'ajouter, supprimer ou modifier des éléments, ainsi que de remplacer des sujets ou des arrière-plans. Téléchargez une image masque pour définir la zone à éditer ; le modèle suit automatiquement la cible et intègre le contenu généré. Paramètres :
  • function : Définissez cette valeur sur video_edit.
  • video_url : Obligatoire. URL de la vidéo d'entrée originale.
  • mask_image_url : Facultatif. À choisir entre ce paramètre et mask_video_url. Nous recommandons d'utiliser ce paramètre. Fournissez l'URL d'une image masque où la zone blanche correspond à la partie à éditer et la zone noire reste inchangée.
  • mask_frame_id : Facultatif. Utilisé avec mask_image_url pour indiquer à quelle image de la vidéo le masque correspond (par défaut, la première image).
  • mask_type : Facultatif. Spécifie le comportement de la zone d'édition :
    • tracking (par défaut) : La zone d'édition suit automatiquement la trajectoire de mouvement de l'objet cible.
    • fixed : La zone d'édition reste fixe.
  • expand_ratio : Facultatif. Efficace uniquement lorsque mask_type est défini sur tracking.
    • Fonction : Définit le ratio d'expansion vers l'extérieur de la zone masquée. Plage de valeurs : [0,0, 1,0], valeur par défaut : 0,05.
    • Description : Une valeur plus faible ajuste le masque plus étroitement à la cible. Une valeur plus élevée élargit la portée du masque.
  • ref_images_url : Facultatif. Fournissez l'URL d'une image de référence pour remplacer le contenu de la zone d'édition par celui de l'image de référence.
Prompt d'entréeVidéo d'entréeImage masque d'entréeVidéo générée
La vidéo présente un café français de style parisien où un lion en costume déguste élégamment son café. Il tient une tasse d'une main et sirote avec une expression détendue. Le café est décoré avec goût, baigné de tons doux et d'un éclairage chaleureux illuminant l'espace occupé par le lion.
mask
La zone blanche indique la zone d'édition.
  • curl
  • Python
  • Java
Étape 1 : Créer une tâche pour obtenir un ID de tâche
# The URL below is for the China (Beijing) region. Replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx2.1-vace-plus",
    "input": {
        "function": "video_edit",
        "prompt": "The video shows a Parisian-style French cafe where a lion in a suit elegantly sips coffee. It holds a coffee cup in one hand, taking a gentle sip with a relaxed expression. The cafe is tastefully decorated, with soft hues and warm lighting illuminating the lion's area.",
        "mask_image_url": "http://wanx.alicdn.com/material/20250318/video_edit_1_mask.png",
        "video_url": "http://wanx.alicdn.com/material/20250318/video_edit_2.mp4",
        "mask_frame_id": 1
    },
    "parameters": {
        "prompt_extend": false,
        "mask_type": "tracking",
        "expand_ratio": 0.05
    }
}'
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wan2.1-vace-plus",
    "input": {
        "function": "video_edit",
        "prompt": "The video shows a Parisian-style French cafe where a lion in a suit elegantly sips coffee. It holds a coffee cup in one hand, taking a gentle sip with a relaxed expression. The cafe is tastefully decorated, with soft hues and warm lighting illuminating the lion's area.",
        "mask_image_url": "http://wanx.alicdn.com/material/20250318/video_edit_1_mask.png",
        "video_url": "http://wanx.alicdn.com/material/20250318/video_edit_2.mp4",
        "mask_frame_id": 1
    },
    "parameters": {
        "prompt_extend": false,
        "mask_type": "tracking",
        "expand_ratio": 0.05
    }
}'
Étape 2 : Récupérer le résultat à partir de l'ID de tâcheRemplacez {task_id} par la valeur task_id retournée par l'appel API précédent. L'identifiant task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Extension vidéo

Présentation de la fonctionnalité : Prédit et génère du contenu continu subséquent à partir d'une image ou d'un clip vidéo d'entrée. Elle permet d'étendre la vidéo vers l'avant depuis la « première image / premier clip » ou vers l'arrière depuis la « dernière image / dernier clip ». La durée totale de la vidéo finale générée est fixée à 5 secondes. Paramètres :
  • function : Définissez cette valeur sur video_extension.
  • prompt : Obligatoire. Décrit le contenu d'extension souhaité.
  • first_clip_url : Facultatif. Fournissez l'URL du premier clip vidéo (≤ 3 secondes). Le modèle générera le reste de la vidéo en se basant sur ce clip.
  • last_clip_url : Facultatif. Fournissez l'URL du dernier clip vidéo (≤ 3 secondes). Le modèle générera la partie précédente de la vidéo en se basant sur ce clip.
  • first_frame_url : Facultatif. Fournissez l'URL de l'image de la première frame. La vidéo sera étendue vers l'avant à partir de cette image.
  • last_frame_url : Facultatif. Fournissez l'URL de l'image de la dernière frame. La vidéo sera étendue vers l'arrière à partir de cette image.
    Remarque : Vous devez fournir au moins un des quatre paramètres suivants en entrée : first_clip_url, last_clip_url, first_frame_url ou last_frame_url.
Prompt d'entréePremier clip d'entrée (1 seconde)Vidéo générée (étendue à 5 secondes)
Un chien portant des lunettes de soleil fait du skateboard dans la rue, style cartoon 3D.
  • curl
  • Python
  • Java
Étape 1 : Créer une tâche pour obtenir un ID de tâche
# The URL below is for the China (Beijing) region. Replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx2.1-vace-plus",
    "input": {
        "function": "video_extension",
        "prompt": "A dog wearing sunglasses skateboarding on the street, 3D cartoon.",
        "first_clip_url": "http://wanx.alicdn.com/material/20250318/video_extension_1.mp4"
    },
    "parameters": {
        "prompt_extend": false
    }
}'
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wan2.1-vace-plus",
    "input": {
        "function": "video_extension",
        "prompt": "A dog wearing sunglasses skateboarding on the street, 3D cartoon.",
        "first_clip_url": "http://wanx.alicdn.com/material/20250318/video_extension_1.mp4"
    },
    "parameters": {
        "prompt_extend": false
    }
}'
Étape 2 : Récupérer le résultat à partir de l'ID de tâcheRemplacez {task_id} par la valeur task_id retournée par l'appel API précédent. L'identifiant task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Outpainting vidéo

Présentation de la fonctionnalité : Étend le contenu vidéo vers le haut, le bas, la gauche et la droite selon un prompt et un ratio spécifiés, tout en préservant la cohérence du sujet principal et en assurant une intégration naturelle de l'arrière-plan. Paramètres :
  • function : Définissez cette valeur sur video_outpainting.
  • video_url : Obligatoire. URL de la vidéo d'entrée originale.
  • top_scale : Facultatif. Ratio d'expansion vers le haut. Plage : [1,0, 2,0]. Valeur par défaut : 1,0 (aucune expansion).
  • bottom_scale : Facultatif. Ratio d'expansion vers le bas. Plage : [1,0, 2,0]. Valeur par défaut : 1,0.
  • left_scale : Facultatif. Ratio d'expansion vers la gauche. Plage : [1,0, 2,0]. Valeur par défaut : 1,0.
  • right_scale : Facultatif. Ratio d'expansion vers la droite. Plage : [1,0, 2,0]. Valeur par défaut : 1,0.
Exemple : Définir left_scale sur 1,5 signifie que le côté gauche du cadre sera étendu à 1,5 fois sa largeur d'origine.
Prompt d'entréeVidéo d'entréeVidéo générée
Une dame élégante joue passionnément du violon, accompagnée par un orchestre symphonique complet derrière elle.
  • curl
  • Python
  • Java
Étape 1 : Créer une tâche pour obtenir un ID de tâche
# The URL below is for the China (Beijing) region. Replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx2.1-vace-plus",
    "input": {
        "function": "video_outpainting",
        "prompt": "An elegant woman passionately plays the violin, with a full symphony orchestra behind her.",
        "video_url": "http://wanx.alicdn.com/material/20250318/video_outpainting_1.mp4"
    },
    "parameters": {
        "prompt_extend": false,
        "top_scale": 1.5,
        "bottom_scale": 1.5,
        "left_scale": 1.5,
        "right_scale": 1.5
    }
}'
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wan2.1-vace-plus",
    "input": {
        "function": "video_outpainting",
        "prompt": "An elegant woman passionately plays the violin, with a full symphony orchestra behind her.",
        "video_url": "http://wanx.alicdn.com/material/20250318/video_outpainting_1.mp4"
    },
    "parameters": {
        "prompt_extend": false,
        "top_scale": 1.5,
        "bottom_scale": 1.5,
        "left_scale": 1.5,
        "right_scale": 1.5
    }
}'
Étape 2 : Récupérer le résultat à partir de l'ID de tâcheRemplacez {task_id} par la valeur task_id retournée par l'appel API précédent. L'identifiant task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Comment fournir des images et des vidéos

Images d'entrée

Vidéos d'entrée

Vidéos générées

  • Nombre de vidéos : 1.
  • Spécifications vidéo : Résolution totale fixe à 720P, fréquence d'images de 30 fps, format MP4 (encodage H.264).
  • Validité de l'URL vidéo : 24 heures.
  • Dimensions vidéo : Variables selon la fonctionnalité choisie.
    • Référence multi-images / Édition locale :
      • Résolution de sortie fixe à 720P.
      • Largeur et hauteur spécifiques déterminées par le paramètre de requête size.
    • Repeinture vidéo / Extension vidéo / Outpainting vidéo :
      • Si la résolution de la vidéo d'entrée est ≤ 720P : La sortie conserve la résolution d'origine.
      • Si la résolution de la vidéo d'entrée est > 720P : La sortie est réduite à 720P tout en conservant le ratio d'aspect.

Facturation et limitations de débit

  • Pour plus d'informations sur le quota gratuit et les tarifs du modèle, consultez la rubrique Tarification des modèles.
  • Pour plus d'informations sur les limites de débit du modèle, consultez la rubrique Série Wanxiang.
  • Détails de facturation :
    • Les entrées ne sont pas facturées. La facturation repose sur la durée en secondes de la vidéo générée avec succès.
    • Les appels de modèle échoués ou les erreurs de traitement n'entraînent aucun frais et ne consomment pas le quota gratuit nouvel utilisateur.
    • L'édition vidéo universelle prend également en charge les plans d'épargne.

Documentation API

Référence de l'API d'édition vidéo universelle

FAQ

Q : Combien d'images la fonctionnalité de référence multi-images prend-elle en charge au maximum ?

R : Elle accepte jusqu'à 3 images de référence. Si vous en fournissez plus de 3, seules les 3 premières seront utilisées. Nous recommandons d'utiliser un arrière-plan uni pour l'image du sujet afin de mieux le mettre en valeur, et une image d'arrière-plan ne contenant aucun sujet.

Q : Quand faut-il désactiver la réécriture de prompt pour la repeinture vidéo ?

R : Lorsque la description textuelle ne correspond pas au contenu de la vidéo d'entrée, le modèle risque de mal l'interpréter. Nous recommandons de désactiver manuellement la réécriture de prompt en définissant prompt_extend=false, et de fournir une description claire et précise de la scène dans le prompt pour améliorer la cohérence et la précision de la génération.

Q : Dans la fonctionnalité d'édition locale, quelle est la différence entre une image masque et une vidéo masque ?

R : Vous devez fournir soit mask_image_url, soit mask_video_url. Nous recommandons d'utiliser une image masque. Il suffit de spécifier la zone d'édition pour une seule image, et le système suivra automatiquement la cible.