AGTCloud API Docs
GuidesRéférence APIIntégrations et ressourcesMises à jour et aide
Génération de vidéosWan

Créer une vidéo

Créez des tâches vidéo Wan 3.0 avec la structure native.

Envoyez le modèle standard avec model/input/parameters, à l’adresse API plateforme avec son API Key. Aucun Workspace ID Alibaba Cloud n’est requis. L’asynchronisme est automatique, sans X-DashScope-Async.

POST/api/v1/services/aigc/video-generation/video-synthesis

Authentification

bearerAuth
AuthentificationBearer <token>

Utilisez l’API Key de la plateforme : Authorization: Bearer your-api-key.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

Envoyez la structure native. L’asynchronisme est activé automatiquement, sans X-DashScope-Async.

Corps de réponse

application/json

application/json

application/json

Règles des médias et combinaisons

Fournissez un prompt ou media non vide. Images, vidéos et sons sont numérotés séparément selon leur ordre par type dans le tableau : « 图1 », « 视频1 », « 音频1 ». Aucun ID de référence supplémentaire n’est nécessaire.

MédiaFormat et quantitéLimites essentielles
Images initiale/finaleAu plus 1 first_frame et 1 last_frameL’image finale nécessite l’initiale ; incompatibles avec images, vidéos, sons de référence, fichiers et pages web
Images de référenceAu plus 10 reference_imageJPEG/JPG/PNG sans alpha/BMP/WEBP ; 20MB par image ; chaque côté 240–8000px ; rapport au plus 8:1
Vidéos de référenceAu plus 5 reference_videoMP4/MOV ; chacune 1–15 secondes, total au plus 15 secondes ; 100MB par fichier ; chaque côté 240–4096px ; au moins 16fps ; rapport au plus 8:1
Audio de référenceAu plus 5 reference_audioWAV/MP3 ; chacun 1–15 secondes, total au plus 15 secondes ; 15MB par fichier
FichierAu plus 1 file100MB maximum ; PDF, Word, PowerPoint, Keynote, Pages : au plus 50 pages ; formats dans le tableau des champs
Page webAu plus 1 linkPage publique HTTP/HTTPS sans connexion ; incompatible avec un fichier

Les images initiale/finale suivent les limites des images de référence. Utilisez des URL publiques ou du Base64 préfixé, tel que data:image/png;base64,... pour les images, des URL pour les autres médias. Les médias ordinaires acceptent aussi des adresses OSS accessibles ; les pages utilisent uniquement HTTP/HTTPS. Hors pages web, l’extension éventuelle doit correspondre au format ; une URL sans extension doit respecter les spécifications réelles.

Images, vidéos et sons de référence peuvent être combinés, ainsi qu’un fichier ou une page web, mais file et link s’excluent. Activez prompt_extend avec ces derniers. L’édition et l’extension utilisent une vidéo de référence et un prompt ; l’extension utilise ratio: "adaptive".

La durée est -1 (intelligente) ou un entier de 2~30 secondes. Avec une vidéo de référence, les durées d’entrée et de sortie cumulées ne dépassent pas 30 secondes.

Résultat de création et suite

Conservez output.task_id puis utilisez la consultation native pour l’état et le résultat. request_id sert au traçage, pas aux consultations de tâches. Ne recréez pas la tâche pour suivre sa progression.

Pour les champs communs, utilisez la création au format plateforme. Ne mélangez pas les formats.

Erreurs courantes

Pour HTTP 400, vérifiez JSON, modèle, input/parameters et combinaisons de médias selon l’erreur. L’erreur peut être dans code/message/data ou error imbriqué. Au support, fournissez l’erreur et l’ID de requête, jamais votre API Key.

Documentation officielle Alibaba Cloud Wan 3.0 — génération vidéoConsultez les paramètres natifs, les spécifications des médias et leurs combinaisons.