Skip to main content

Wan 2.7 - Image-to-video

Le modèle image-vers-vidéo Wan 2,7 exploite une entrée multimodale (texte, image, audio et vidéo) pour accomplir trois tâches principales : la génération vidéo à partir de la première image, la génération vidéo à partir de la première et de la dernière image, ainsi que la continuation vidéo (prolongement d'un segment vidéo initial, avec ou sans image finale) .

  • Paramètres de base : Prise en charge de durées vidéo de 2 à 15 secondes, résolution configurable (720p ou 1080p), réécriture intelligente des prompts et ajout de filigrane.
  • Fonctionnalités audio : Doublage automatique ou importation d'un fichier audio personnalisé, garantissant une synchronisation audiovisuelle précise.
  • Narration multi-plans : Génération de vidéos comportant plusieurs plans tout en préservant la cohérence du sujet entre les séquences.
Liens rapides : Essayer en ligne (Singapore | Virginia | China (Beijing))|Référence API

Démarrage rapide

Prompt d'entréePremier clip vidéo d'entrée (2 s)Image de dernière frame d'entréeVidéo de sortie (12 s, dont 10 s de continuation)
Un homme regarde une boîte en bois posée au sol. Il se penche et ouvre délicatement le couvercle. Il fixe le contenu de la boîte, les lèvres tremblantes et entrouvertes. Son front est plissé et ses yeux écarquillés expriment l'horreur.
wan2
Avant tout appel, obtenez une clé API et configurez-la comme variable d'environnement. Pour utiliser un SDK, installez le SDK DashScope.
  • Python SDK
  • Java SDK
  • Curl
Vérifiez que votre SDK DashScope Python est en version 1.25.16 ou ultérieure avant d'exécuter le code suivant.L'utilisation d'une version antérieure peut provoquer une erreur du type « url error, please check url! ». Consultez la rubrique Installer le SDK pour mettre à jour votre version.
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# This URL is for the Singapore region. URLs vary by region. For more information, see https://www.alibabacloud.com/help/en/model-studio/image-to-video-general-api-reference
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

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

media = [
    {
        "type": "first_clip",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/cqcbkw/wan2.7-i2v-video-continuation.mp4"
    },
    {
        "type": "last_frame",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/mrwahg/wan2.7-i2v-video-continuation.webp"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-i2v-2026-04-25",
        media=media,
        resolution="720P",
        duration=12,
        watermark=True,
        prompt="A man looks down at a wooden box on the ground. He bends over and carefully opens the lid. He stares at the contents of the box, his lips trembling and slightly parted. His brow is furrowed and his eyes are wide with a look of horror.",
    )
    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
L'URL video_url est valide pendant 24 heures. Téléchargez la vidéo sans tarder.
{
    "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",
         ...
    },
    ...
}

Remarques d'utilisation

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

Fonctionnalités principales

Génération vidéo à partir de la première image

Modèles pris en charge : Modèles de la série wan2.7. Configuration des paramètres : Le champ type du tableau media accepte les deux combinaisons suivantes. Consultez la section Ressources d'entrée pour plus de détails sur les combinaisons de ressources multimédias.
  • Première image : Définissez type sur first_frame. Le modèle ajoute automatiquement du son à la vidéo.
  • Première image + audio : Définissez type sur first_frame et driving_audio. Le modèle utilise la piste audio pour piloter la génération vidéo, permettant notamment la synchronisation labiale et le calage des actions.
PromptImage de première frameVidéo de sortie
Une scène d'art urbain fantastique. Un personnage de graffiti dynamique. Un garçon fait de peinture en bombe prend vie depuis un mur de béton. Il rappe une chanson anglaise à toute vitesse en adoptant une pose classique et énergique de rappeur. La scène se déroule la nuit sous un pont ferroviaire urbain. La lumière provient d'un unique lampadaire, créant une atmosphère cinématographique débordante d'énergie et riche en détails époustouflants. La bande-son de la vidéo se compose exclusivement du rap, sans aucun autre dialogue ni bruit parasite.
rap
Audio d'entrée :
  • Python SDK
  • Java SDK
  • Curl
Vérifiez que votre SDK DashScope Python est en version 1.25.16 ou ultérieure. Pour effectuer une mise à jour, reportez-vous à Installer le SDK .
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# This is the URL for the Singapore region. URLs vary by region. For a list of URLs, see https://www.alibabacloud.com/help/en/model-studio/image-to-video-general-api-reference.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

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

media = [
    {
        "type": "first_frame",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
    },
    {
        "type": "driving_audio",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-i2v-2026-04-25",
        media=media,
        resolution="720P",
        duration=10,
        watermark=True,
        prompt="An urban fantasy art scene. A dynamic graffiti art character. A boy made of spray paint comes to life from a concrete wall. He raps an English song at high speed while striking a classic, energetic rapper pose. The scene is set at night under an urban railway bridge. The light comes from a single street lamp, creating a cinematic atmosphere full of high energy and amazing detail. The audio of the video consists entirely of the rap, with no other dialogue or noise.",
    )
    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
L'URL video_url est valide pendant 24 heures. Téléchargez la vidéo sans tarder.
{
    "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",
         ...
    },
    ...
}

Génération vidéo à partir de la première et de la dernière image

Modèles pris en charge : Modèles de la série wan2.7. Configuration des paramètres : Le champ type du tableau media accepte les deux combinaisons suivantes. Consultez la section Ressources d'entrée pour plus de détails sur les combinaisons de ressources multimédias.
  • Première image + dernière image : Définissez type sur first_frame et last_frame. Le modèle ajoute automatiquement du son à la vidéo.
  • Première image + dernière image + audio : Définissez type sur first_frame, last_frame et driving_audio. Le modèle utilise la piste audio pour piloter la génération vidéo.
PromptImage de première frameImage de dernière frameVidéo de sortie
Au petit matin, au lever du soleil, une petite citrouille couverte de rosée repose dans un champ. Soudain, la citrouille se fend avec un « CRAC ». Une lumière dorée jaillit de la fissure tandis que la citrouille s'ouvre, libérant un nuage de brume blanche. Un petit lapin apparaît au centre de la citrouille ouverte.
wan2
wan2
  • Python SDK
  • Java SDK
  • Curl
Vérifiez que votre SDK DashScope Python est en version 1.25.16 ou ultérieure. Pour effectuer une mise à jour, reportez-vous à Installer le SDK .
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# This is the URL for the Singapore region. URLs vary by region. For a list of URLs, see https://www.alibabacloud.com/help/en/model-studio/image-to-video-general-api-reference.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

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

media = [
    {
        "type": "first_frame",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/welyei/wan2.7-i2v-first-frame.webp"
    },
    {
        "type": "last_frame",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/zongha/wan2.7-i2v-last-frame.webp"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-i2v-2026-04-25",
        media=media,
        resolution="720P",
        duration=15,
        watermark=True,
        prompt="In the early morning as the sun rises, a small pumpkin with dewdrops sits in a pumpkin patch. Suddenly, the pumpkin cracks open with a \"CRACK\". A golden light emanates from the fissure as the pumpkin splits apart, releasing a puff of white mist. A small rabbit appears in the center of the opened pumpkin.",
    )
    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()

Continuation vidéo

Modèles pris en charge : Modèles de la série wan2.7. Cette fonctionnalité prolonge le contenu d'un clip vidéo d'entrée. La sortie inclut le clip original, dont la durée s'impute sur le temps total de génération. Par exemple, si vous fournissez une vidéo de 2 secondes et définissez une durée totale de sortie de 12 secondes, la vidéo finale durera 12 secondes (le clip original de 2 secondes suivi d'une continuation de 10 secondes). Configuration des paramètres : Le champ type du tableau media accepte les deux combinaisons suivantes. Consultez la section Ressources d'entrée pour plus de détails sur les combinaisons de ressources multimédias.
  • Premier clip vidéo : Définissez type sur first_clip pour poursuivre la vidéo.
  • Premier clip vidéo + dernière image de continuation : Définissez type sur first_clip et last_frame. Cette option prolonge le premier clip vidéo en veillant à ce que sa dernière image corresponde exactement à l'image finale fournie.
  • First clip continuation
  • First clip and last frame
PromptPremier clip vidéoVidéo de sortie
Le boulanger apporte le pain glacé, pose son pinceau, et la caméra le suit jusqu'au four situé à l'arrière pour y faire cuire le pain. Le boulanger ferme la porte du four, reste à côté en surveillant la cuisson, hume l'arôme qui s'en dégage et s'exclame : « c'est trop bon ».
  • Python SDK
  • Java SDK
  • Curl
Vérifiez que votre SDK DashScope Python est en version 1.25.16 ou ultérieure. Pour effectuer une mise à jour, reportez-vous à Installer le SDK .
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# This is the URL for the Singapore region. URLs vary by region. For a list of URLs, see https://www.alibabacloud.com/help/en/model-studio/image-to-video-general-api-reference.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

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

media = [
    {
        "type": "first_clip",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/rptnhd/wan2.7-i2v-video-continuation-2.mp4"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-i2v-2026-04-25",
        media=media,
        resolution="720P",
        duration=12,
        watermark=True,
        prompt="The baker brings over the glazed bread, sets the brush aside, and the camera follows him to the oven at the back to bake it. The baker closes the oven door, stands beside it watching the bread, smells the aroma, and says, \"so good\".",
    )
    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()

Ressources multimédias d'entrée

Transmettez vos ressources multimédias dans le tableau media. Chaque élément doit spécifier un type et une url. Chaque type ne peut apparaître qu'une seule fois dans le tableau media.
Seules les combinaisons de ressources spécifiques listées ci-dessous sont prises en charge. Toute autre combinaison renvoie une erreur.
// Combination 1: First frame, with automatic dubbing
{
  "media": [
    { "type": "first_frame", "url": "https://example.com/image.jpg" }
  ]
}

// Combination 2: First frame + driving audio, with custom audio
{
  "media": [
    { "type": "first_frame", "url": "https://example.com/image.jpg" },
    { "type": "driving_audio", "url": "https://example.com/audio.mp3" }
  ]
}

Images d'entrée

  • Nombre d'images : Vous pouvez soumettre une image maximum pour la première frame (type=first_frame) et une image maximum pour la dernière frame (type=last_frame).
  • Méthodes d'importation :
    • URL publique : Protocoles HTTP et HTTPS pris en charge. Exemple : https://xxxx/xxx.png.
    • Chaîne encodée en base64 : Chaîne au format data:{MIME_type};base64,{base64_data}, où :
      • {base64_data} : La chaîne encodée en Base64 correspondant à l'image.
      • {MIME_type} : Le type MIME de l'image, qui doit correspondre au format du fichier.

        Format

        Type MIME

        JPEG

        image/jpeg

        JPG

        image/jpeg

        PNG

        image/png

        BMP

        image/bmp

        WEBP

        image/webp

Audio d'entrée

  • Nombre de fichiers audio : Vous pouvez fournir un fichier audio maximum (type=driving_audio).
  • Méthodes d'importation :

Vidéo d'entrée

  • Nombre de vidéos : Vous pouvez transmettre un premier clip vidéo maximum (type=first_clip).
  • Méthodes d'importation :

Vidéo de sortie

  • Nombre de vidéos : 1.
  • Spécifications de la vidéo de sortie : Les spécifications prises en charge varient selon le modèle. Pour plus de détails, consultez Disponibilité.
  • Expiration de l'URL de la vidéo de sortie : 24 heures.
  • Dimensions de la vidéo de sortie : Le modèle détermine les dimensions en fonction de la première image ou du premier clip vidéo d'entrée, ainsi que du paramètre resolution. Le modèle préserve le rapport hauteur/largeur original des ressources d'entrée. Il met à l'échelle le nombre total de pixels pour s'approcher de la cible définie par le paramètre resolution, puis ajuste la largeur et la hauteur afin qu'elles soient des multiples de 16.

Facturation et limites de taux

  • Consultez la rubrique Tarification des modèles pour plus de détails sur le quota gratuit et les tarifs appliqués.
  • Consultez la rubrique Wan pour plus de détails sur les limites de taux.
  • Détails de facturation :
    • Les entrées sont gratuites. Les sorties sont facturées en fonction de la durée en secondes de chaque vidéo générée avec succès.
    • Les appels ayant échoué ou les erreurs de traitement n'entraînent aucun frais et ne consomment pas le quota gratuit pour les nouveaux utilisateurs.
    • La fonctionnalité image-vers-vidéo prend également en charge les Plans d'épargne.

Référence API

Référence API Wan2.7-I2V

FAQ

Q : Quelles sont les nouveautés de wan2.7-i2v ?

R : Par rapport à wan2.6-i2v et aux modèles précédents, wan2.7-i2v introduit les nouvelles fonctionnalités suivantes :
  • Prise en charge de trois tâches principales : la génération vidéo à partir de la première image, la génération vidéo à partir de la première et de la dernière image, ainsi que la continuation vidéo. Les modèles précédents ne prenaient en charge que la génération vidéo à partir de la première image.
  • Possibilité de transmettre des ressources multimodales (images, audio, vidéos) via le tableau unifié media. Les modèles précédents ne permettaient de transmettre des images qu'à l'aide du paramètre img_url.

Q : Comment créer une vidéo multi-plans ?

R : Spécifiez la structure des plans dans le prompt. Vous pouvez utiliser les méthodes suivantes :
  • Spécification directe : Incluez la mention « générer une vidéo multi-plans » dans le prompt.
  • Storyboard ou horodatages : Décrivez chaque plan avec une plage temporelle. Par exemple, « Premier plan : plan large, un garçon rappe et danse » ou « Premier plan [1-5s] : plan large, un garçon rappe et danse. Deuxième plan [6-10s] : la caméra coupe sur le public en train d'acclamer ».
  • Si vous ne spécifiez pas explicitement la structure des plans, le modèle la déduit à partir du prompt.

Q : Pourquoi ne puis-je pas définir le rapport hauteur/largeur de la vidéo ?

R : L'API ne permet pas actuellement de définir directement le rapport hauteur/largeur. Vous devez plutôt définir la résolution à l'aide du paramètre resolution. Le paramètre resolution contrôle le nombre total de pixels de la vidéo, et non un rapport hauteur/largeur fixe. Le modèle préserve le rapport hauteur/largeur approximatif de la première image ou du premier clip vidéo d'entrée, puis affine la largeur et la hauteur pour qu'elles correspondent à des multiples entiers de 16, conformément aux exigences d'encodage vidéo.