Skip to main content

Wan - Référence de l'API texte-vers-vidéo (2.1-2.6)

Le modèle texte-vers-vidéo Wan génère des vidéos fluides à partir d' invites textuelles .

Références : Guide d'utilisation

Disponibilité

Pour garantir le succès des appels, le modèle, l'URL de l'endpoint et la clé API doivent tous appartenir à la même région. Les appels interrégionaux échoueront.
  • Sélectionner un modèle : Confirmez la région du modèle.
  • Sélectionner une URL : Choisissez l'URL d'endpoint régionale correspondante. Les URL HTTP et les URL du SDK DashScope sont prises en charge.
  • Configurer une clé API : Sélectionnez une région, obtenez une clé API, puis configurez la clé API comme variable d'environnement (fonctionnalité devant être obsolète et fusionnée dans la configuration de la clé API).
  • Installer le SDK : Pour effectuer des appels via le SDK, vous devez installer le SDK DashScope.
Les exemples de code de cette rubrique s'appliquent à 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 ID d'espace de travail, disponible sur la page Workspace Details de la console Alibaba Cloud Model Studio. Le domaine existant reste pleinement fonctionnel.

HTTP

Cette API utilise le protocole hérité et prend en charge les modèles wan2.6 et antérieurs (wan2.5/wan2.2/wan2.1).
Les tâches texte-vers-vidéo nécessitant un temps de traitement important (généralement 1 à 5 minutes), l'API recourt à une invocation asynchrone. L'ensemble du processus comprend deux étapes principales : Créer une tâche -> Interroger le résultat. Le déroulement est le suivant :

Étape 1 : Créer une tâche et obtenir l'ID de tâche

  • Singapore
  • Virginia
  • Frankfurt
  • Beijing
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 l'interrogation périodique 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 requête

  • Narration multi-plans
  • Fournir un fichier audio
  • Doublage automatique
  • Générer une vidéo muette
  • Utiliser une invite négative
  • Pour une vidéo multi-plans, shot_type doit être défini sur "multi".
  • Pour une vidéo multi-plans, prompt_extend doit être défini sur true afin d'activer la réécriture de l'invite pour optimiser la description des plans.
    # Singapore region URL. 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' \
        -H 'X-DashScope-Async: enable' \
        -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
        -H 'Content-Type: application/json' \
        -d '{
        "model": "wan2.6-t2v",
        "input": {
            "prompt": "Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: \"The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them \".",
            "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3"
        },
        "parameters": {
            "size": "1280*720",
            "prompt_extend": true,
            "duration": 10,
            "shot_type":"multi"
        }
    }'
En-têtes de requête
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 à utiliser. Pour consulter la liste des modèles disponibles, reportez-vous à la liste des modèles.Exemple : wan2.6-t2v.
input object (Obligatoire)Contient les informations d'entrée de base, telles que l'invite.

Propriétés

prompt string (Obligatoire)Invite textuelle décrivant les éléments souhaités et les caractéristiques visuelles de la vidéo générée.L'invite peut être rédigée en chinois ou en anglais. Sa longueur est mesurée en caractères, chaque caractère chinois ou lettre comptant pour un. Le texte dépassant la limite est automatiquement tronqué. Cette limite varie selon la version du modèle :
  • Séries wan2.6 et wan2.5 : Jusqu'à 1 500 caractères.
  • Séries wan2.2 et wan2.1 : Jusqu'à 800 caractères.
Exemple : Un chaton courant au clair de lune.Pour plus d'informations, consultez le Guide des invites texte-vers-vidéo/image-vers-vidéo.negative_prompt string (Facultatif)Invite décrivant le contenu à exclure de la vidéo, permettant d'affiner le résultat généré.Rédigée en chinois ou en anglais, elle ne doit pas excéder 500 caractères. Le texte dépassant cette limite est automatiquement tronqué.Exemple : basse résolution, erreur, meilleure qualité, mauvaise qualité, déformé, doigts supplémentaires, mauvaises proportions.audio_url string (Facultatif)Modèles pris en charge : séries wan2.6 et wan2.5.URL du fichier audio que le modèle utilisera pour générer la vidéo.Formats d'entrée pris en charge :
  1. URL publique :
