Le modèle d'humain numérique wan2.2-s2v génère des vidéos naturelles de parole, de chant ou de performance à partir d' une seule image et d'un fichier audio .
- Pilotage par l'audio : Fournissez un enregistrement vocal pour animer la personne présente sur une image statique, en synchronisant les mouvements des lèvres, les expressions faciales et les gestes avec le son.
- Scénarios variés : Trois modes de synchronisation labiale sont pris en charge : « parole », « chant » et « performance ».
- Styles de personnages diversifiés : Compatible avec les personnes réelles (portrait, plan taille, corps entier) ainsi que les personnages de dessin animé.
- Résolution vidéo de sortie : Options disponibles en 480P et 720P.
Modèles et tarification
Nom du modèle | Prix | Limitation de débit (partagée entre le compte principal et les utilisateurs RAM) | |
|---|---|---|---|
Limite RPS de soumission de tâches | Limite de tâches simultanées | ||
wan2.2-s2v | 480P : 0,071677 $/seconde 720P : 0,129018 $/seconde | 5 | 1 |
API HTTP
Prérequis
- Activez le service et obtenez une clé API : Obtenir une clé API.
- Configurez les variables d'environnement : Configurer la clé API comme variable d'environnement.
Étape 1 : Créer une tâche pour obtenir un ID de tâche
{WorkspaceId} par votre ID d'espace de travail.
- Le traitement de ce modèle étant long, la création des tâches s'effectue de manière asynchrone.
- Dès la création de la tâche, le système retourne immédiatement un task_id. À l'étape suivante, utilisez ce task_id pour interroger le résultat de la tâche dans un délai de 24 heures.
Paramètres de requête
| Paramètre | Type | Emplacement | Obligatoire | Description | Valeur d'exemple |
|---|---|---|---|---|---|
| Content-Type | String | Header | Oui | Type de requête : application/json. | application/json |
| Authorization | String | Header | Oui | Clé API au format Bearer sk-xxx. | Bearer sk-1a**2b |
| X-DashScope-Async | String | Header | Oui | Valeur fixe : enable. Indique l'utilisation de la méthode d'appel asynchrone. | enable |
| model | String | Body | Oui | Spécifie le modèle à appeler. | wan2.2-s2v |
| input.image_url | String | Body | Oui | URL de l'image téléchargée.
| http://aaa/bbb.jpg |
| input.audio_url | String | Body | Oui | URL du fichier audio téléchargé.
| http://aaa/bbb.mp3 |
| parameters.resolution | String | Body | Non | Niveau de résolution vidéo.Valeurs valides : 480P et 720P. Valeur par défaut : 480P.Le modèle s'efforce de conserver le rapport d'aspect de la vidéo de sortie identique à celui de l'image d'entrée, tout en ajustant le nombre total de pixels au niveau sélectionné sans modifier ce rapport.
Exemples 480P : généralement 640 x 480 (environ 310 000 pixels), rapport d'aspect 4:3.720P : généralement 1280 x 720 (environ 920 000 pixels), rapport d'aspect 16:9.Exemple : Si l'image d'entrée a un rapport d'aspect de 4:5 et que vous sélectionnez le niveau 480P, la vidéo de sortie conserve le rapport 4:5 et la résolution est ajustée à environ 310 000 pixels. Par exemple, la résolution de la vidéo de sortie peut être de 480 x 600, soit un total de 288 000 pixels. Ces données sont fournies à titre indicatif uniquement ; la sortie réelle peut varier. | 480P |
Paramètres de réponse
Paramètre | Type | Description | Valeur d'exemple |
|---|---|---|---|
output.task_id | String | ID unique de la tâche asynchrone. | a8532587-fa8c-4ef8-82be-0c46b17950d1 |
output.task_status | String | État de la tâche après soumission asynchrone. | PENDING |
request_id | String | ID unique de cette requête. | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
Exemple de requête
Exemple de réponse
Étape 2 : Interroger les résultats par ID de tâche
Utilisez le task_id obtenu à l'étape précédente pour envoyer une requête GET afin de consulter l'état et le résultat de la tâche. Remplacez {task_id} dans l'URL par votre ID de tâche, et remplacez {WorkspaceId} par votre ID d'espace de travail.
- Les tâches de génération vidéo prennent du temps (environ 5 à 10 minutes). Nous recommandons d'utiliser un mécanisme d'interrogation avec un intervalle raisonnable (par exemple, 15 secondes) pour récupérer les résultats.
- La video_url retournée après le succès d'une tâche est valide pendant 24 heures. Téléchargez et enregistrez la vidéo sans tarder.
Paramètres de requête
Paramètre | Type | Emplacement | Obligatoire | Description | Valeur d'exemple |
|---|---|---|---|---|---|
Authorization | String | Header | Oui | Clé API, par exemple Bearer sk-xxx. | Bearer sk-xxx |
task_id | String | Url Path | Oui | ID de la tâche à interroger. | a8532587-fa8c-4ef8-82be-0c46b17950d1 |
Paramètres de réponse
| Paramètre | Type | Description | Valeur d'exemple |
|---|---|---|---|
| output.task_id | String | ID de la tâche interrogée. | a8532587-fa8c-4ef8-82be-0c46b17950d1 |
| output.task_status | String | État de la tâche. Valeurs possibles :
| SUCCEEDED |
| output.submit_time | String | Heure de soumission de la tâche. | 2025-09-01 09:37:27.468 |
| output.scheduled_time | String | Heure de début d'exécution de la tâche. | 2025-09-01 09:37:34.885 |
| output.end_time | String | Heure de fin de la tâche. | 2025-09-01 09:40:20.734 |
| output.results.video_url | String | Fichier vidéo généré.La video_url est valide pendant 24 heures. Téléchargez-la rapidement. | https://xxx/1.mp4?Expires=xxx |
| usage.duration | Float | Durée de la vidéo en secondes. Utilisée pour la facturation, calculée à la seconde. | 10,23 |
| usage.video_count | Integer | Nombre de vidéos générées. | 1 |
| usage.SR | Integer | Niveau de résolution de la vidéo générée. | 480 |
| usage.size | String | Résolution de la vidéo générée par cette requête. | "size": "640*480" |
| usage.fps | Integer | Fréquence d'images de la vidéo générée par cette requête. | "fps": 16 |
| output.code | String | Code d'erreur. Retourné lorsque la tâche échoue. | InvalidParameter |
| output.message | String | Détails de l'erreur. Retournés lorsque la tâche échoue. | The request is missing required parameters or in a wrong format |
| request_id | String | ID unique de cette requête. | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
Exemple de requête
Remplacez 86ecf553-d340-4e21-xxxxxxxxx par le task_id réel, et remplacez {WorkspaceId} par votre ID d'espace de travail.
Exemple de réponse
- Réponse réussie
- Réponse d'échec
Facturation et limitation de débit
- Pour les quotas gratuits et la tarification des modèles, consultez Wanx-Digital Human.
- Pour la limitation de débit des modèles, consultez Série Wanxiang.
-
Notes sur la facturation :
- L'entrée n'est pas facturée ; seule la sortie l'est. Le coût dépend du nombre de secondes de la vidéo générée avec succès.
- Les appels de modèle ayant échoué ou les erreurs de traitement ne sont pas facturés et ne consomment pas le Quota gratuit pour les nouveaux utilisateurs.