Wan2.7 Édition de Vidéo

Autorisations

Authorization

string

header

requis

Toutes les API nécessitent une authentification Bearer Token

Obtenir votre clé API :

Rendez-vous sur la page de gestion des clés API pour obtenir votre clé API

Ajoutez à l'en-tête de la requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

model

enum<string>

requis

Nom du modèle, doit être wan2.7-video-edit

Options disponibles:

wan2.7-video-edit

Exemple:

"wan2.7-video-edit"

video_urls

string<uri>[]

requis

Liste d'URL de la vidéo source. Exactement 1 vidéo requise

Limites vidéo :

Formats : mp4, mov
Durée : 2 ~ 10 secondes
Résolution : largeur et hauteur dans [240, 4096] pixels
Rapport d'aspect : 1:8 ~ 8:1
Taille du fichier : jusqu'à 100 Mo

Required array length: 1 element

Exemple:

["https://example.com/source.mp4"]

prompt

string

Invite textuelle décrivant l'effet d'édition souhaité. Prend en charge le chinois et l'anglais ; chaque caractère/lettre compte pour 1, le surplus est tronqué automatiquement. Longueur maximale 5000 caractères

Maximum string length: 5000

Exemple:

"Habille le personnage avec une tenue stylée et mets-lui le chapeau de l'image de référence"

negative_prompt

string

Prompt négatif décrivant ce qui ne doit pas apparaître dans la vidéo. Prend en charge le chinois et l'anglais. Longueur maximale 500 caractères ; surplus tronqué automatiquement

Maximum string length: 500

Exemple:

"Flou, basse qualité"

image_urls

string<uri>[]

Liste d'URL d'images de référence, jusqu'à 4 images. Utilisée pour le schéma « instruction + image de référence », par ex. remplacer des vêtements ou accessoires par des éléments d'une image de référence

Limites d'image :

Formats : JPEG, JPG, PNG (transparence non prise en charge), BMP, WEBP
Résolution : largeur et hauteur dans [240, 8000] pixels
Rapport d'aspect : 1:8 ~ 8:1
Taille du fichier : jusqu'à 20 Mo

Maximum array length: 4

Exemple:

["https://example.com/ref.jpg"]

keep_original_sound

boolean

défaut:false

Gestion de l'audio de la vidéo éditée. Par défaut : false

false : Mode intelligent. Le modèle décide selon le contenu du prompt — si le prompt mentionne des éléments sonores, il peut régénérer l'audio ; sinon, il peut conserver l'audio original de la vidéo d'entrée
true : Forcer la conservation de l'audio original de la vidéo d'entrée ; ne pas régénérer

Exemple:

true

quality

enum<string>

défaut:720p

Qualité vidéo, par défaut 720p

Options :

720p : définition standard, prix standard (par défaut)
1080p : haute définition, prix plus élevé

Options disponibles:

720p,

1080p

Exemple:

"720p"

aspect_ratio

enum<string>

Rapport d'aspect vidéo (optionnel)

Comportement :

Non fourni : la vidéo est générée avec un rapport d'aspect proche de la vidéo d'entrée
Fourni : la vidéo est générée avec le aspect_ratio spécifié

Résolution de sortie par niveau de qualité :

Qualité	16:9	9:16	1:1	4:3	3:4
720p	1280×720	720×1280	960×960	1104×832	832×1104
1080p	1920×1080	1080×1920	1440×1440	1648×1248	1248×1648

Options disponibles:

16:9,

9:16,

1:1,

4:3,

3:4

Exemple:

"16:9"

duration

number

défaut:0

Durée vidéo en secondes

Règles :

Par défaut 0 : conserve la durée de la vidéo d'entrée, pas de troncature (ne configurez ce champ que si vous souhaitez tronquer la vidéo d'entrée)
Lorsqu'elle est spécifiée explicitement, plage 2 ~ 10 : le système tronque la vidéo d'entrée de 0s jusqu'à la duration spécifiée

Plage requise: 0 <= x <= 10

Exemple:

0

seed

integer

Graine aléatoire, aléatoire par défaut

Notes :

Plage : 1 ~ 2147483647
Fixer la graine réduit la variation lors de l'itération sur les prompts et améliore la reproductibilité

Plage requise: 1 <= x <= 2147483647

Exemple:

42

prompt_extend

boolean

défaut:false

Activer ou non la réécriture intelligente du prompt. Lorsqu'elle est activée, un grand modèle optimise le prompt, ce qui améliore nettement les résultats pour des prompts simples ou peu descriptifs.

Note : la valeur par défaut est false. Omettre le champ ou envoyer false ne déclenchera pas la réécriture ; envoyez explicitement true pour l'activer.

Exemple:

false

callback_url

string<uri>

URL de callback HTTPS pour la fin de tâche

Moment du callback :

Déclenché à la fin, l'échec ou l'annulation de la tâche
Envoyé après confirmation de facturation

Restrictions de sécurité :

Seul HTTPS est pris en charge
Les callbacks vers des adresses IP internes sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de callback :

Délai d'attente : 10 secondes
Jusqu'à 3 tentatives après échec (à 1/2/4 secondes)
Le format de réponse du callback est identique à celui de l'API de requête de tâche
Les codes 2xx sont considérés comme réussis ; les autres codes déclenchent des nouvelles tentatives

Exemple:

"https://your-domain.com/webhooks/video-task-completed"

Réponse

Tâche vidéo créée avec succès

created

integer

Horodatage de création de la tâche

Exemple:

1757169743

string

ID de la tâche

Exemple:

"task-unified-1757169743-7cvnl5zw"

model

string

Nom du modèle réellement utilisé

Exemple:

"wan2.7-video-edit"

object

enum<string>

Type spécifique de tâche

Options disponibles:

video.generation.task

progress

integer

Pourcentage d'avancement de la tâche (0-100)

Plage requise: 0 <= x <= 100

Exemple:

0

status

enum<string>

Statut de la tâche

Options disponibles:

pending,

processing,

completed,

failed

Exemple:

"pending"

task_info

object

Informations détaillées sur la tâche vidéo

Show child attributes

type

enum<string>

Type de sortie de la tâche

Options disponibles:

text,

image,

audio,

video

Exemple:

"video"

usage

object

Informations d'utilisation et de facturation

Show child attributes