Limites audio :
  • Format : wav, mp3.
  • Durée : 3 à 30 s.
  • Taille de fichier : Jusqu'à 15 Mo.
  • Gestion des dépassements de durée : Si l'audio excède la valeur spécifiée pour le paramètre duration (par exemple 5 secondes), il est tronqué à cette durée. Si l'audio est plus court que la vidéo, la partie restante de la vidéo sera muette. Par exemple, pour un audio de 3 secondes et une vidéo de 5 secondes, les 3 premières secondes comporteront du son tandis que les 2 dernières seront silencieuses.
parameters object (Facultatif)Paramètres de traitement vidéo, tels que la définition de la résolution, l'activation de la réécriture d'invite ou l'ajout d'un filigrane.

Propriétés

size string (Facultatif)
  • La taille influence directement le coût. Avant tout appel, vérifiez la tarification des modèles.
  • La taille doit correspondre à une valeur précise, telle que 1280*720, et non à un rapport d'aspect (1:1) ou à un niveau de résolution (480P).
Spécifie la résolution de la vidéo générée au format largeur*hauteur. La valeur par défaut et les valeurs valides dépendent du paramètre model, comme détaillé ci-dessous :
  • wan2.6-t2v : La valeur par défaut est 1920*1080 (1080P). Toutes les résolutions des niveaux 720P et 1080P sont valides.
  • wan2.6-t2v-us : La valeur par défaut est 1920*1080 (1080P). Toutes les résolutions des niveaux 720P et 1080P sont valides.
  • wan2.5-t2v-preview : La valeur par défaut est 1920*1080 (1080P). Toutes les résolutions des niveaux 480P, 720P et 1080P sont valides.
  • wan2.2-t2v-plus : La valeur par défaut est 1920*1080 (1080P). Toutes les résolutions des niveaux 480P et 1080P sont valides.
  • wan2.1-t2v-turbo : La valeur par défaut est 1280*720 (720P). Toutes les résolutions des niveaux 480P et 720P sont valides.
  • wan2.1-t2v-plus : La valeur par défaut est 1280*720 (720P). Toutes les résolutions du niveau 720P sont valides.
Niveau 480P : Résolutions vidéo valides et rapports d'aspect correspondants :
  • 832*480 : 16:9.
  • 480*832 : 9:16.
  • 624*624 : 1:1.
Niveau 720P : Résolutions vidéo valides et rapports d'aspect correspondants :
  • 1280*720 : 16:9.
  • 720*1280 : 9:16.
  • 960*960 : 1:1.
  • 1088*832 : 4:3.
  • 832*1088 : 3:4.
Niveau 1080P : Résolutions vidéo valides et rapports d'aspect correspondants :
  • 1920*1080 : 16:9.
  • 1080*1920 : 9:16.
  • 1440*1440 : 1:1.
  • 1632*1248 : 4:3.
  • 1248*1632 : 3:4.
duration integer (Facultatif)
La durée impacte directement le coût. Coût = Prix unitaire (selon la résolution) × Durée (en secondes). Avant tout appel, vérifiez la tarification des modèles.
Durée de la vidéo générée, exprimée en secondes. Les valeurs valides dépendent du paramètre model :
  • wan2.6-t2v : Entier compris entre 2 et 15. Valeur par défaut : 5.
  • wan2.6-t2v-us : Valeurs valides : 5 et 10. Valeur par défaut : 5.
  • wan2.5-t2v-preview : Valeurs valides : 5 et 10. Valeur par défaut : 5.
  • wan2.2-t2v-plus : Fixée à 5 secondes, non modifiable.
  • wan2.1-t2v-plus : Fixée à 5 secondes, non modifiable.
  • wan2.1-t2v-turbo : Fixée à 5 secondes, non modifiable.
