Skip to main content

Wan 2.7 - Video Editing

Le modèle de montage vidéo Wanxiang permet de modifier des vidéos en entrée : ajout, suppression ou modification de contenu, remplacement d'arrière-plans, conversion de styles, ainsi que réplication d'actions, d'effets ou de mouvements de caméra. Il propose les deux méthodes suivantes :

  • Montage par instructions : Modifiez le contenu vidéo à l'aide d'instructions textuelles, par exemple pour remplacer les vêtements d'un personnage, changer des éléments de scène ou ajuster le style visuel.
  • Montage par instructions et image de référence : Outre les instructions, transmettez une image de référence pour appliquer à la vidéo des éléments issus de cette image, tels que des personnages, des vêtements ou des accessoires.
Pour le montage vidéo, en particulier pour répliquer des actions, des mouvements de caméra ou des effets à partir d'une vidéo spécifique, utilisez Video Editing 2.7. Pour les fonctionnalités de prolongation de vidéo, reportez-vous à Wanxiang Image-to-Video 2.7.

Prise en main

Invite et image de référence en entréeVidéo en entrée (vidéo d'effets)Vidéo en sortie
Appliquez les effets spéciaux de la vidéo de référence à la femme aux cheveux longs dans l'image. La scène est une fête.
image.png
Avant tout appel, obtenez une clé API, puis configurez-la comme variable d'environnement. Pour appeler l'API via un kit de développement logiciel (SDK), installez le SDK DashScope. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
  • Python SDK
  • Java SDK
  • curl
Assurez-vous que la version du SDK DashScope pour Python est ultérieure ou égale à1.25.16 avant d'exécuter le code suivant.Une version obsolète peut déclencher des erreurs telles que « url error, please check url! ». Pour plus d'informations, consultez Installer le SDK afin de procéder à la mise à jour.
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# If the environment variable is not set, replace the following line with your Model Studio API key: api_key="sk-xxx"
# API keys vary by region. For more information, see https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/eclvbm/21_refined.mp4"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/jgekix/wan2.7-videoedit-demo.webp"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-videoedit",
        media=media,
        resolution="720P",
        prompt_extend=True,
        watermark=True,
        prompt="Apply the special effects from the reference video to the long-haired woman in the image. The scene is a party.",
    )
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call()
Exemple de sortie
video_url est valide pendant 24 heures. Téléchargez la vidéo rapidement.
{
    "request_id": "c1209113-8437-424f-a386-xxxxxx",
    "output": {
        "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
         ...
    },
    ...
}

Périmètre

  • Les modèles pris en charge varient selon la région. Les ressources sont isolées entre les régions. Pour connaître les modèles disponibles dans chaque région, consultez la console Model Studio.
  • Lors d'un 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.
L'exemple de code de cette rubrique s'applique à la région Singapour.

Capacités principales

Montage par instructions uniquement

Modèle pris en charge : wan2.7-videoedit. Présentation de la fonctionnalité : Cette fonctionnalité modifie le contenu vidéo à partir d'une vidéo en entrée et d'une invite textuelle. Elle convient aux scénarios tels que la conversion de style, la modification d'actions et l'ajustement des mouvements de caméra. Configuration des paramètres :
  • media : Spécifie la vidéo à monter (type=video). Aucune image de référence n'est nécessaire.
  • prompt : Décrit l'intention de montage, par exemple « Convertir la vidéo en style pixel art 8 bits ».
Invite en entréeVidéo en entréeVidéo en sortie
Convertir la vidéo en style pixel art 8 bits
Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
  • Python SDK
  • Java SDK
  • curl
Assurez-vous que la version du SDK DashScope pour Python est ultérieure ou égale à1.25.16 avant d'exécuter le code suivant.Une version obsolète peut déclencher des erreurs telles que « url error, please check url! ». Pour plus d'informations, consultez Installer le SDK afin de procéder à la mise à jour.
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# If the environment variable is not set, replace the following line with your Model Studio API key: api_key="sk-xxx"
# API keys vary by region. For more information, see https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-videoedit",
        media=media,
        resolution="720P",
        prompt_extend=True,
        watermark=True,
        prompt="Convert the entire frame to a claymation style",
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call()

Montage par instructions et image de référence

Modèle pris en charge : wan2.7-videoedit. Présentation de la fonctionnalité : Cette fonctionnalité applique à une vidéo des éléments provenant d'une image de référence, tels que des vêtements ou des accessoires, sur la base d'une invite textuelle. Configuration des paramètres :
  • media : Spécifie la vidéo à monter (type=video) ainsi qu'une image de référence (type=reference_image). Vous pouvez fournir jusqu'à quatre images de référence.
  • prompt : Décrit l'intention de montage, par exemple « Faire porter au personnage à tête de cheval dans la vidéo le pull rayé de l'image ».
