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
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
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 :
  • 230 : durée de sortie fixée (défaut 5)
  • -1 : la durée est choisie par le modèle
Avec des vidéos de référence : durée totale en entrée + sortie ≤ 30 s. Avec duration: -1, la durée choisie par le modèle doit aussi respecter cette contrainte.
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 : pour 230, la duration demandée ; pour -1, les secondes réelles de sortie
  • 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.