APIMaster.ai

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