API vidéo Wan 3.0
Paramètres, combinaisons de médias, tâches asynchrones, téléchargements et facturation à la seconde pour wan3.0-video sur APIMaster.
API vidéo Wan 3.0
wan3.0-video est le modèle Wan 3 standard ; il s'agit d'un modèle distinct de wan3.0-video-prime. Il prend en charge le texte, les images, la vidéo, l'audio, les documents et les pages web publiques. Chaque tâche réussie produit une vidéo MP4/H.264, d'une durée maximale de 30 secondes. Intégration vérifiée : 2026-11-17.
Chaque requête accepte au maximum 20 éléments multimédias au total. La vidéo générée utilise 30 fps.
Points de terminaison et authentification
| Opération | Point de terminaison |
|---|---|
| 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 |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
Tous les paramètres de requête
Utilisez un seul format de médias par requête. Utilisez metadata.input.media pour combiner des médias de référence ou joindre des documents.
| Paramètre | Type | Obligatoire / valeur par défaut | Signification et valeurs valides |
|---|---|---|---|
model |
string | Obligatoire | Exactement wan3.0-video ; ne pas remplacer par Prime |
prompt |
string | Obligatoire | Décrivez le résultat en chinois ou en anglais ; limite officielle de 20 000 caractères, le texte natif plus long est tronqué. Référez-vous à Image 1, Video 1, Audio 1 dans l'ordre des médias ; chaque type de média possède sa propre numérotation |
duration |
integer | 5 |
2–30 secondes de sortie ; -1 laisse le modèle choisir la durée. Avec une vidéo de référence, la durée d'entrée plus la durée de sortie ne peut pas dépasser 30 secondes |
seconds |
string | Facultatif | Alias de durée, par ex. "5" ou "-1" ; doit correspondre à duration lorsque les deux sont fournis |
resolution |
string | 1080P |
480P, 720P, 1080P ; les valeurs de niveau supérieur en minuscules sont normalisées |
aspect_ratio |
string | adaptive |
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
ratio |
string | Facultatif | Alias de aspect_ratio ; adaptive est recommandé pour l'extension vidéo |
size |
string | Facultatif | Alias de compatibilité : niveau de résolution, ou un mappage de pixels pris en charge tel que 1280x720 ; préférez une résolution et un ratio explicites, et non des tailles de pixels arbitraires |
generate_audio |
boolean | true côté amont |
Indique si la sortie comporte une piste audio. Un false explicite est conservé. L'audio ne modifie pas le tarif par seconde |
audio |
boolean | Facultatif | Alias de generate_audio ; utilisez un seul commutateur audio |
prompt_extend |
boolean | true |
Réécriture intelligente du prompt ; un false explicite est conservé. Doit être true pour une entrée document/page |
watermark |
boolean | false côté amont |
Ajouter un filigrane à la sortie ; un false explicite est conservé |
seed |
integer | Aléatoire | -1 ou 0–2147483647. L'omission ou -1 demande une graine aléatoire ; 0 est transmis. Des graines répétées ne garantissent pas une sortie identique |
input_reference |
string | Facultatif | URL de l'image de première image ; remplace le tableau média natif. Ne mélangez pas les styles d'entrée |
images |
string[] | Facultatif | Tableau de commodité ajouté sous forme d'éléments reference_image lorsque input_reference est absent |
metadata |
object | Facultatif | Conteneur pour les objets natifs ci-dessous ; ne peut pas changer le modèle sélectionné |
metadata.input |
object | Facultatif | Objet d'entrée natif |
metadata.input.prompt |
string | Facultatif | Remplacement natif du prompt ; conservez le prompt obligatoire au niveau supérieur |
metadata.input.media |
object[] | Facultatif | Tableau média ordonné. Chaque élément exige type et url ; voir les limites ci-dessous |
metadata.input.media[].type |
string | Obligatoire par élément | first_frame, last_frame, reference_image, reference_video, reference_audio, file, link |
metadata.input.media[].url |
string | Obligatoire par élément | URL média HTTP(S) publique ; les types d'image acceptent également une chaîne data:{MIME_type};base64,.... Les médias non image nécessitent une URL publique |
metadata.parameters |
object | Facultatif | Objet de paramètres natif ; ne peut pas être null |
metadata.parameters.resolution |
string | 1080P |
480P, 720P, 1080P en majuscules |
metadata.parameters.ratio |
string | adaptive |
Mêmes valeurs de ratio d'aspect que celles listées ci-dessus |
metadata.parameters.duration |
integer | 5 |
2–30, ou -1 ; même contrainte de durée combinée |
metadata.parameters.audio |
boolean | true côté amont |
Même commutateur audio de sortie |
metadata.parameters.prompt_extend |
boolean | true |
Même commutateur de réécriture du prompt ; file/link exige true |
metadata.parameters.watermark |
boolean | false côté amont |
Même commutateur de filigrane |
metadata.parameters.seed |
integer | Aléatoire | Même plage de graines, y compris 0 explicite |
Les champs natifs negative_prompt, img_url, first_frame_url, last_frame_url et audio_url ne sont pas des contrôles média de Wan 3. Utilisez plutôt le tableau média documenté.
Limites des médias et combinaisons valides
| Type de média | Nombre et contraintes |
|---|---|
first_frame, last_frame |
Au plus un de chaque. La dernière image requiert la première image. Les contrôles d'image ne peuvent être combinés avec aucun type de référence, de fichier ou de lien |
reference_image |
Au plus 10. JPEG/JPG, PNG sans transparence, BMP ou WEBP ; chaque côté 240–8,000 pixels, rapport d'aspect maximal 8:1, chaque fichier au plus 20 Mo |
reference_video |
Au plus 5 clips MP4/MOV ; chacun de 1 à 15 secondes, entrée combinée au plus 15 secondes ; au moins 16 fps ; chaque côté 240–4,096 pixels, rapport d'aspect maximal 8:1, chaque fichier au plus 100 Mo |
reference_audio |
Au plus 5 clips WAV/MP3 ; chacun de 1 à 15 secondes, combinés au plus 15 secondes ; chaque fichier au plus 15 Mo |
file |
Au plus un fichier DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD ; au plus 100 Mo. Les documents paginés PDF, DOCX, DOC, PPTX, PPT et KEY/PAGES sont limités à 50 pages |
link |
Au plus une page accessible publiquement sans connexion ; ne pas combiner avec file |
Les images, vidéos et audios de référence peuvent être combinés. Un fichier ou un lien peut accompagner des médias de référence. Le mode première/dernière image n'accepte que les contrôles d'image ; utilisez le mode image de référence plus audio de référence pour une génération pilotée par l'audio. L'analyse des médias et la modération du contenu restent soumises aux vérifications en amont.
La génération texte-vers-vidéo utilise un prompt sans média. L'animation à partir d'une première image utilise first_frame ; les transitions utilisent first_frame plus last_frame. La génération par référence utilise les types de référence. Pour l'édition ou l'extension, fournissez reference_video et décrivez l'édition ou l'extension dans le prompt ; utilisez adaptive pour l'extension.
Exemples
Texte vers vidéo
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
Première et dernière images
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","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
{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm 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"}]}}}
Montage / prolongation vidéo et durée intelligente
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
Document / page web
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
Remplacez toutes les URL d'exemple par de vrais médias publics. Pour une entrée web, remplacez l'élément de type fichier par {"type":"link","url":"https://example.com/product"}. L'exemple avec la première image fonctionne également sans son élément de dernière image.
Réponses, interrogation périodique, téléchargements et journaux
La création renvoie un ID de tâche APIMaster, et non l'ID en amont :
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| Champ de réponse | Signification |
|---|---|
id / task_id |
Identifiant de tâche de la plateforme utilisé pour l'interrogation et le téléchargement |
status |
queued, in_progress, completed, failed |
progress |
Indicateur de progression ; attendez le statut terminal |
error.code, error.message |
Informations sur l'échec, le cas échéant |
metadata.url |
Emplacement du contenu lorsqu'il est renvoyé à l'achèvement |
Interrogez environ toutes les 15 secondes en utilisant la même clé API. Ne créez pas une autre tâche pour vérifier la progression. Les ID de tâche et les URL de sortie du fournisseur natif expirent après 24 heures ; téléchargez et conservez rapidement les résultats réussis. Il est préférable d'utiliser le point de terminaison de contenu authentifié d'APIMaster plutôt que de stocker des URL en amont temporaires.
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 wan3.mp4
Le journal d'utilisation contient la tâche et le résultat vidéo réussi. Vérifiez les frais finaux après l'achèvement ; l'acceptation ne prouve pas la réussite de la génération. Une interrogation répétée ne génère pas de frais de génération supplémentaires.
Facturation
Consultez les tarifs à la seconde sur la fiche du modèle.
APIMaster additionne la durée de toutes les vidéos d’entrée et celle de la vidéo de sortie, arrondit le total une seule fois à la seconde supérieure et le multiplie par le tarif à la seconde de la résolution de sortie choisie. Une entrée de 2,3 s et une sortie de 5 s sont facturées comme 8 s. Sans vidéo d’entrée, seule la sortie est facturée. La requête ne nécessite ni devis ni durée d’entrée. En cas d’échec, le montant réservé est libéré. Le montant final figure dans le journal d’utilisation.
Erreurs et corrections
| Symptôme | Correction |
|---|---|
| Durée/résolution/ratio non valides | Utilisez l'énumération et les plages ci-dessus ; la durée intelligente est exactement -1 |
| Conflit image/référence, dernière image sans première | Suivez les règles de combinaison |
| Fichier/lien avec réécriture désactivée | Définissez prompt_extend:true |
| Échec de récupération/format/durée du média | Utilisez des fichiers publics qui respectent toutes les contraintes de taille, de format et de durée |
| Prompt manquant | Conservez un prompt de niveau supérieur non vide pour l'API APIMaster |
| Tâche échouée ou modérée | Inspectez error, puis corrigez la requête ; ne considérez pas l'acceptation comme un succès |