Invite et image de référence en entréeVidéo en entréeVidéo en sortie
Faire porter au personnage à tête de cheval dans la vidéo le pull rayé de l'image
2560154123_RF-jpeg
Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
  • Python SDK
  • Java SDK
  • curl
Assurez-vous que la version du SDK DashScope pour Python est ultérieure ou égale à1.25.16 avant d'exécuter le code suivant.Une version obsolète peut déclencher des erreurs telles que « url error, please check url! ». Pour plus d'informations, consultez Installer le SDK afin de procéder à la mise à jour.
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# If the environment variable is not set, replace the following line with your Model Studio API key: api_key="sk-xxx"
# API keys vary by region. For more information, see https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/nlspwm/T2VA_22.mp4"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/fwjpqf/wan2.7-videoedit-change-clothes.png"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-videoedit",
        media=media,
        resolution="720P",
        prompt_extend=True,
        watermark=True,
        prompt="Replace the girl's clothes in the video with the clothes from the image",
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call()

Scénarios et exemples

Ajouter, supprimer ou modifier des éléments

Ajoutez, supprimez ou remplacez des éléments spécifiques au sein d'une vidéo.
TypeInvite et image de référence en entréeVidéo en entréeVidéo en sortie
AjoutAjouter un carré de chocolat noir dans la tasse
SuppressionRetirer le train de la vidéo. Conserver tout le reste identique.
ModificationRemplacer le film dans la vidéo par l'assiette de l'image
image.png
ModificationFaire porter à l'homme-cheval dans la vidéo le pull rayé de l'image
2560154123_RF-jpeg
ModificationTransformer le chat en chien

Modifier l'environnement ou l'arrière-plan

Utilisez des instructions pour changer les conditions d'éclairage, les couleurs saisonnières ou l'espace géographique d'une vidéo. Vous pouvez également modifier l'arrière-plan de la vidéo pour transporter des objets dans n'importe quel espace.
TypeInvite en entréeVidéo en entréeVidéo en sortie
Modification de saisonChanger la saison de l'arrière-plan pour un hiver enneigé, avec de la neige recouvrant les arbres. Conserver la rivière identique.
Modification météoConserver les actions du personnage identiques, mais transformer toute la scène, actuellement nuageuse, en journée ensoleillée. Ne rien changer d'autre.
Modification éclairage et ombresNe rien changer d'autre. Faire passer la couleur globale de la lumière et le filtre du plan du blanc à une tonalité chaude. Préserver les détails du teint du personnage pour créer une harmonie visuelle entre le personnage et l'arrière-plan.
Modification arrière-planConserver les actions de la femme principale identiques, mais remplacer l'arrière-plan de la vidéo par une salle de sport.

Modifier le style de la vidéo

Convertissez rapidement des vidéos existantes en divers styles artistiques, tels que l'animation, la 3D, la pâte à modeler ou le fil de laine.
TypeInvite en entréeVidéo en entréeVidéo en sortie
Modification de styleVidéo vers Image : Style Cartoon C4D
2402534429_RF
Modification de styleConvertir l'ensemble du plan en style film en prises de vues réelles
Modification de styleConvertir l'ensemble du plan en style peinture à l'aquarelle

Modifier le comportement des personnages, les dialogues ou le cadrage

Pour un contenu vidéo existant ou généré, utilisez des instructions afin de modifier l'intrigue, telle que le comportement ou les dialogues des personnages, et d'ajuster le cadrage pour un montage créatif approfondi.
TypeInvite en entréeVidéo en entréeVidéo en sortie
Modification du comportement d'un personnageFaire en sorte que l'homme dans la vidéo prenne une cuillerée de soupe et la boive. Ne rien changer d'autre.
Modification de l'émotion d'un personnageL'expression de la fille dans le plan devient triste et elle se met à pleurer. Ne rien changer d'autre.
Modification des dialogues d'un personnageConserver la voix et le ton du personnage. Remplacer la réplique de la fille de gauche par : « Maman, quelle est cette couleur ? », et celle de la fille de droite par : « C'est vert, mon bébé »
Modification du cadrageChanger le mouvement de caméra pour un travelling circulaire horaire autour du personnage, ce dernier suivant le mouvement de la caméra.
Modification du cadrageChanger le mouvement de caméra de la vidéo pour un panoramique vertical ascendant tout en plongeant simultanément le regard vers le bas.

