Remplace le personnage principal d'une vidéo par un personnage issu d'une image, tout en conservant la scène originale, l'éclairage et la tonalité pour une intégration transparente.
- Fonctionnalités principales : Substitue le personnage d'une vidéo par une personne provenant d'une image spécifiée, en préservant les actions, les expressions et l'environnement de la vidéo originale.
- Cas d'usage : Idéal pour remplacer des personnages lors de la création de contenus dérivés et en post-production.
Exemples
wan2,2-animate-mix prend en charge deux modes de service : le mode standard (wan-std) et le mode professionnel (wan-pro). Consultez la section Facturation et limitation du débit pour connaître les différences de performance et de tarification.
| Image du personnage | Vidéo de référence | Vidéo générée (mode standardwan-std) | Vidéo générée (mode professionnelwan-pro) |
|---|---|---|---|
![]() |
HTTP
Obtenez une clé API et exportez-la en tant que variable d'environnement.
Le remplacement de personnage étant une opération longue, l'API utilise une invocation asynchrone : créez une tâche, puis interrogez régulièrement le système pour obtenir le résultat.
Étape 1 : Créer une tâche
Singapour :POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
Pékin :POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
- Une fois la tâche créée, utilisez le
task_idretourné pour interroger le résultat. Cetask_idreste 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 |
Voici l'URL de la région Singapour. Remplacez {WorkspaceId} par votre ID d'espace de travail Bailian. Les URL varient selon la région. |
En-têtes | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être défini à application/json. | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'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. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Définissez cette valeur à wan2.2-animate-mix. | |
input object (Obligatoire)Images et vidéo d'entrée pour le remplacement de personnage.
Propriétés image_url string (Obligatoire)URL HTTP ou HTTPS accessible publiquement pour l'image du personnage. L'URL ne doit pas contenir de caractères non ASCII (par exemple, des caractères chinois). Si c'est le cas, encodez l'URL avant de la transmettre.
string (Obligatoire)URL HTTP ou HTTPS accessible publiquement pour la vidéo de référence. L'URL ne doit pas contenir de caractères non ASCII (par exemple, des caractères chinois). Si c'est le cas, encodez l'URL avant de la transmettre.Astuce : Une résolution et une fréquence d'images plus élevées améliorent la qualité du résultat.
boolean (Facultatif)Ajoute un filigrane « AI Generated » dans le coin inférieur droit de la vidéo générée.
| |
parameters object (Obligatoire)
Propriétés check_image boolean (Facultatif)Détermine si l'image d'entrée est vérifiée avant le traitement.
string (Obligatoire)Mode de service. Deux modes sont disponibles :
|
Paramètres de la réponse |
Conservez le task_id pour interroger l'état et le résultat de la tâche. |
output objectInformations de 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
| |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. | |
message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez la section Codes d'erreur. | |
code stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez la section Codes d'erreur. |
Étape 2 : Interroger le résultat par ID de tâche
- Chine (Pékin)
- Singapour
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Singapour
- Chine (Pékin)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Recommandation d'interrogation : La génération 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 du résultat : Une fois la tâche réussie, 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é du task_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 |
Remplacez 0385dc79-5ff8-4d82-bcb6-xxxxxx par votre véritable task_id.Voici l'URL de la région Singapour. Remplacez {WorkspaceId} par votre ID d'espace de travail Bailian. Les URL varient selon la région. |
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 URL | |
task_id string (Obligatoire)ID de la tâche. |
Paramètres de la réponse |
Les URL vidéo ne sont valides que pendant 24 heures, puis sont automatiquement purgées. Enregistrez rapidement les vidéos générées. |
output objectInformations de 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
stringHeure de soumission de la tâche. L'heure est au format 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 au format 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 au format UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.results object
Propriétés 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.stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez la section Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez la section Codes d'erreur. | |
usage objectRetourné uniquement pour les tâches réussies.
Propriétés video_duration floatDurée de la vidéo générée, en secondes.video_ratio stringMode de service utilisé pour cette requête. Retourne standard pour le mode wan-std, ou pro pour le mode wan-pro. | |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. |
Limitations
Rétention des données : Les ID de tâche et les URL vidéo sont conservés pendant 24 heures. Téléchargez la vidéo sur votre appareil local avant leur expiration.
Modération du contenu : Tout le contenu d'entrée et de sortie est soumis à modération. Un contenu prohibé retourne les erreurs IPInfringementSuspect ou DataInspectionFailed. Pour plus de détails, consultez la section Codes d'erreur.
Facturation et limitation du débit
- Pour le quota gratuit et le prix unitaire, consultez la section Tarification des modèles.
- Pour les limites de débit, consultez la section Série Wan.
-
Détails de facturation :
- La facturation repose sur la durée de la vidéo générée (en secondes), uniquement pour les vidéos produites avec succès. L'entrée n'est pas facturée.
- Les appels échoués et les erreurs de traitement n'entraînent aucun frais et ne consomment pas de quota gratuit.
Codes d'erreur
En cas d'échec d'un appel, consultez la section Codes d'erreur.
FAQ
Q : Comment consulter l'utilisation des appels de modèle ?
R : Les données d'invocation présentent un délai d'environ 1 heure. Consultez les métriques (volume d'invocations, nombre et taux de réussite) sur la page Monitoring (Singapour ou Pékin). Pour plus d'informations, consultez Comment consulter les historiques d'invocation de modèle ?
Q : Comment améliorer la qualité des vidéos générées ?
R : Pour obtenir de meilleurs résultats :
- Cadrez le personnage de manière cohérente dans l'image d'entrée et la vidéo de référence.
- Maintenez des proportions corporelles cohérentes entre l'image et la vidéo.
- Utilisez des sources haute définition : des images floues ou des vidéos à faible fréquence d'images réduisent la précision des détails.
Q : Comment convertir un lien vidéo temporaire en lien permanent ?
R : La conversion directe n'est pas prise en charge. Configurez votre backend pour télécharger la vidéo et la téléverser vers Object Storage Service (OSS) afin d'obtenir un lien d'accès permanent.
Exemple de code : Télécharger une vidéo sur un appareil local
Exemple de code : Télécharger une vidéo sur un appareil local
