Skip to main content

Image-to-video: first and last frames

Le modèle image-vers-vidéo Wan génère des vidéos fluides à partir d'une première image, d'une dernière image et d'un prompt textuel facultatif.

  • Spécifications vidéo : durée fixe de 5 secondes et résolution personnalisée (480P/720P/1080P).
  • Capacités supplémentaires : réécriture de prompt et filigrane.
Liens rapides : Référence API | Guide des prompts

Premiers pas

PromptPremière imageDernière imageVidéo générée
Un adorable monstre bleu à l'expression légèrement triste se tient sous la pluie. La caméra zoome lentement et s'arrête au moment où il lève les yeux vers le ciel.
image
image
Avant d'appeler l'API : Obtenez une clé API, définissez-la comme variable d'environnement et installez le SDK DashScope.
  • Python SDK
  • Java SDK
  • curl
Le SDK DashScope Python ≥ 1.25.8 est requis avant d'exécuter le code ci-dessous. Les versions antérieures peuvent afficher des erreurs « url error, please check url! ». Installez le SDK.
import os
import dashscope
from dashscope.v2 import DashScopeError

# Voici la configuration de la région de Singapour. Remplacez {WorkspaceId} par l'ID de votre workspace. La valeur de region varie selon la région. Pour consulter les endpoints de chaque région, voir https://www.alibabacloud.com/help/model-studio/image-to-video-by-first-and-last-frame-api-reference
# Les API Key sont spécifiques à chaque région. Pour obtenir une API Key, consultez https://www.alibabacloud.com/help/model-studio/get-api-key
client = dashscope.Client(
    api_key=os.getenv("DASHSCOPE_API_KEY", "YOUR_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

print('Veuillez patienter...')
# generate est un appel en une étape (soumet la tâche et attend sa fin) et retourne un Job terminé
# first_frame_url / last_frame_url sont des champs de la section input qui ne font pas partie de la signature nommée et sont transmis via extra_input
try:
    job = client.videos.generate(model="wan2.2-kf2v-flash",
                                 prompt="A cute blue monster with a slightly sad expression stands in the rain. The camera slowly zooms in and stops on the moment it looks up at the sky.",
                                 extra_input={'first_frame_url': "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260126/ixdxvt/wan-kf2v-blue-1.png",
                                              'last_frame_url': "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260126/nhtdrc/wan-kf2v-blue-2.png"},
                                 duration=5,  # Fixé à 5 secondes. Ne pas modifier.
                                 prompt_extend=True,
                                 watermark=True)
    print(job)
    print("video_url:", job.video_url)
except DashScopeError as e:
    print(f"Code de statut HTTP: {e.status_code}")
    print(f"Code d'erreur: {e.code}")
    print(f"Message d'erreur: {e.message}")
    print("Consultez la documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
Exemple de sortie
L'URL video_url expire après 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",
         ...
    },
    ...
}

Disponibilité

  • 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 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.
Les exemples de code de cette rubrique s'appliquent à la région de Singapour.

Capacités principales

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

Modèles pris en charge : tous les modèles. Cette fonctionnalité génère des vidéos fluides à partir d'une première et d'une dernière image. Paramètres :
  • first_frame_url : obligatoire. Fournissez la première image.
  • last_frame_url : obligatoire. Fournissez la dernière image.
  • prompt : facultatif (recommandé). Contrôle l'évolution de la vidéo dans le temps.
PromptPremière imageDernière imageVidéo générée
Style réaliste. Un chaton noir curieux lève les yeux vers le ciel. La caméra part du niveau des yeux et monte progressivement jusqu'à capturer le regard curieux du chaton en plongée.
首帧图像
尾帧图像
  • Python SDK
  • Java SDK
  • curl
Le SDK DashScope Python ≥ 1.25.8 est requis. Mettez-le à jour si nécessaire .
import os
import dashscope
from dashscope.v2 import DashScopeError

# Voici la configuration de la région de Singapour. Remplacez {WorkspaceId} par l'ID de votre workspace. La valeur de region varie selon la région. Pour consulter les endpoints de chaque région, voir https://www.alibabacloud.com/help/model-studio/image-to-video-by-first-and-last-frame-api-reference
# Les API Key sont spécifiques à chaque région. Pour obtenir une API Key, consultez https://www.alibabacloud.com/help/model-studio/get-api-key
client = dashscope.Client(
    api_key=os.getenv("DASHSCOPE_API_KEY", "YOUR_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

def sample_async_call_kf2v():
    # Appel asynchrone, qui retourne un task_id
    # first_frame_url / last_frame_url sont des champs de la section input qui ne font pas partie de la signature nommée et sont transmis via extra_input
    try:
        job = client.videos.jobs.create(model="wan2.2-kf2v-flash",
                                        prompt="Realistic style. A curious black kitten looks up at the sky. The camera starts at eye level and gradually rises until it captures the kitten’s curious gaze from above.",
                                        extra_input={'first_frame_url': "https://wanx.alicdn.com/material/20250318/first_frame.png",
                                                     'last_frame_url': "https://wanx.alicdn.com/material/20250318/last_frame.png"},
                                        duration=5,  # Fixé à 5 secondes. Ne pas modifier.
                                        prompt_extend=True,
                                        watermark=True)
        print(job)
        print("task_id: %s" % job.task_id)
    except DashScopeError as e:
        print(f"Code de statut HTTP: {e.status_code}")
        print(f"Code d'erreur: {e.code}")
        print(f"Message d'erreur: {e.message}")
        print("Consultez la documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
        return

    # Attend la fin de la tâche asynchrone (interrogation avec backoff exponentiel, budget total par défaut de 24 heures)
    try:
        done = client.videos.jobs.wait(job)
        print(done)
        print(done.video_url)
    except DashScopeError as e:
        print(f"Code de statut HTTP: {e.status_code}")
        print(f"Code d'erreur: {e.code}")
        print(f"Message d'erreur: {e.message}")
        print("Consultez la documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_async_call_kf2v()

Image d'entrée

  • Nombre d'images : une première image et une dernière image.
  • Méthodes d'entrée : URL d'image, chemin de fichier local .
Les exigences de chemin diffèrent selon le langage :SDK Python : prend en charge les chemins absolus et relatifs.

Système d'exploitation

Chemin du fichier d'entrée

Exemple (chemin absolu)

Exemple (chemin relatif)

Linux / macOS

file://{chemin absolu ou relatif}

file:///home/images/test.png

file://./images/test.png

Windows

file://D:/images/test.png

file://./images/test.png

SDK Java : prend en charge uniquement les chemins absolus.

Système d'exploitation

Chemin du fichier d'entrée

Exemple (chemin absolu)

Linux / macOS

file://{chemin absolu}

file:///home/images/test.png

Windows

file:///{chemin absolu}

file:///D:/images/test.png

Exemple de code : plusieurs méthodes d'entrée d'image

Python SDK
import os
import dashscope
from dashscope.v2 import DashScopeError

# Voici la configuration de la région de Singapour. Remplacez {WorkspaceId} par l'ID de votre workspace. La valeur de region varie selon la région.
client = dashscope.Client(
    # Si la variable d'environnement n'est pas configurée, remplacez la ligne suivante par votre API Key de Model Studio : api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

# ========== Méthodes d'entrée d'image (choisissez-en une) ==========
# [Méthode 1] Utiliser une URL d'image publique
first_frame_url = "https://wanx.alicdn.com/material/20250318/first_frame.png"
last_frame_url = "https://wanx.alicdn.com/material/20250318/last_frame.png"

# [Méthode 2] Utiliser un chemin de fichier local (file:// + chemin du fichier)
# Utiliser un chemin absolu :
# first_frame_url = "file://" + "/path/to/your/first_frame.png"  # Linux/macOS
# last_frame_url = "file://" + "C:/path/to/your/last_frame.png"  # Windows
# Ou utiliser un chemin relatif :
# first_frame_url = "file://" + "./first_frame.png"              # Utilisez votre chemin réel.
# last_frame_url = "file://" + "./last_frame.png"                # Utilisez votre chemin réel.

def sample_sync_call_kf2v():
    print('Veuillez patienter...')
    # generate est un appel en une étape (soumet la tâche et attend sa fin) et retourne un Job terminé
    # first_frame_url / last_frame_url sont des champs de la section input qui ne font pas partie de la signature nommée et sont transmis via extra_input
    try:
        job = client.videos.generate(model="wan2.2-kf2v-flash",
                                     prompt="Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view.",
                                     extra_input={'first_frame_url': first_frame_url,
                                                  'last_frame_url': last_frame_url},
                                     resolution="720P",
                                     prompt_extend=True)
        print(job)
        print(job.video_url)
    except DashScopeError as e:
        print(f"Code de statut HTTP: {e.status_code}")
        print(f"Code d'erreur: {e.code}")
        print(f"Message d'erreur: {e.message}")
        print("Consultez la documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_sync_call_kf2v()

Vidéo générée

  • Nombre de vidéos : une.
  • Spécifications : les spécifications varient selon le modèle. Consultez la section Spécifications vidéo.
  • Expiration de l'URL : 24 heures.
  • Dimensions : déterminées par la première image et le paramètre resolution.
    • Le modèle préserve le rapport hauteur/largeur de la première image et ajuste le nombre total de pixels à la cible. Les dimensions de sortie sont automatiquement ajustées pour être divisibles par 16 (exigence d'encodage).
    • Exemple : une entrée de 750×1000 (3:4) avec resolution="720P" (cible ≈ 920K pixels) peut produire une sortie de 816×1104 (rapport ≈ 0,739, ≈ 900K pixels, tous deux divisibles par 16).

Facturation et limitation de débit

  • Pour les détails sur le quota gratuit et la tarification, consultez Wanx-Image-to-Video-First-Last-Frame.
  • Pour la limitation de débit des modèles, consultez Série Wanxiang.
  • Détails de facturation :
    • L'entrée est gratuite. La facturation de la sortie est basée sur les secondes de vidéo générées avec succès.
    • Les appels échoués n'entraînent aucun frais et ne consomment pas de quota gratuit.
    • La fonctionnalité image-vers-vidéo prend également en charge les plans d'épargne.

Référence API

Image-vers-vidéo - première et dernière images - Référence API

FAQ

Q : Comment générer une vidéo avec un rapport hauteur/largeur spécifique (comme 3:4) ?

R : L'API ne permet pas de contrôler directement le rapport hauteur/largeur — seul le paramètre resolution est disponible. Le paramètre resolution contrôle le nombre de pixels, et non le rapport hauteur/largeur. Le modèle préserve le rapport hauteur/largeur de la première image (first_frame_url) avec des ajustements mineurs pour l'encodage (les dimensions doivent être des multiples de 16). Pour une vidéo au format 3:4, importez une première image au format 3:4.
Exemple : une entrée de 750×1000 (3:4) avec resolution="720P" (cible ≈ 920K pixels) peut produire une sortie de 816×1104 (rapport ≈ 0,739, ≈ 900K pixels, tous deux divisibles par 16).

Q : Pourquoi obtiens-je une erreur « url error, please check url! » lors de l'exécution du code SDK ?

R : Assurez-vous que votre version du SDK répond à l'exigence minimale : SDK DashScope Python ≥ 1.25.8 ou SDK DashScope Java ≥ 2.22.6. Les versions antérieures peuvent afficher des erreurs « url error, please check url! ». Mettez à jour le SDK.