Répliquer des actions, des mouvements de caméra ou des effets

Répliquez les séquences d'action, les trajectoires de caméra et les effets visuels d'une vidéo de référence pour générer une vidéo présentant des caractéristiques dynamiques cohérentes.
TypeInvite ou image de référence en entréeVidéo en entréeVidéo en sortie
Réplication d'une action individuelleFaire en sorte que la personne dans l'image imite les actions de la personne dans la vidéo.
image.png
Réplication d'une action multi-personnesReprendre les actions des cinq personnes dans la vidéo et transformer la scène en cinq personnes chantant et jouant d'instruments à un stand de rue en ville.
Réplication d'un mouvement de caméraReprendre le mouvement de caméra rapide de la vidéo originale. Transformer la scène en cérémonie de remise de prix, avec la femme de l'image de référence marchant sur le tapis rouge.
image.png
Réplication d'effetsReprendre les effets spéciaux de la vidéo et les appliquer à la femme dans l'image, la scène se déroulant dans une rue.
image.png

Comment fournir des vidéos et des images

Vidéo en entrée

  • Quantité de vidéos : Obligatoire. Exactement une.
  • Méthode de fourniture :

Image de référence en entrée

  • Quantité d'images : Facultatif. Jusqu'à quatre.
  • Méthode de fourniture :
    • URL publique : Prend en charge les protocoles HTTP ou HTTPS. Exemple : https://xxxx/xxx.png.
    • Chaîne encodée en Base64 : Exemple : data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABDg...... (Exemple tronqué à titre d'illustration).
      • Format : data:{MIME_type};base64,{base64_data}, où :
        • {base64_data} : La chaîne encodée en Base64 du fichier image.
        • {MIME_type} : Le type MIME de l'image, qui doit correspondre au format du fichier.

        Format d'image

        Type MIME

        JPEG

        image/jpeg

        JPG

        image/jpeg

        PNG

        image/png

        BMP

        image/bmp

        WEBP

        image/webp

        import base64
        import mimetypes
        
        # Format is data:{MIME_type};base64,{base64_data}
        def encode_file(file_path):
            mime_type, _ = mimetypes.guess_type(file_path)
            if not mime_type or not mime_type.startswith("image/"):
                raise ValueError("Unsupported or unrecognized image format")
            with open(file_path, "rb") as image_file:
                encoded_string = base64.b64encode(image_file.read()).decode('utf-8')
            return f"data:{mime_type};base64,{encoded_string}"
        
        # Replace your_image.jpg with the actual image path
        base64_str = encode_file("your_image.jpg")
        print(base64_str)
        

Vidéo en sortie

Facturation et limitations de débit

  • Pour les quotas gratuits et les tarifs de facturation des modèles, consultez Tarification des modèles.
  • Pour les limites de débit des modèles, consultez Série Wanxiang.
  • Description de la facturation :
    • Les images en entrée ne sont pas facturées. Les vidéos en entrée et en sortie sont facturées à la seconde. La formule est la suivante : Durée totale facturable (secondes) = Durée de la vidéo en entrée (secondes) + Durée de la vidéo en sortie (secondes).
    • Les appels de modèle ayant échoué ou les erreurs de traitement n'engendrent aucun frais et ne consomment pas le quota gratuit pour les nouveaux utilisateurs.

Documentation API

Wanxiang Video Editing 2.7

FAQ

Q : Quelle est la différence entre Video Editing 2.7 (wan2.7-videoedit) et Video Editing 2.1 (wan2.1-vace-plus) ?

R : Video Editing 2.7 monte les vidéos directement à partir d'instructions, ce qui simplifie son utilisation et offre des améliorations globales. Video Editing 2.1 nécessite de spécifier le paramètre function et se concentre sur des fonctionnalités telles que le montage local avec masques et l'expansion de plans. Nous vous recommandons d'utiliser Video Editing 2.7.

Q : Comment fournir plusieurs images de référence ?

R : Ajoutez plusieurs objets avec type=reference_image au tableau media. Vous pouvez ajouter jusqu'à quatre images de référence. Exemple :
{
    "media": [
        {"type": "video", "url": "<Input video URL>"},
        {"type": "reference_image", "url": "<Reference image 1 URL>"},
        {"type": "reference_image", "url": "<Reference image 2 URL>"},
        {"type": "reference_image", "url": "<Reference image 3 URL>"},
        {"type": "reference_image", "url": "<Reference image 4 URL>"}
    ]
}