Le modèle de montage vidéo Wan 2.7 accepte des entrées multimodales (texte, images et vidéos) pour le montage par instruction et le transfert de style .
Applicabilité
Le modèle, l'URL de l'endpoint et la clé API doivent tous appartenir à la même région. Les appels interrégions échouent.
- Sélectionnez un modèle : Confirmez la région du modèle.
- Sélectionnez une URL d'endpoint : Choisissez l'URL de l'endpoint correspondant à la région. Les URL HTTP et SDK DashScope sont prises en charge.
- Configurez une clé API : Obtenez une clé API pour la région, puis configurez-la en tant que variable d'environnement.
HTTP
Les tâches de montage vidéo prennent généralement entre 1 et 5 minutes. L'API utilise des appels asynchrones avec deux étapes principales : Créer une tâche -> Interroger le résultat.
Étape 1 : Créer une tâche
- Singapour
- Pékin
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} par votre ID d'espace de travail réel.
- Une fois la tâche créée, utilisez le
task_idrenvoyé pour interroger le résultat. Letask_idest valide pendant 24 heures. Ne créez pas de tâches en double. Utilisez plutôt l'interrogation pour récupérer le résultat. - Pour obtenir des conseils destinés aux débutants, consultez la rubrique Appeler des API avec Postman ou cURL.
Paramètres de la 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. Doit être défini sur enable. | |||||||||||||||||||||||||
Corps de la requête | |||||||||||||||||||||||||
model string (Obligatoire)Nom du modèle.Exemple de valeur : wan2,7-videoedit. | |||||||||||||||||||||||||
input object (Obligatoire)Paramètres d'entrée, y compris l'instruction (prompt).
Propriétés prompt string (Facultatif)Décrit les éléments souhaités et les caractéristiques visuelles dans la vidéo générée.Le chinois et l'anglais sont pris en charge. Chaque caractère chinois ou lettre anglaise compte pour un caractère. Le texte plus long est automatiquement tronqué.
string (Facultatif)Instruction négative décrivant le contenu à exclure de la vidéo, ce qui permet d'affiner le résultat.Le chinois et l'anglais sont pris en charge. La longueur ne peut pas dépasser 500 caractères. Le texte plus long est automatiquement tronqué.Exemple de valeur : low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions.media array (Obligatoire)Liste des ressources multimédias, telles que des images et des vidéos, utilisées comme références pour la génération de la vidéo.Chaque élément du tableau est un objet média contenant les champs type et url.
Propriétés type string (Obligatoire)Type de la ressource multimédia. Valeurs valides :
string (Obligatoire)URL ou données encodées en Base64 de la ressource multimédia. Les ressources incluent des vidéos et des images.
Vidéo d'entrée (type=video) URL du fichier vidéo à modifier.Exigences relatives à la vidéo :
Image d'entrée (type=reference_image) URL ou données encodées en Base64 de l'image de référence.Exigences relatives à l'image :
| |||||||||||||||||||||||||
parameters object (Facultatif)Paramètres de traitement vidéo, tels que la résolution, la durée, la réécriture intelligente de l'instruction et le filigrane.
Propriétés resolution string (Facultatif)Niveau de résolution de la vidéo générée, qui contrôle sa netteté (nombre total de pixels).
string (Facultatif)Ratio d'aspect de la vidéo générée.Comportement :
integer (Facultatif)Durée de la vidéo générée, en secondes.Recommandation : Définissez ce paramètre uniquement pour tronquer la vidéo. Pour conserver la même durée que la vidéo d'entrée, omettez ce paramètre ou transmettez la valeur par défaut 0.Règles d'utilisation :
string (Facultatif)Paramètres audio de la vidéo.
boolean (Facultatif)Active la réécriture intelligente de l'instruction. Lorsqu'elle est activée, un grand modèle réécrit l'instruction d'entrée, améliorant considérablement la qualité de génération pour les instructions courtes, au prix d'un temps de traitement accru.
boolean (Facultatif)Indique s'il faut ajouter un filigrane. Le filigrane se trouve dans le coin inférieur droit de la vidéo avec le texte « AI Generated ».
integer (Facultatif)La graine aléatoire doit être un entier compris dans l'intervalle [0, 2147483647].Si elle n'est pas spécifiée, une graine aléatoire est générée. Une graine fixe améliore la reproductibilité.Étant donné que la génération du modèle est probabiliste, la même graine ne garantit pas des résultats identiques. |
Paramètres de réponse |
Enregistrez le task_id pour interroger l'état et le résultat de la tâche. |
output objectContient la 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 de la tâche.
Valeurs d'énumération
| |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Consultez les Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Consultez les Codes d'erreur. |
Étape 2 : Interroger le résultat
- Singapore
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} par votre ID d'espace de travail réel.
- Recommandation d'interrogation : la génération de vidéo prend plusieurs minutes. Mettez en place 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 vers le résultat : une fois la tâche réussie, une URL de vidéo valide pendant 24 heures est renvoyée. Téléchargez et enregistrez la vidéo dans un stockage permanent, tel que OSS.
- Validité du task_id : 24 heures. Au-delà de cette période, les requêtes renvoient l'état de la tâche comme étant
UNKNOWN.
Paramètres de requête |
Remplacez {task_id} par la valeur task_id renvoyée par l'appel d'API précédent. Le task_id est valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre ID d'espace de travail réel. |
En-têtes | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin | |
task_id string (Obligatoire)Identifiant de la tâche. |
Paramètres de réponse |
Les URL de vidéo ne sont valides que pendant 24 heures, puis sont automatiquement supprimées. Enregistrez rapidement les vidéos générées. |
outputobjectContient la 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 de la tâche.
Valeurs d'énumération
stringHeure de soumission de la tâche. L'heure est exprimée 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 exprimée 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 exprimée 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. Renvoyée uniquement lorsque task_status est SUCCEEDED.Valide pendant 24 heures. La vidéo est au format MP4 avec encodage H.264.orig_prompt stringInvite d'entrée originale, correspondant au paramètre de requête prompt.code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Consultez les Codes d'erreur.message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Consultez les Codes d'erreur. | |
usage objectStatistiques d'utilisation pour la facturation. Facturées uniquement pour les tâches réussies.
Propriétés input_video_duration floatDurée de la vidéo d'entrée, en secondes.output_video_duration floatDurée de la vidéo de sortie, en secondes.duration floatDurée totale de la vidéo, utilisée pour la facturation.Formule de facturation : duration=input_video_duration+output_video_duration.SR integerNiveau de résolution de la vidéo de sortie. Exemple de valeur : 720.video_count integerNombre de vidéos générées. Cette valeur est fixée à 1. | |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. |
SDK DashScope
Les noms de paramètres du SDK sont généralement cohérents avec ceux de l'API HTTP, mais la structure des paramètres respecte les conventions propres à chaque langage.
Le montage vidéo prend généralement entre 1 et 5 minutes. Le SDK gère en interne le processus d'appel HTTP asynchrone et prend en charge les appels synchrones et asynchrones.
La durée de traitement réelle dépend du nombre de tâches en file d'attente et de l'état du service. Patientez jusqu'à l'obtention du résultat.
SDK Python
Définissez region en fonction de la région où se trouve le modèle (elle est passée à la construction du Client ; la valeur de region varie selon la région) :
- Singapore
- China (Beijing)
region="ap-southeast-1"{WorkspaceId} par votre ID d'espace de travail réel.
- Synchronous call
- Asynchronous call
Request example
Response example
L'URL video_url est valide pendant 24 heures. Téléchargez la vidéo dès que possible.
SDK Java
Définissez la constante Constants.baseHttpApiUrl en fonction de la région du service :
- Singapore
- China (Beijing)
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} par votre ID d'espace de travail réel.
- Synchronous call
- Asynchronous call
Request example
Response example
L'URL video_url est valide pendant 24 heures. Téléchargez la vidéo dès que possible.