Skip to main content
POST

Autorisation

string
requis
Tous les endpoints API requièrent une authentification par Bearer TokenObtenez votre API Key :Visitez la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la à l’en-tête de la requête :

Paramètres de la requête

string
requis
Nom du modèle de génération vidéo, fixé à wan2.7-videoedit
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)
array<string>
requis
Tableau d’URLs de vidéos sources à éditer
Seule la 1re vidéo est utilisée
Contraintes vidéo :
  • Format : mp4, mov
  • Durée : 2–10s
  • Résolution : largeur et hauteur dans la plage [240, 4096] pixels
  • Rapport d’aspect : 1:8 – 8:1
  • Taille de fichier : jusqu’à 100 Mo
string
Instruction d’édition décrivant les changements souhaités, jusqu’à 5000 caractères
Si omise, le modèle effectue un transfert de style par défaut
Exemple : "Change the character's outfit to a red gown", "Replace the background with a snowy mountain scene"
string
Prompt négatif décrivant le contenu indésirable, jusqu’à 500 caractères
array<string>
Tableau d’URLs d’images de référence, jusqu’à 4 imagesUtilisé pour spécifier le style ou l’apparence cible (par exemple, style de référence pour le transfert de style)
string
défaut:"1080P"
Résolution de la vidéo de sortieOptions :
  • 720P — standard
  • 1080P — haute définition (par défaut)
integer
défaut:"0"
Durée de la vidéo de sortie (secondes)
  • 0 (par défaut) : conserver la durée complète de la vidéo d’origine
  • Entier entre 2-10 : prendre la durée spécifiée à partir du début
Lorsque duration=0, la facturation est basée sur la durée réelle de la vidéo de sortieLa durée spécifiée ne peut pas dépasser la durée de la vidéo d’origine dans video_urls
string
Rapport d’aspect de sortieFormats pris en charge :
  • 16:9 — écran large paysage
  • 9:16 — portrait
  • 1:1 — carré
  • 4:3 — paysage
  • 3:4 — portrait
Si omis, le rapport d’aspect correspond à celui de la vidéo d’entrée
boolean
défaut:"true"
Activer la réécriture intelligente du promptAméliore significativement les résultats pour les prompts courts, mais augmente le temps de traitementPar défaut : true
boolean
défaut:"false"
Ajouter un filigrane « AI Generated » à la vidéo générée
  • true : ajouter un filigrane
  • false : sans filigrane (par défaut)
integer
Entier servant de graine pour contrôler le caractère aléatoire du contenu généréPlage de valeurs : entier ≥ 0
  • Pour des requêtes identiques, le modèle génère des résultats différents lorsqu’il reçoit des valeurs de graine différentes (par exemple, omettre la graine)
  • Pour des requêtes identiques, le modèle génère des résultats similaires lorsqu’il reçoit la même valeur de graine, mais une cohérence exacte n’est pas garantie
object
Objet de paramètres supplémentaires

Réponse

integer
Code de statut de la réponse, 200 en cas de succès
array
Tableau de données de la réponse

Cas d’utilisation

Cas 1 : Édition vidéo de base (le plus simple)

Cas 2 : Transfert de style (avec image de référence)

Cas 3 : Conserver l’audio original de la vidéo

Adapté aux vidéos avec son de fond ou dialogues importants :

Cas 4 : Paramètres complets

Traitement audio

Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un task_id lors de la soumission. Utilisez l’endpoint Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.