prompt_extendboolean (Facultatif)Indique si la réécriture de l'invite est activée. Lorsque cette option est active, le modèle reformule intelligemment l'invite d'entrée, ce qui améliore considérablement la qualité vidéo pour les invites courtes, mais augmente le temps de traitement.
  • true (par défaut)
  • false
shot_type string (Facultatif)Modèles pris en charge : wan2.6.Définit le type de plan de la vidéo générée, c'est-à-dire si elle se compose d'un seul plan continu ou de plusieurs plans changeants.Valeurs valides :
  • single : Valeur par défaut. Génère une vidéo à plan unique.
  • multi : Génère une vidéo multi-plans.
Condition : Ce paramètre n'est effectif que si "prompt_extend": true est défini.Priorité des paramètres : shot_type > prompt. Par exemple, si shot_type est défini sur « single », le modèle produira une vidéo à plan unique même si l'invite contient « générer une vidéo multi-plans ».watermark boolean (Facultatif)Indique s'il faut ajouter un filigrane. Celui-ci apparaît dans le coin inférieur droit de la vidéo avec le texte fixe « AI Generated ».
  • false (par défaut)
  • true
seed integer (Facultatif)La graine aléatoire doit être un entier compris dans l'intervalle [0, 2147483647].Si aucune valeur n'est spécifiée, une graine aléatoire est générée. Une graine fixe améliore la reproductibilité.La génération du modèle étant probabiliste, une même graine ne garantit pas des résultats identiques.

Paramètres de réponse

  • Réponse réussie
  • Réponse d'erreur
Conservez 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 objectContient les informations de sortie de la tâche.

Propriétés

task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat actuel 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 requête pour le suivi et le dépannage.
code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez les Codes d'erreur.
message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez les Codes d'erreur.

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

  • Singapore
  • Virginia
  • Frankfurt
  • Beijing
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 prenant plusieurs minutes, mettez en place un mécanisme d'interrogation périodique 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 le succès d'une tâche, une URL vidéo valide 24 heures est retournée. Téléchargez et sauvegardez la vidéo dans un stockage permanent, tel qu'OSS.
  • Validité dutask_id : 24 heures. Passé ce délai, les requêtes retournent l'état UNKNOWN.

Paramètres de requête

  • Interroger le résultat d'une tâche
Remplacez {task_id} par la valeur task_id retournée lors de l'appel API précédent. Le 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"
En-têtes de requête
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx.
Paramètres de chemin d'URL
task_id string (Obligatoire)Identifiant 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 24 heures avant d'être automatiquement purgées. Sauvegardez rapidement les vidéos générées.
{
        "request_id": "abbf7aa3-9652-4785-a622-xxxxxx",
        "output": {
            "task_id": "38513c71-5190-48e1-9f3b-xxxxxx",
            "task_status": "SUCCEEDED",
            "submit_time": "2025-09-29 14:05:22.119",
            "scheduled_time": "2025-09-29 14:05:28.278",
            "end_time": "2025-09-29 14:10:00.437",
            "orig_prompt": "Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective's office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: 'The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them '",
            "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
        },
        "usage": {
            "duration": 10,
            "size": "1280*720",
            "input_video_duration": 0,
            "output_video_duration": 10,
            "video_count": 1,
            "SR": 720
        }
    }
outputobjectContient les informations de sortie de la tâche.

Propriétés

task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat actuel 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 relancez 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 stringLorsque prompt_extend=true, le système réécrit l'invite d'entrée. Ce champ retourne l'invite optimisée utilisée pour la génération.
  • Si prompt_extend=false, ce champ n'est pas retourné.
  • Remarque : Le modèle wan2.6 ne retourne jamais ce champ, quelle que soit la valeur de prompt_extend.
code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez les Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez les Codes d'erreur.
usage objectContient des statistiques sur la sortie. Ces informations ne sont fournies que pour les tâches réussies.

Propriétés

