API Wan 3.0 Video Prime

Utilisez wan3.0-video-prime via l’API vidéo asynchrone APIMaster. L’intégration actuelle fournit 480P / 720P / 1080P, 2 à 30 secondes entières et une vidéo par tâche. Révision des paramètres et de l’intégration : 2026-10-26.

Points de terminaison et authentification

Opération	Méthode et URL
Créer	POST https://apimaster.ai/v1/videos
Interroger	GET https://apimaster.ai/v1/videos/{task_id}
Télécharger	GET https://apimaster.ai/v1/videos/{task_id}/content

Utilisez Authorization: Bearer YOUR_API_KEY sur chaque requête et Content-Type: application/json lors de la création d’une tâche. Utilisez une clé API APIMaster, et non une clé Alibaba Cloud. APIMaster fournit l’en-tête asynchrone amont ; vous n’avez pas besoin de X-DashScope-Async.

Le point de terminaison de création compatible /videos/generations renvoie une enveloppe de réponse différente ; les exemples ci-dessous utilisent systématiquement /videos.

Capacités actuelles des routes

Deux intégrations servent actuellement ce modèle : la route native Alibaba Cloud et la route GMI. Les champs avancés nécessitent la route correspondante ; soumettre un champ ne sélectionne pas cette route. Confirmez à quelle route votre clé API peut accéder avant d’utiliser des exemples spécifiques à une route.

Capacité	Natif Alibaba Cloud	GMI
Génération texte-vidéo, première image, premières/dernières images, images de référence	Intégré	Intégré, avec des champs multimédias différents
Audio de référence	metadata.input.media	audio_url
Document / page web publique	Les champs multimédias natifs sont transmis ; non couverts par la vérification de génération terminée	Non pris en charge
Vidéo de référence, montage, extension	Bloqué avant soumission	Non pris en charge
Durée automatique -1	Bloqué	Bloqué
Rapport d’aspect 21:9	Accepté	Rejeté
Commutateur audio explicite	generate_audio / audio	Non pris en charge ; omettez ces champs
Désactiver la réécriture du prompt / graine fixe 0	La sérialisation actuelle ne conserve pas prompt_extend: false ni seed: 0 ; ne vous y fiez pas	false et 0 explicites sont conservés

Une vidéo silencieuse 720P de 5 secondes via la route native a été générée, téléchargée et décodée avec succès lors du contrôle d’acceptation du 2026-10-24. Les autres combinaisons multimédias sont décrites d’après l’adaptateur et le contrat officiel, plutôt que présentées comme des combinaisons testées en génération. La disponibilité des routes et les prix peuvent changer ; consultez la fiche du modèle.

Paramètres de requête communs complets

Envoyez ces champs au niveau supérieur. Pour une compatibilité maximale, utilisez duration, resolution et aspect_ratio explicites, un prompt non vide d’au plus 5,000 caractères, et omettez les options spécifiques à une route.

Champ	Type	Obligatoire / valeur par défaut	Comportement APIMaster
model	chaîne	Obligatoire	Exactement wan3.0-video-prime
prompt	chaîne	Obligatoire sur les deux routes	Non vide, y compris pour la génération d’images. GMI valide 1–5,000 caractères ; l’adaptateur natif exige un texte non vide. La limite officielle native est de 20,000 ; évitez de vous appuyer sur cette limite plus élevée entre les routes
duration	entier	5	2–30 secondes ; pas de -1, de fractions ni de durée automatique
seconds	chaîne	Facultatif	Alias de chaîne, par ex. "5" ; doit concorder avec duration lorsque les deux sont fournis
resolution	chaîne	720P	480P, 720P, 1080P ; les valeurs en minuscules au niveau supérieur sont normalisées. Cette valeur par défaut d’APIMaster diffère de la valeur par défaut native officielle
aspect_ratio	chaîne	16:9	Valeurs courantes : adaptive, 16:9, 9:16, 1:1, 4:3, 3:4. 21:9 uniquement sur la route native
ratio	chaîne	Facultatif	Alias de aspect_ratio ; utilisez un seul champ et n’envoyez pas de valeurs contradictoires
size	chaîne	Facultatif	Alias de dimensions tel que 1280x720 ; une validation spécifique à la route s’applique. Préférez resolution et aspect_ratio. GMI exige que le côté le plus court corresponde au palier de résolution ; le natif n’accepte que ses correspondances de dimensions prises en charge
input_reference	chaîne	Facultatif	URL d’image de première image. Utilisez une URL HTTP(S) téléchargeable publiquement pour la compatibilité entre routes ; ne combinez pas avec d’autres entrées de première image
prompt_extend	booléen	Natif true ; GMI laisse la valeur par défaut du fournisseur lorsqu’il est omis	Réécriture du prompt. Le natif ne peut actuellement pas la désactiver de manière fiable avec false ; GMI transmet un booléen explicite
watermark	booléen	Valeur par défaut native officielle false ; GMI laisse la valeur par défaut du fournisseur lorsqu’il est omis	Commutateur de filigrane
seed	entier	Aléatoire lorsqu’il est omis	Plage fixe portable : 1–2147483647. Le natif accepte aussi -1 pour l’aléatoire ; le 0 natif est omis lors de la sérialisation. GMI accepte 0–2147483647 et rejette -1. Une graine fixe ne garantit pas une sortie identique

