Passer au contenu principal

Introduction

Wan est un service vidéo AI fourni par Ace Data Cloud, basé sur le modèle de génération vidéo Wanxiang d’Alibaba. Grâce à l’API unifiée d’Ace Data Cloud, vous pouvez intégrer rapidement Wan avec Python pour réaliser des fonctionnalités telles que la génération de vidéo à partir de texte, d’images, de vidéos de référence, ainsi que la prise en charge de plusieurs résolutions.

Prérequis

  • Posséder un compte Ace Data Cloud et obtenir un Token API
  • Environnement Python 3.7 ou supérieur
  • Installer la bibliothèque requests : pip install requests

Utilisation de base

Le point d’accès principal pour appeler l’API Wan est :
POST https://api.acedata.cloud/wan/videos
Cet exemple utilise le modèle wan2.6-t2v.
Les modèles disponibles incluent : wan2.6-t2v, wan2.6-i2v, wan2.6-r2v, wan2.6-i2v-flash.
Exemple complet de code Python :
import requests

url = "https://api.acedata.cloud/wan/videos"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "text2video",
    "model": "wan2.6-t2v",
    "prompt": "Astronauts shuttle from space to volcano",
    "resolution": "720P"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Veuillez remplacer YOUR_API_TOKEN par le Token réel obtenu sur la plateforme Ace Data Cloud.

Gestion de la réponse

Après un appel réussi, l’API retourne des données au format JSON. Il est recommandé de vérifier le code de statut HTTP :
if response.status_code == 200:
    result = response.json()
    print("Appel réussi :", result)
else:
    print(f"Échec de l'appel, code de statut : {response.status_code}")
    print(response.text)

Utilisation avancée

Pour les API supportant les tâches asynchrones, vous pouvez obtenir les résultats via une URL de rappel (callback) :
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Les résultats seront envoyés à votre serveur via l'URL de callback

Gestion des erreurs

Codes d’erreur courants :
Code de statutDescription
401Échec d’authentification, vérifiez le Token API
403Solde insuffisant ou accès refusé
429Limite de fréquence dépassée
500Erreur interne du serveur

Autres points d’accès

Le service Wan propose également les points d’accès suivants :
  • POST https://api.acedata.cloud/wan/tasks

Étapes suivantes