video_duration integerRetourné uniquement avec les modèles wan2.5 et antérieurs. Utilisé pour la facturation.Durée de la vidéo générée en secondes. Les valeurs valides sont 5 et 10.duration floatRetourné uniquement avec le modèle wan2.6. Utilisé pour la facturation.Indique la durée totale de la vidéo, où duration = input_video_duration + output_video_duration.input_video_duration integerRetourné uniquement avec le modèle wan2.6. Fixé à 0.output_video_duration integerRetourné uniquement avec le modèle wan2.6.Durée de la vidéo de sortie en secondes. Sa valeur est identique à celle de input.duration.SR integerRetourné uniquement avec le modèle wan2.6. Niveau de résolution de la vidéo générée. Exemple : 720.size stringRetourné uniquement avec le modèle wan2.6. Résolution de la vidéo générée. Format : « largeurhauteur ». Exemple : 19201080.video_ratio stringRetourné uniquement avec les modèles wan2.5 et antérieurs. Résolution de la vidéo générée. Format : « largeurhauteur ». Exemple : 832480.video_count integerNombre de vidéos générées. Fixé à 1.
request_id stringIdentifiant unique de requête pour le suivi et le dépannage.

SDK DashScope

Les noms de paramètres du SDK correspondent en grande partie à ceux de l'API HTTP, et leur structure est encapsulée pour s'aligner sur les spécificités du langage de programmation. Les tâches texte-vers-vidéo pouvant prendre beaucoup de temps (généralement 1 à 5 minutes), le SDK encapsule le processus d'appel asynchrone HTTP et prend en charge les modes d'invocation synchrone et asynchrone.
Le temps de traitement réel dépend du nombre de tâches en attente et de l'état du service. Patientez jusqu'à l'obtention du résultat.

Python

Assurez-vous que votre version du SDK Python DashScope est au moins 2.0.1 avant d'exécuter le code suivant.Si vous utilisez une version antérieure, vous risquez de rencontrer des erreurs telles que « url error, please check url! ». Pour mettre à jour le SDK, consultez Installer le SDK.
Définissez region en fonction de la région où se trouve le 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.
  • Invocation synchrone
  • Invocation asynchrone
Exemple de requête
import dashscope
import os
from dashscope.v2 import DashScopeError

# Voici la configuration de la région de Singapour (ap-southeast-1). Remplacez {WorkspaceId} par l'ID de votre workspace lors de l'appel. 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"
    # Les API Key varient selon la région. Pour plus d'informations, consultez https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

def sample_sync_call_t2v():
    # generate est un appel en une étape (soumet la tâche et attend la fin) qui renvoie un Job terminé
    print('Please wait...')
    # audio_url et negative_prompt sont des champs de la section input, absents de la signature nommée ; ils sont transmis via extra_input
    try:
        job = client.videos.generate(model='wan2.6-t2v',
                                     prompt="Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: 'The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them.'",
                                     extra_input={'audio_url': 'https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3',
                                                  'negative_prompt': ""},
                                     size='1280*720',
                                     duration=10,
                                     prompt_extend=True,
                                     watermark=False,
                                     seed=12345)
        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_t2v()
Exemple de réponse
L'URL video_url est valide pendant 24 heures. Téléchargez-la rapidement.
{
    "status_code": 200,
    "request_id": "167f3beb-3dd0-47fe-a83c-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "5b65411f-d946-4e29-859e-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-bj.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
        "submit_time": "2025-10-23 11:47:23.879",
        "scheduled_time": "2025-10-23 11:47:34.351",
        "end_time": "2025-10-23 11:52:35.323",
        "orig_prompt": "Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective's office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: 'The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them '."
    },
    "usage": {
        "video_count": 1,
        "duration": 10,
        "size": "1280*720",
        "input_video_duration": 0,
        "output_video_duration": 10,
        "SR": 720
    }
}

Java

