Skip to main content

Wan - image-to-video - first frame API reference (2.1-2.6)

Le modèle image-to-video de Wan génère une vidéo fluide à partir d'une première image et d'une invite textuelle .

Documents associés : Guide utilisateur
Wan 2.7 - image-to-video prend en charge la génération vidéo depuis la première image, depuis la première et la dernière image, ainsi que la continuation vidéo. Nous recommandons cette version.La fonctionnalité image-to-video (basée sur la première image) des modèles Wan 2.6 et antérieurs prend uniquement en charge la génération vidéo à partir de la première image.

Disponibilité

Votre modèle, votre URL d'endpoint et votre clé API doivent se trouver dans la même région. Les appels interrégionaux échouent systématiquement.
  • Sélectionner un modèle : confirmez la région où le modèle est disponible.
  • Choisir une URL : sélectionnez l'URL d'endpoint correspondant à la région concernée. Les URL HTTP et DashScope SDK sont toutes deux prises en charge.
  • Configurer une clé API : Obtenez une clé API pour la région, puis configurez la clé API dans vos variables d'environnement.
  • Installer le SDK : pour appeler l'API via le SDK, installez le SDK DashScope.
Les exemples de code de cette rubrique concernent la région Singapour.
Alibaba Cloud Model Studio a publié des domaines spécifiques aux espaces de travail pour les régions Chine (Pékin) et Singapour. Ces nouveaux domaines dédiés offrent des performances supérieures et une stabilité accrue pour les requêtes d'inférence. Nous vous recommandons de migrer vers ces nouveaux domaines :
  • Chine (Pékin) : de https://dashscope.aliyuncs.com vers https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • Singapour : de https://dashscope-intl.aliyuncs.com vers https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
{WorkspaceId} correspond à votre identifiant d'espace de travail, consultable sur la page Workspace Details de la console Alibaba Cloud Model Studio. Le domaine existant reste pleinement fonctionnel.

Appel HTTP

Les tâches image-to-video utilisent une invocation asynchrone (généralement 1 à 5 minutes) : créer la tâche -> interroger les résultats.

Étape 1 : Créer une tâche

  • Singapore
  • Virginia
  • Beijing
  • Frankfurt
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesisRemplacez WorkspaceId par votre véritable ID d'espace de travail.
  • Une fois la tâche créée, utilisez le task_id retourné pour interroger le résultat. Ce task_id reste valide pendant 24 heures. Ne créez pas de tâches en double. Utilisez plutôt un mécanisme d'interrogation pour récupérer le résultat.
  • Pour un guide destiné aux débutants, consultez Appeler des API avec Postman ou cURL.

Paramètres de la requête

  • Narration multi-plans
  • Doublage automatique
  • Audio personnalisé
  • Vidéo silencieuse
  • Invite négative
Cette fonctionnalité est prise en charge uniquement par les modèles de la série Wan2.6.Activez-la en définissant "prompt_extend": true et "shot_type":"multi".
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
        -H 'X-DashScope-Async: enable' \
        -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
        -H 'Content-Type: application/json' \
        -d '{
        "model": "wan2.6-i2v-flash",
        "input": {
            "prompt": "A scene of urban fantasy art. 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 under an urban railway bridge at night. The lighting 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 his rap, with no other dialogue or noise.",
            "img_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
            "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3"
        },
        "parameters": {
            "resolution": "720P",
            "prompt_extend": true,
            "duration": 10,
            "shot_type":"multi"
        }
    }'
En-têtes
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être application/json.
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx.
X-DashScope-Async string (Obligatoire)Active le traitement asynchrone. Les requêtes HTTP ne prennent en charge que les appels asynchrones. La valeur doit être enable.
Si cet en-tête de requête est absent, l'erreur « current user api does not support synchronous calls » est retournée.
Corps de la requête
model string (Obligatoire)Nom du modèle. Modèles disponibles et tarification : tarification des modèles.Exemple : wan2.6-i2v-flash.
input object (Obligatoire)Champs d'entrée incluant l'invite.

Propriétés