Les alias de dimensions natifs sont 832x480, 480x832, 1280x720, 720x1280, 1920x1080 et 1080x1920 pour les cas habituels paysage/portrait. Certaines correspondances de dimensions carrées se réduisent à 1:1 ; d’autres dimensions mappées peuvent encore échouer à la validation du rapport d’aspect. N’utilisez pas size pour demander des dimensions arbitraires.

Tableaux de paramètres spécifiques aux routes

Champs GMI

Ce sont des champs de niveau supérieur en plus du tableau commun. L’adaptateur GMI rejette les champs non reconnus, notamment metadata, images, image_urls, audio, generate_audio, video_urls et reference_video.

Champ	Type	Obligatoire / valeur par défaut	Comportement
negative_prompt	chaîne	Facultatif	Au plus 500 caractères
first_frame	chaîne	Facultatif	URL d’image HTTP(S) publique ; alternative à input_reference
last_frame	chaîne	Facultatif	URL d’image HTTP(S) publique de dernière image ; fournissez aussi une première image
reference_image	chaîne ou tableau de chaînes	Facultatif	1–10 URL d’images de référence HTTP(S) publiques ; utilisez un tableau pour plusieurs images
audio_url	chaîne	Facultatif	URL HTTP(S) publique d’audio de référence ; soumise à la validation des médias du fournisseur

Utilisez soit les contrôles d’images, soit les images de référence dans une même requête. Le champ natif metadata.input.media n’est pas traduit vers ces champs sur GMI.

Champs natifs Alibaba Cloud

Les entrées structurées natives appartiennent à metadata. Envoyer directement les objets officiels input ou parameters au niveau supérieur ne correspond pas au contrat APIMaster. Conservez toujours le prompt obligatoire au niveau supérieur.

Champ	Type	Obligatoire / valeur par défaut	Comportement
generate_audio	booléen	Valeur par défaut native officielle true	Indique si la sortie contient une piste audio ; false est conservé
audio	booléen	Facultatif	Alias de generate_audio ; ne fournissez qu’un seul des deux
images	tableau de chaînes	Facultatif	Converti en entrées multimédias reference_image ; il ne s’agit pas d’images de première/dernière image ordonnées. Ne combinez pas avec input_reference
metadata	objet	Facultatif	Encapsule les objets natifs input et parameters ; ne peut pas modifier model
metadata.input	objet	Facultatif	Conteneur d’entrée natif
metadata.input.prompt	chaîne	Facultatif	Remplacement du prompt natif ; préférez le prompt de niveau supérieur seul
metadata.input.media	tableau d’objets	Facultatif	Collection de médias native, avec type et url dans chaque élément
metadata.input.media[].type	chaîne	Obligatoire par élément	first_frame, last_frame, reference_image, reference_audio, file, link ; reference_video est actuellement rejeté
metadata.input.media[].url	chaîne	Obligatoire par élément	Emplacement du média ; les URL HTTP(S) publiques sont recommandées. Les URL temporaires OSS officielles nécessitent un contexte de téléversement amont valide distinct ; APIMaster ne fournit pas ce contexte de téléversement
metadata.parameters	objet	Facultatif	Conteneur de paramètres natif ; ne doit pas être null
metadata.parameters.resolution	chaîne	720P	480P, 720P, 1080P en majuscules
metadata.parameters.ratio	chaîne	16:9	Rapports d’aspect natifs, y compris adaptive et 21:9
metadata.parameters.duration	entier	5	2–30 ; pas de -1
metadata.parameters.audio	booléen	Valeur par défaut native officielle true	Commutateur audio de sortie
metadata.parameters.prompt_extend	booléen	true	Doit rester true pour file / link ; un false explicite présente la limitation de sérialisation ci-dessus
metadata.parameters.watermark	booléen	Valeur par défaut native officielle false	Commutateur de filigrane
metadata.parameters.seed	entier	Aléatoire	-1 ou 0–2147483647 ; 0 présente la limitation de sérialisation ci-dessus

Les options natives de niveau supérieur remplacent leurs paramètres de métadonnées correspondants. Le champ input_reference de niveau supérieur remplace le tableau de médias natif ; images ajoute des entrées d’images de référence lorsque input_reference est absent. Utilisez un seul style d’entrée et un seul style de paramètres pour éviter les remplacements accidentels. N’utilisez pas les champs hérités img_url, first_frame_url, last_frame_url ou audio_url dans le champ natif input ; l’adaptateur rejette ces champs multimédias hérités pour Wan 3.0.

Contraintes multimédias

Les règles multimédias natives officielles ci-dessous expliquent aussi la validation côté fournisseur ; le fait qu’un adaptateur accepte une URL ne prouve pas que le média est valide.