Assurez-vous que votre version du kit de développement logiciel (SDK) Java DashScope est au moins2.22.14 avant d'exécuter le code suivant.Si vous utilisez une version antérieure, vous risquez de rencontrer des erreurs telles que « url error, please check url! ». Pour mettre à jour le SDK, consultez Installer le SDK.
Définissez Constants.baseHttpApiUrl en fonction de la région où se trouve le 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.
  • Invocation synchrone
  • Invocation asynchrone
Exemple de requête
// Copyright (c) Alibaba, Inc. and its affiliates.

// dashscope SDK version 2.18.2 or later
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.util.HashMap;
import java.util.Map;

public class Text2Video {

    static {
        // Singapore region URL. Replace {WorkspaceId} with your actual workspace ID. URLs vary by region. For more information, see https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // If no environment variable is configured, replace the value with your Model Studio API key: apiKey = "sk-xxx".
    // API keys vary by region. For more information, see https://www.alibabacloud.com/help/en/model-studio/get-api-key.
    public static String apiKey = System.getenv("DASHSCOPE_API_KEY");

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

        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.6-t2v")
                        .prompt("Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: 'The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them'.")
                        .audioUrl("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250929/stjqnq/%E7%8B%90%E7%8B%B8.mp3")
                        .negativePrompt("")
                        .size("1280*720")
                        .duration(10)
                        .parameters(parameters)
                        .build();
        System.out.println("Please wait...");
        VideoSynthesisResult result = vs.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            text2Video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}
Exemple de réponse
L'URL video_url est valide pendant 24 heures. Téléchargez-la 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",
        "orig_prompt": "Shot from a low angle, in a medium close-up, with warm tones, mixed lighting (the practical light from the desk lamp blends with the overcast light from the window), side lighting, and a central composition. In a classic detective office, wooden bookshelves are filled with old case files and ashtrays. A green desk lamp illuminates a case file spread out in the center of the desk. A fox, wearing a dark brown trench coat and a light gray fedora, sits in a leather chair, its fur crimson, its tail resting lightly on the edge, its fingers slowly turning yellowed pages. Outside, a steady drizzle falls beneath a blue sky, streaking the glass with meandering streaks. It slowly raises its head, its ears twitching slightly, its amber eyes gazing directly at the camera, its mouth clearly moving as it speaks in a smooth, cynical voice: 'The case was cold, colder than a fish in winter. But every chicken has its secrets, and I, for one, intended to find them '",
        "submit_time": "2026-01-22 23:13:40.553",
        "scheduled_time": "2026-01-22 23:13:49.415",
        "end_time": "2026-01-22 23:17:56.380"
    },
    "usage": {
        "video_count": 1,
        "duration": 10.0,
        "size": "1280*720",
        "input_video_duration": 0,
        "output_video_duration": 10,
        "SR": 720
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

Codes d'erreur

Si l'appel du modèle échoue et retourne un message d'erreur, consultez les Codes d'erreur pour obtenir une solution.

FAQ

Q : Comment convertir un lien vidéo temporaire en lien permanent ?

R : Il est impossible de convertir directement le lien. La procédure correcte consiste à faire récupérer l'URL par votre service backend, à télécharger le fichier vidéo, puis à le transférer vers un service de stockage d'objets permanent, tel qu'Alibaba Cloud Object Storage Service (OSS), afin de générer un nouveau lien d'accès permanent.
import requests

def download_and_save_video(video_url, save_path):
    try:
        response = requests.get(video_url, stream=True, timeout=300) # Set a timeout
        response.raise_for_status() # Raise an exception if the HTTP status code is not 200
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"Video successfully downloaded to: {save_path}")
        # Add the logic to upload to permanent storage here
    except requests.exceptions.RequestException as e:
        print(f"Failed to download the video: {e}")

if __name__ == '__main__':
    video_url = "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxxx"
    save_path = "video.mp4"
    download_and_save_video(video_url, save_path)

Q : Le lien vidéo retourné peut-il être lu directement dans un navigateur ?

R : Non. Vous ne devez pas lire le lien directement dans un navigateur car il expire au bout de 24 heures. Téléchargez et stockez plutôt la vidéo, puis utilisez un lien permanent pour la lecture.