prompt string (Facultatif)Décrit les éléments visuels et les caractéristiques souhaités pour la vidéo générée.Prend en charge le chinois et l'anglais. Chaque caractère compte pour un. Le texte dépassant la limite est tronqué. Limites de longueur selon le modèle :
  • Modèles des séries Wan2.6 et Wan2.5 : maximum de 1 500 caractères.
  • wan2.2 et les modèles de la série wan2.1 : maximum de 800 caractères.
Exemple : Un chaton courant sur l'herbe.Conseils de rédaction d'invites : Guide des invites Text-to-Video/Image-to-Video.negative_prompt string (Facultatif)Décrit ce qu'il faut exclure de la vidéo, contraignant ainsi la sortie.Prend en charge le chinois et l'anglais. Maximum de 500 caractères ; le texte plus long est tronqué.Exemple : basse résolution, erreurs, meilleure qualité, mauvaise qualité, défiguré, doigts supplémentaires, mauvaises proportions, etc.img_url string (Obligatoire)URL ou données encodées en Base64 de l'image initiale.Contraintes relatives à l'image :
  • Format d'image : JPEG, JPG, PNG (canal alpha non pris en charge), BMP ou WEBP.
  • Résolution d'image : la largeur et la hauteur doivent toutes deux être comprises dans l'intervalle [240, 8000] pixels.
  • Taille du fichier :
    • Modèles des séries Wan2.6 et Wan2.5 : maximum de 20 Mo.
    • wan2.2 et les modèles de la série wan2.1 : maximum de 10 Mo.
Formats d'entrée pris en charge :
  1. URL publique :
  2. Chaîne d'image encodée en Base64 :
    • Format des données : data:{MIME_type};base64,{base64_data}.
    • Exemple : data:image/png;base64,GDU7MtCZzEbTbmRZ...... (tronqué pour plus de concision).
    • Pour plus de détails, consultez Image d'entrée.
audio_url string (Facultatif)Modèles pris en charge : séries Wan2.6 et Wan2.5.URL du fichier audio. Le modèle génère la vidéo en utilisant cet audio.Formats d'entrée pris en charge :
  1. URL publique :
Contraintes audio :
  • Format : WAV, MP3.
  • Durée : 3 à 30 s.
  • Taille du fichier : maximum de 15 Mo.
  • Gestion des valeurs hors limites : si la durée audio dépasse la duration spécifiée (5 ou 10 secondes), le système tronque automatiquement l'audio aux 5 ou 10 premières secondes, le reste étant ignoré. Si l'audio est plus court que la durée vidéo, la vidéo devient silencieuse après la fin de l'audio. Par exemple, si l'audio dure 3 secondes et la vidéo 5 secondes, les 3 premières secondes de la vidéo de sortie auront du son, tandis que les 2 dernières secondes seront silencieuses.
Exemple : https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3.
parameters object (Facultatif)Contrôles pour la résolution, la durée, la réécriture intelligente d'invite et les filigranes.

Propriétés

resolution string (Facultatif)
La résolution affecte directement le coût. Avant d'appeler l'API, vérifiez la tarification des modèles.
Spécifie le niveau de résolution de la vidéo de sortie. Le modèle adapte la sortie pour atteindre un nombre total de pixels similaire en fonction du niveau sélectionné. Le modèle maintient le rapport d'aspect de sortie aussi proche que possible de celui de l'image d'entrée dansimg_url. Pour plus de détails, consultez la FAQ.La valeur par défaut et les valeurs d'énumération disponibles pour ce paramètre dépendent du paramètre model, comme suit :
  • wan2.6-i2v-flash : valeurs valides : 720P, 1080P. Valeur par défaut : 1080P.
  • wan2.6-i2v : valeurs valides : 720P, 1080P. Valeur par défaut : 1080P.
  • wan2.6-i2v-us : valeurs valides : 720P, 1080P. Valeur par défaut : 1080P.
  • wan2.5-i2v-preview : valeurs valides : 480P, 720P, 1080P. Valeur par défaut : 1080P.
  • wan2.2-i2v-flash : valeurs valides : 480P, 720P. Valeur par défaut : 720P.
  • wan2.2-i2v-plus : valeurs valides : 480P, 1080P. Valeur par défaut : 1080P.
  • wan2.1-i2v-turbo : valeurs valides : 480P, 720P. Valeur par défaut : 720P.
  • wan2.1-i2v-plus : valeurs valides : 720P. Valeur par défaut : 720P.