Média	Limites / notes d’intégration
Premières / dernières images	Au plus une de chaque ; une dernière image nécessite une première image. Ne mélangez pas les contrôles d’images avec reference_image
Images de référence	Au plus 10 ; JPEG/JPG, PNG sans transparence, BMP ou WEBP ; chaque côté 240–8,000 px, rapport d’aspect maximal de 8:1, au plus 20 MB par image
Audio de référence	Natif : au plus 5, WAV/MP3, chacun de 1 à 15 secondes, combinés au plus 15 secondes, au plus 15 MB par fichier. GMI expose un seul audio_url
Fichier / page web	Natif uniquement : au plus un fichier ou une page lisible publiquement ; ne combinez pas file et link. Formats de fichier officiels : DOCX, DOC, XLSX, XLS, PPTX, PPT, PDF, TXT, KEY, PAGES, NUMBERS, MD ; au plus 100 MB, avec une limite de 50 pages pour les formats paginés applicables. Conservez prompt_extend: true
Vidéo de référence	Disponible officiellement, mais actuellement bloquée par la validation de facturation native d’APIMaster ; non exposée sur GMI. N’utilisez pas ici les exemples de montage ou d’extension vidéo de l’API officielle

Le plafond officiel natif de médias combinés est de 20 éléments ; les limites individuelles et de combinaison s’appliquent toujours. Les URL de données Base64 d’images font partie du format d’entrée natif officiel, mais ne sont pas acceptées par la validation d’URL de GMI. Préférez les URL HTTP(S) téléchargeables entre les routes.

Exemples

Génération texte-vidéo, champs communs

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video-prime","prompt":"A paper boat drifting across a quiet pond at sunrise, gentle camera movement.","duration":5,"resolution":"720P","aspect_ratio":"16:9"}'

Première image, champs communs

{"model":"wan3.0-video-prime","prompt":"The boat moves slowly forward, with soft ripples.","input_reference":"https://example.com/boat.png","duration":5,"resolution":"720P","aspect_ratio":"16:9"}

Premières / dernières images GMI

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","first_frame":"https://example.com/start.png","last_frame":"https://example.com/end.png","duration":5,"resolution":"720P","prompt_extend":false,"seed":0}

Premières / dernières images natives et sortie silencieuse

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","duration":5,"resolution":"720P","generate_audio":false,"metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}

Image et audio de référence natifs

{"model":"wan3.0-video-prime","prompt":"Animate the character in image 1, with the mood of audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}

Remplacez les URL de médias d’exemple par de vrais fichiers publics. Les exemples spécifiques à une route nécessitent la route correspondante et restent soumis aux contrôles de combinaison en amont.

Réponse, interrogation et téléchargement

La création renvoie un ID de tâche APIMaster, par exemple :

{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video-prime","status":"queued"}

Champ	Signification
id / task_id	Identifiant de tâche APIMaster, et non un identifiant de tâche amont
status	queued, in_progress, completed, failed
progress	Progression signalée ; pas une garantie d’achèvement
error.code / error.message	Détails de l’échec le cas échéant
metadata.url	Adresse de contenu authentifiée lorsqu’elle est renvoyée à l’achèvement

Interrogez toutes les 10 à 20 secondes avec la même clé API jusqu’à un statut terminal ; le succès de la création signifie seulement l’acceptation. La génération peut prendre plusieurs minutes. Interrogez une tâche acceptée au lieu de créer répétitivement des tâches payantes.

curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o wan-prime.mp4

Téléchargez et enregistrez rapidement la vidéo terminée ; les URL de résultat amont peuvent expirer. Une interrogation répétée ne crée pas de frais de génération supplémentaires.

Facturation et erreurs courantes

La facturation est à la seconde, selon la résolution demandée, avec les tarifs de route/compte indiqués sur la fiche du modèle. La soumission réserve le montant estimé. L’achèvement natif utilise la durée facturable renvoyée et le prix figé lors de la soumission ; GMI suit le contrat de durée réservée. Les tâches échouées libèrent/remboursent leur réservation de génération. La désactivation de l’audio n’implique pas un palier moins cher. Utilisez le journal d’utilisation pour le montant final.

Erreur / symptôme	Action
duration must be an integer from 2 to 30	Utilisez un entier explicite ; -1 n’est pas intégré
unsupported Wan request field ...	Supprimez un champ non pris en charge par GMI ou confirmez l’accès à la route native correspondante
unsupported aspect ratio	Utilisez un rapport courant ; 21:9 nécessite le routage natif
reference video requires an input-duration quote	Supprimez la vidéo de référence ; cette capacité est actuellement bloquée
prompt is required / media fetch failure	Ajoutez du texte au niveau supérieur ; utilisez des médias valides et téléchargeables publiquement
prompt_extend: false ou seed: 0 n’a aucun effet sur le natif	Limitation de sérialisation actuelle ; utilisez une graine positive et ne dépendez pas de la désactivation de la réécriture

Sources : informations officielles sur le modèle, référence officielle de l’API native, et guide d’utilisation officiel. Une capacité officielle ne signifie pas que le même champ est exposé sur chaque route APIMaster.