Skip to main content
POST

Authentification

string
requis
Tous les endpoints exigent une authentification Bearer TokenObtenez votre API Key depuis la page de gestion des API Keys :

Modes de génération

Le nom du modèle est fixé à wan3.0-video. Les modes sont sélectionnés via les champs de la requête :

Paramètres de la requête

Bases

string
requis
Valeur fixe : wan3.0-video
string
Description textuelle. Obligatoire sauf si des champs média sont fournis (au moins un parmi prompt ou média).
  • Max 20 000 caractères ; le dépassement est tronqué automatiquement (sans erreur)
  • En mode référence, utilisez « 图N / 视频N / 音频N » pour désigner les assets ; les indices suivent l’ordre au sein de chaque type de média
string
défaut:"1080P"
Résolution de sortie (insensible à la casse)
  • 480P
  • 720P
  • 1080P (par défaut, prix le plus élevé)
Omettre resolution facture au tarif 1080P. Passez explicitement 480P ou 720P lorsque le coût compte.
string
défaut:"adaptive"
Rapport d’aspect. aspect_ratio est également accepté.
  • adaptive (par défaut)
  • 16:9 / 4:3 / 1:1 / 3:4 / 9:16
integer
défaut:"5"
Durée en secondes, 2–30, par défaut 5
duration: -1 (durée intelligente) n’est pas pris en charge. Passez un entier de 2 à 30.
Avec une entrée vidéo de référence, la durée totale des vidéos d’entrée + la duration de sortie doit être ≤ 30 secondes.
boolean
défaut:"true"
Indique si la sortie inclut une piste audio. Par défaut true. Le prix est le même avec ou sans audio.
integer
Graine aléatoire dans [0, 2147483647]
boolean
défaut:"false"
Indique s’il faut ajouter un filigrane. Par défaut false
string
Comment les image_urls brutes sont classées :
  • frame — famille première/dernière image
  • reference — famille de référence
Si omis, la classification est automatique (voir les règles d’exclusion mutuelle).

Entrées média

string[]
Tableau d’URL d’images. L’attribution des rôles suit les règles d’exclusion mutuelle.URL publique ou Base64 (data:image/png;base64,...).
object[]
Images avec rôles explicites. Chaque élément :
  • url : adresse de l’image
  • role : first_frame / last_frame / reference_image (alias courants acceptés)
string[]
Vidéos de référence, jusqu’à 5 clips ; chacun 1–15 s, total ≤ 15 s
string[]
Audio de référence, jusqu’à 5 clips ; chacun 1–15 s, total ≤ 15 s
string
Audio de référence unique (forme monovaleur de audio_urls)
string
URL de document de référence, au plus 1. Ne peut pas être combiné avec link_url.Formats : docx / doc / xlsx / xls / pptx / ppt / pdf / txt / key / pages / numbers / md, ≤100 Mo, ≤50 pages.
URL de page web publique, au plus 1. Pages sans connexion uniquement. Ne peut pas être combiné avec file_url.

Exclusion mutuelle des familles de médias

Les médias appartiennent à l’une des deux familles et ne doivent pas être mélangés (validé avant soumission → 400, pas de tâche, pas de facturation) :

Comment les image_urls brutes sont assignées

  1. Si generation_type est défini → l’utiliser (frame / reference)
  2. Sinon, si la requête contient déjà des entrées de la famille de référence (video_urls / audio_urls / audio_url / file_url / link_url) → traiter comme reference_image
  3. Sinon → famille frame : premier élément first_frame, second last_frame (identique à wan2.7)
Utilisez image_with_roles lorsque vous avez besoin d’un contrôle explicite.

Limites et formats des médias

Exemples de requête

Texte-vers-vidéo

Vidéo à partir de la première image

Première + dernière image

Ou avec image_with_roles :

Référence multimodale

Avec video_urls présent, les image_urls brutes se classent automatiquement comme images de référence ; définir generation_type: "reference" est plus clair.

Vidéo de référence par fichier

prompt peut être omis ; la génération est pilotée par le document :

Vidéo de référence par page web

Facturation

Par seconde × résolution (aligné sur le tarif officiel). Audio activé/désactivé ne change pas le prix :
  • Par défaut 1080P (le plus cher) ; passez 480P / 720P lorsque le coût est sensible
  • Secondes facturables = duration demandée
  • audio: true/false n’affecte pas le prix

Limites et notes

Erreurs courantes

Toutes sont des 400 synchrones (pas de tâche, pas de facturation) :

Réponse

integer
Code de statut ; 200 en cas de succès
array
Tableau de données de réponse
Consulter les résultatsLa génération vidéo est asynchrone. Interrogez Obtenir le statut de la tâche ou GET /v1/videos/generations/{task_id}.Intervalle recommandé 5–10 secondes ; la génération prend généralement 1–5 minutes. En cas de succès, utilisez les URL dans result.videos.