Exemple : 1080P.duration integer (Facultatif)
La durée affecte directement le coût. Avant d'appeler l'API, vérifiez la tarification des modèles.
Durée de la vidéo de sortie, en secondes. Les valeurs valides dépendent du paramètre model :
  • wan2.6-i2v-flash : entier dans [2, 15]. Valeur par défaut : 5.
  • wan2.6-i2v : entier dans [2, 15]. Valeur par défaut : 5.
  • wan2.6-i2v-us : valeurs valides : 5, 10, 15. Valeur par défaut : 5.
  • wan2.5-i2v-preview : valeurs valides : 5, 10. Valeur par défaut : 5.
  • wan2.2-i2v-plus : fixé à 5 secondes et non modifiable.
  • wan2.2-i2v-flash : fixé à 5 secondes et non modifiable.
  • wan2.1-i2v-plus : fixé à 5 secondes et non modifiable.
  • wan2.1-i2v-turbo : valeurs valides : 3, 4 ou 5. Valeur par défaut : 5.
Exemple : 5.prompt_extend boolean (Facultatif)Indique s'il faut activer la réécriture d'invite. Lorsque cette option est activée, un LLM réécrit l'invite d'entrée. Cela améliore la qualité de génération pour les invites courtes, mais augmente le temps de traitement.
  • true (par défaut)
  • false
Exemple : true.shot_type string (Facultatif)Modèles pris en charge : série Wan2.6.Spécifie le type de plan de la vidéo générée : un seul plan continu ou une séquence de plusieurs plans.Ce paramètre prend effet uniquement lorsque "prompt_extend": true.Priorité des paramètres : shot_type > prompt. Par exemple, si shot_type est défini sur « single », même si l'invite contient « générer une vidéo multi-plans », le modèle produira tout de même une vidéo à plan unique.Valeurs valides :
  • single : valeur par défaut. Génère une vidéo à plan unique.
  • multi : génère une vidéo multi-plans.
Exemple : single.
Utilisez ce paramètre lorsque vous avez besoin d'un contrôle strict de la structure narrative, par exemple un plan unique pour des démonstrations de produits ou plusieurs plans pour des courts métrages.
audio boolean (Facultatif)
Cela affecte le coût. Les vidéos avec son et les vidéos silencieuses ont des prix différents. Vérifiez la tarification dans la console Model Studio.
Modèle pris en charge : wan2.6-i2v-flash.Spécifie s'il faut générer une vidéo avec du son.Priorité des paramètres : audio > audio_url. Lorsque audio=false, la sortie reste une vidéo silencieuse même si une audio_url est fournie, et la facturation est basée sur une vidéo silencieuse.Valeurs valides :
  • true : valeur par défaut. Génère une vidéo avec du son.
  • false : génère une vidéo silencieuse.
Exemple : true.watermark boolean (Facultatif)Spécifie s'il faut ajouter un filigrane « AI Generated » dans le coin inférieur droit de la vidéo.
  • false : valeur par défaut. Aucun filigrane n'est ajouté.
  • true : ajoute un filigrane.
Exemple : false.seedinteger(Facultatif)Graine de nombre aléatoire. Plage de valeurs : [0, 2147483647].Si elle n'est pas spécifiée, le système en génère une. Pour une meilleure reproductibilité, utilisez une graine fixe.La génération est probabiliste. Même avec la même graine, les résultats peuvent différer.Exemple : 12345.

Paramètres de réponse

  • Réponse réussie
  • Réponse d'erreur
Enregistrez le task_id pour interroger l'état et le résultat de la tâche.
{
        "output": {
            "task_status": "PENDING",
            "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
        },
        "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
    }
output objectInformations sur la sortie de la tâche.

Propriétés

task_id stringID de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat de la tâche.

Valeurs d'énumération

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN : la tâche n'existe pas ou son état est inconnu.
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage.
code stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.
message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.

