Wan2.7
Génération vidéo Wan2.7
- Modèle de génération vidéo Alibaba Cloud Wanxiang 2.7 (point d’entrée unifié)
- Routage automatique selon les paramètres : Text-to-Video / Image-to-Video (première trame, première-dernière trame, continuation de vidéo)
- Prend en charge les résolutions 720P/1080P, durée 2 à 15 secondes
- Prend en charge l’audio personnalisé (musique de fond en mode Text-to-Video, audio directeur en mode Image-to-Video)
POST
Autorisation
string
requis
Tous les endpoints API requièrent une authentification par Bearer TokenObtenez votre API Key :Visitez la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la à l’en-tête de la requête :
Routage des modes
wan2.7 est un point d’entrée unifié pour Text-to-Video et Image-to-Video. Le backend détermine automatiquement le mode en fonction des paramètres entrants. Les deux modes sont facturés de façon identique :
Paramètres de la requête
string
requis
Nom du modèle de génération vidéo, fixé à
wan2.7boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
true: vérifier les prompts et les images d’entrée avecomni-moderation-latestfalseou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
Description du contenu de la vidéo, jusqu’à 5000 caractères
- Mode Text-to-Video (lorsqu’aucune image/vidéo n’est fournie) : obligatoire
- Mode Image-to-Video : optionnel, mais recommandé pour guider les mouvements de caméra et les actions
"A cat chasing butterflies on the grass, bright sunshine, slow motion"array<string>
Tableau d’URLs d’images. Le fournir active automatiquement le mode Image-to-Video
- 1 image : première trame vers vidéo
- 2 images : première-dernière trame vers vidéo (1re = première trame, 2e = dernière trame)
image_with_rolesarray<object>
Tableau d’images avec rôles, alternative à
image_urls, permettant de spécifier précisément le rôle de chaque imageChamps de chaque objet :url(string) : URL de l’image (prend en charge http/https)role(string) : rôle de l’image,first_frame/last_frame, par défautfirst_frame
array<string>
Tableau d’URLs vidéo. Le fournir active le mode continuation de vidéo (seule la 1re vidéo est utilisée)
Contraintes vidéo :
- Format : mp4, mov
- Durée : 2–10s
- Résolution : largeur et hauteur dans la plage [240, 4096] pixels
- Rapport d’aspect : 1:8 – 8:1
- Taille de fichier : jusqu’à 100 Mo
string
Prompt négatif décrivant le contenu indésirable, jusqu’à 500 caractèresExemple :
"blurry, distorted, low quality"string
défaut:"1080P"
Résolution de la vidéoOptions :
720P— standard1080P— haute définition (par défaut)
integer
défaut:"5"
Durée de la vidéo (secondes)Plage prise en charge :
2 ~ 15 secondesPar défaut : 5string
défaut:"16:9"
Rapport d’aspect, effectif uniquement en mode Text-to-Video (lorsqu’aucune image/vidéo n’est fournie)Formats pris en charge :
16:9— écran large paysage (par défaut)9:16— portrait1:1— carré4:3— paysage3:4— portrait
string
URL d’audio personnalisé
- Mode Text-to-Video : utilisé comme musique de fond
- Mode Image-to-Video : utilisé comme audio directeur, synchronisé avec les actions à l’écran
boolean
défaut:"true"
Activer la réécriture intelligente du promptAméliore significativement les résultats pour les prompts courts, mais augmente le temps de traitementPar défaut :
trueboolean
défaut:"false"
Ajouter un filigrane « AI Generated » à la vidéo générée
true: ajouter un filigranefalse: sans filigrane (par défaut)
integer
Entier servant de graine pour contrôler le caractère aléatoire du contenu généréPlage de valeurs : entier
≥ 0- Pour des requêtes identiques, le modèle génère des résultats différents lorsqu’il reçoit des valeurs de graine différentes (par exemple, omettre la graine)
- Pour des requêtes identiques, le modèle génère des résultats similaires lorsqu’il reçoit la même valeur de graine, mais une cohérence exacte n’est pas garantie
Réponse
integer
Code de statut de la réponse, 200 en cas de succès
array
Tableau de données de la réponse
Cas d’utilisation
Cas 1 : Texte vers vidéo (requête la plus simple)
Cas 2 : Texte vers vidéo (paramètres complets)
Cas 3 : Première trame vers vidéo
Cas 4 : Première-dernière trame vers vidéo
Avec 2 images : la 1re est la première trame, la 2e la dernière. Vous pouvez aussi utiliser image_with_roles pour une spécification précise.
Cas 5 : Continuation de vidéo
Cas 6 : Image + audio directeur
Guide de sélection du mode
Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un
task_id lors de la soumission. Utilisez l’endpoint Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.