Étape 2 : Interroger le résultat de la tâche

  • Singapore
  • Virginia
  • China (Beijing)
  • Frankfurt
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Remplacez WorkspaceId par votre véritable ID d'espace de travail.
  • Recommandation d'interrogation : la génération vidéo prend plusieurs minutes. Utilisez un mécanisme d'interrogation avec un intervalle raisonnable, par exemple 15 secondes.
  • Transition d'état de la tâche : PENDING → RUNNING → SUCCEEDED ou FAILED.
  • Lien de résultat : après la réussite d'une tâche, une URL vidéo valide pendant 24 heures est retournée. Téléchargez et enregistrez la vidéo dans un stockage permanent, tel que OSS.
  • Validité dutask_id:24 heures**. Passé ce délai, les requêtes retournent l'état de la tâche comme UNKNOWN.

Paramètres de la requête

  • Interroger le résultat de la tâche
Remplacez {task_id} par la valeur task_id retournée par l'appel API précédent. Le task_id est 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"
En-têtes
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx.
Paramètres de chemin
task_id string (Obligatoire)ID de la tâche.

Paramètres de réponse

  • Tâche réussie
  • Échec de la tâche
  • Requête de tâche expirée
Les URL vidéo ne sont valides que pendant 24 heures, puis automatiquement purgées. Enregistrez rapidement les vidéos générées.
{
    "request_id": "2ca1c497-f9e0-449d-9a3f-xxxxxx",
    "output": {
        "task_id": "af6efbc0-4bef-4194-8246-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-25 11:07:28.590",
        "scheduled_time": "2025-09-25 11:07:35.349",
        "end_time": "2025-09-25 11:17:11.650",
        "orig_prompt": "A scene of urban fantasy art. 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 under an urban railway bridge at night. The lighting 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 his rap, with no other dialogue or noise.",
        "video_url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=xxx"
    },
    "usage": {
        "duration": 10,
        "input_video_duration": 0,
        "output_video_duration": 10,
        "video_count": 1,
        "SR": 720
    }
}
outputobjectDétails de la sortie de la tâche.

Propriétés

task_id stringID de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat de la tâche.

Valeurs d'énumération

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN : la tâche n'existe pas ou son état est inconnu.
Transitions d'état lors de l'interrogation :
  • PENDING → RUNNING → SUCCEEDED ou FAILED.
  • L'état initial de la requête est généralement PENDING ou RUNNING.
  • Lorsque l'état passe à SUCCEEDED, la réponse contient l'URL de la vidéo générée.
  • Si l'état est FAILED, vérifiez le message d'erreur et réessayez la tâche.
submit_time stringHeure de soumission de la tâche. L'heure est en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.scheduled_time stringHeure d'exécution de la tâche. L'heure est en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.end_time stringHeure de fin de la tâche. L'heure est en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.video_url stringURL de la vidéo générée. Retournée uniquement lorsque task_status est SUCCEEDED.Valide pendant 24 heures. La vidéo est au format MP4 avec un encodage H.264.orig_prompt stringInvite d'entrée originale, correspondant au paramètre de requête prompt.actual_prompt stringSi prompt_extend est true, le système réécrit l'invite, et ce champ contient la version optimisée.
  • Si prompt_extend=false, ce champ n'est pas retourné.
  • Remarque : le modèle wan2.6 ne retourne pas ce champ, quelle que soit la valeur de prompt_extend.
code stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.
usage objectStatistiques d'utilisation pour la tâche, comptabilisées uniquement pour les tâches réussies.

Propriétés

Paramètres retournés par les modèles de la série wan2.6

input_video_duration integerDurée de la vidéo d'entrée en secondes. Cette valeur est toujours 0, car l'entrée vidéo n'est pas prise en charge actuellement.output_video_duration integerRetourné uniquement lors de l'utilisation des modèles wan2.6.Durée de la vidéo de sortie en secondes. Cette valeur correspond à input.duration.duration integerDurée totale de la vidéo, utilisée pour la facturation.Formule de facturation : duration=input_video_duration+output_video_duration.SR integerRetourné uniquement lors de l'utilisation des modèles wan2.6. Niveau de résolution de la vidéo générée. Exemple : 720.video_count integerNombre de vidéos générées. Cette valeur est fixée à 1.audiobooleanRetourné uniquement lors de l'utilisation du modèle wan2.6-i2v-flash. Indique si la sortie est une vidéo avec audio.
duration integerDurée de la vidéo générée en secondes. Valeurs possibles : 5, 10.Formule de facturation : Coût = Durée vidéo en secondes × Prix unitaire.SR integerRésolution de la vidéo générée. Valeurs possibles : 480, 720, 1080.video_count integerNombre de vidéos générées. Cette valeur est fixée à 1.
video_duration integerDurée de la vidéo générée en secondes. Valeurs possibles : 3, 4, 5.Formule de facturation : Coût = Durée vidéo en secondes × Prix unitaire.video_ratio stringRapport d'aspect de la vidéo générée. Cette valeur est toujours « standard ».video_count integerNombre de vidéos générées. Cette valeur est fixée à 1.
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage.

Appels SDK DashScope

Les noms de paramètres du SDK sont largement cohérents avec ceux de l'API HTTP, en suivant les conventions de chaque langage. Les tâches image-to-video prennent généralement 1 à 5 minutes. Le SDK encapsule le processus d'appel HTTP asynchrone et prend en charge les appels synchrones et asynchrones.
Le temps de traitement dépend de la file d'attente des tâches et de l'état du service.

SDK Python

Assurez-vous que votre version du SDK Python DashScope est au moins 2.0.1 avant d'exécuter le code suivant.Les versions antérieures peuvent déclencher des erreurs telles que « url error, please check url! ». Pour mettre à jour, reportez-vous à Installer le SDK.
Définissez region en fonction de la région du modèle (transmis lors de la construction du Client ; la valeur de region varie selon la région) :
  • Singapore
  • Virginia
  • Beijing
  • Frankfurt
region="ap-southeast-1"Remplacez WorkspaceId par votre véritable ID d'espace de travail.

Exemple de code

  • Appel synchrone
  • Appel asynchrone
Un appel synchrone bloque jusqu'à la fin de la génération vidéo. Cet exemple illustre trois méthodes d'entrée d'image : URL publique, encodage Base64 et chemin de fichier local.
Exemple de requête
import base64
import os
import mimetypes
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-api-reference
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"
    # Pour obtenir une API Key, consultez https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

# --- Fonction utilitaire pour l'encodage Base64 ---
# Format : 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}"

"""
Méthodes d'entrée d'image :
Les trois méthodes suivantes permettent de fournir une image. Choisissez-en une.

1. URL publique : idéale pour les images déjà accessibles publiquement.
2. Fichier local : adapté au développement et aux tests locaux.
3. Encodage Base64 : recommandé pour les images privées ou les données devant être transmises de manière sécurisée.
"""

# [Méthode 1] Utiliser une URL d'image publiquement accessible
# Exemple : utiliser une URL d'image publique
img_url = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"

# [Méthode 2] Utiliser un fichier local (chemins absolus et relatifs pris en charge)
# Format : file:// + chemin du fichier
# Exemple (chemin absolu) :
# img_url = "file://" + "/path/to/your/img.png"    # Linux/macOS
# img_url = "file://" + "C:/path/to/your/img.png"  # Windows
# Exemple (chemin relatif) :
# img_url = "file://" + "./img.png"                # Relatif au répertoire du script courant

# [Méthode 3] Utiliser une image encodée en Base64
# img_url = encode_file("./img.png")

# Définit l'URL de l'audio
audio_url = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3"

def sample_call_i2v():
    print('please wait...')
    # generate est un appel en une étape (soumet la tâche et attend la fin) et renvoie un Job terminé
    # audio_url / negative_prompt sont des champs de la section input qui ne font pas partie de la signature nommée, ils sont transmis via extra_input
    try:
        job = client.videos.generate(model='wan2.6-i2v-flash',
                                     prompt='A scene of urban fantasy art. 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 under an urban railway bridge at night. The lighting 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 his rap, with no other dialogue or noise.',
                                     image_url=img_url,
                                     extra_input={'audio_url': audio_url,
                                                  'negative_prompt': ""},
                                     resolution="720P",
                                     duration=10,
                                     prompt_extend=True,
                                     watermark=False,
                                     seed=12345)
        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")

if __name__ == '__main__':
    sample_call_i2v()
Exemple de réponse
La video_url est valide pendant 24 heures. Téléchargez la vidéo avant son expiration.
{
    "status_code": 200,
    "request_id": "2794c7a3-fe8c-4dd4-a1b7-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "c15d5b14-07c4-4af5-b862-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.mp4?Expires=xxx",
        "submit_time": "2026-01-22 23:24:46.527",
        "scheduled_time": "2026-01-22 23:24:46.565",
        "end_time": "2026-01-22 23:25:59.978",
        "orig_prompt": "A scene of urban fantasy art. 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 under an urban railway bridge at night. The lighting 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 his rap, with no other dialogue or noise."
    },
    "usage": {
        "video_count": 1,
        "video_duration": 0,
        "video_ratio": "",
        "duration": 10,
        "input_video_duration": 0,
        "output_video_duration": 10,
        "audio": true,
        "SR": 720
    }
}

SDK Java

Assurez-vous que votre version du SDK Java DashScope est au moins2.22.6 avant d'exécuter le code suivant.Les versions antérieures peuvent déclencher des erreurs telles que « url error, please check url! ». Pour mettre à jour, reportez-vous à Installer le SDK.
Définissez baseHttpApiUrl en fonction de la région du modèle :
  • Singapore
  • Virginia
  • Beijing
  • Frankfurt
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";Remplacez WorkspaceId par votre véritable ID d'espace de travail.

Exemple de code

  • Appel synchrone
  • Appel asynchrone
Un appel synchrone bloque jusqu'à la fin de la génération vidéo. Cet exemple illustre trois méthodes d'entrée d'image : URL publique, encodage Base64 et chemin de fichier local.
Exemple de requête
// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Base64;
import java.util.HashMap;
import java.util.Map;

public class Image2Video {

    static {
        // Set the endpoint. This example uses the Singapore region. For other regions, see: https://www.alibabacloud.com/help/en/model-studio/image-to-video-api-reference
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // If the environment variable is not set, replace the following line with your API key from Model Studio: apiKey="sk-xxx"
    // Get your API key: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    /**
     * Image input methods: Choose one of the following three.
     *
     * 1. Public URL: Ideal for images that are already publicly accessible.
     * 2. Local file: Suitable for local development and testing.
     * 3. Base64 encoding: Best for private images or when data must be securely transmitted.
     */

    // [Method 1] Public URL
    static String imgUrl = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png";

    // [Method 2] Local file path (file:// + absolute path)
    // static String imgUrl = "file://" + "/your/path/to/img.png";    // Linux/macOS
    // static String imgUrl = "file://" + "C:/your/path/to/img.png";  // Windows

    // [Method 3] Base64 encoding
    // static String imgUrl = Image2Video.encodeFile("/your/path/to/img.png");

    // Set the audio URL
    static String audioUrl = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3";

    public static void image2video() throws ApiException, NoApiKeyException, InputRequiredException {
        // Set the parameters
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);
        parameters.put("watermark", false);
        parameters.put("seed", 12345);

        VideoSynthesis vs = new VideoSynthesis();
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.6-i2v-flash")
                        .prompt("A scene of urban fantasy art. 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 under an urban railway bridge at night. The lighting 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 his rap, with no other dialogue or noise.")
                        .imgUrl(imgUrl)
                        .audioUrl(audioUrl)
                        .duration(10)
                        .parameters(parameters)
                        .resolution("720P")
                        .negativePrompt("")
                        .build();
        System.out.println("please wait...");
        VideoSynthesisResult result = vs.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

     /**
     * Encodes a file into a Base64 string.
     * @param filePath The file path.
     * @return A Base64 string in the format data:{MIME_type};base64,{base64_data}.
     */
    public static String encodeFile(String filePath) {
        Path path = Paths.get(filePath);
        if (!Files.exists(path)) {
            throw new IllegalArgumentException("File does not exist: " + filePath);
        }
        // Detect MIME type
        String mimeType = null;
        try {
            mimeType = Files.probeContentType(path);
        } catch (IOException e) {
            throw new IllegalArgumentException("Cannot detect file type: " + filePath);
        }
        if (mimeType == null || !mimeType.startsWith("image/")) {
            throw new IllegalArgumentException("Unsupported or unrecognized image format");
        }
        // Read file content and encode
        byte[] fileBytes = null;
        try{
            fileBytes = Files.readAllBytes(path);
        } catch (IOException e) {
            throw new IllegalArgumentException("Cannot read file content: " + filePath);
        }

        String encodedString = Base64.getEncoder().encodeToString(fileBytes);
        return "data:" + mimeType + ";base64," + encodedString;
    }

    public static void main(String[] args) {
        try {
            image2video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}
Exemple de réponse
La video_url est valide pendant 24 heures. Téléchargez la vidéo avant son expiration.
{
    "request_id": "87c091bb-7a3c-4904-8501-xxxxxx",
    "output": {
        "task_id": "413ed6e4-5f3a-4f57-8d58-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.mp4?Expires=xxx",
        "orig_prompt": "A scene of urban fantasy art. 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 under an urban railway bridge at night. The lighting 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 his rap, with no other dialogue or noise.",
        "submit_time": "2026-01-22 23:25:45.729",
        "scheduled_time": "2026-01-22 23:25:45.771",
        "end_time": "2026-01-22 23:26:44.942"
    },
    "usage": {
        "video_count": 1,
        "duration": 10.0,
        "input_video_duration": 0.0,
        "output_video_duration": 10.0,
        "SR": "720"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

Limitations

  • Rétention des données : le task_id et l'URL vidéo sont conservés pendant 24 heures. Passé ce délai, vous ne pouvez plus les interroger ni les télécharger.
  • Modération de contenu : toutes les entrées (invites, images) et les vidéos de sortie sont soumises à la modération de contenu. Les violations entraînent une erreur IPInfringementSuspect ou DataInspectionFailed. Codes d'erreur.

Codes d'erreur

Si un appel de modèle retourne un message d'erreur, consultez Codes d'erreur.

FAQ

Q : Comment générer une vidéo avec un rapport d'aspect spécifique ?

R : L'image de première image d'entrée (img_url) détermine le rapport d'aspect de la vidéo de sortie. Cependant, un rapport exact comme 3:4 n'est pas garanti, car de légères variations peuvent survenir.
  • Pourquoi des écarts surviennent-ils ? Le modèle utilise le rapport d'aspect de l'image d'entrée comme base et le combine avec le nombre total de pixels du niveau de résolution sélectionné (resolution) pour calculer la résolution valide la plus proche. Comme la largeur et la hauteur d'une vidéo doivent être des multiples de 16, le modèle ajuste la résolution finale en conséquence. Par conséquent, le rapport d'aspect de sortie n'est pas garanti d'être exactement 3:4, mais il en sera très proche.
    • Par exemple, une image d'entrée de 750×1000 (rapport d'aspect 3:4 = 0,75) avec resolution définie sur « 720P » (une cible d'environ 920 000 pixels au total) produit une sortie de 816×1104 (rapport d'aspect ≈ 0,739, environ 900 000 pixels au total).
  • Recommandations :
    • Contrôler l'entrée : pour de meilleurs résultats, utilisez une image de première image qui possède déjà votre rapport d'aspect cible.
    • Post-traitement : si vous avez besoin d'un rapport d'aspect strict, recadrez la vidéo ou ajoutez des bandes noires à l'aide d'un outil d'édition après la génération.

Q : Comment obtenir la liste d'autorisation de domaine de stockage vidéo ?

R : Les vidéos générées par les modèles sont stockées dans OSS. L'API retourne une URL publique temporaire. Pour configurer une liste d'autorisation de pare-feu pour cette URL de téléchargement, notez ce qui suit : le stockage sous-jacent peut changer dynamiquement. Cette rubrique ne fournit pas de liste d'autorisation de noms de domaine OSS fixe afin d'éviter les problèmes d'accès causés par des informations obsolètes. Si vous avez des exigences de contrôle de sécurité, contactez votre gestionnaire de compte pour obtenir la dernière liste de noms de domaine OSS.