> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Wan2.7 Édition de Vidéo > - Le modèle WAN2.7 (wan2.7-video-edit) prend en charge l'édition vidéo pour les tâches **d'édition par instruction** et **de transfert vidéo** - **Requis :** charger exactement 1 vidéo (`video_urls`) ; jusqu'à 4 images de référence en option (`image_urls`) - Deux schémas d'utilisation : - **Édition par instruction uniquement :** envoyez `video_urls` + `prompt` (par ex. changement de style, changement de tenue) - **Instruction + image de référence :** envoyez `video_urls` + `image_urls` + `prompt` (par ex. remplacement local par des éléments d'une image de référence) - Gestion audio : contrôlée via `keep_original_sound` (`true` conserve l'audio original ; `false` laisse le modèle gérer l'audio intelligemment) - Mode de traitement asynchrone, utilisez l'ID de tâche renvoyé pour [interroger le statut](/fr/api-manual/task-management/get-task-detail) - Les liens vidéo générés sont valides 24 heures, veuillez les sauvegarder rapidement - **Facturation :** facturée selon « durée de la vidéo d'entrée + durée de la vidéo de sortie » ; seules les générations réussies sont facturées, les tâches en échec sont gratuites ## OpenAPI ````yaml fr/api-manual/video-series/wan2.7/wan2.7-video-edit.json POST /v1/videos/generations openapi: 3.1.0 info: title: wan2.7-video-edit API description: >- Éditez des vidéos avec le modèle WAN2.7, prend en charge le chargement vidéo et l'édition avec des images de référence license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Environnement de production security: - bearerAuth: [] paths: /v1/videos/generations: post: tags: - Génération de vidéos summary: wan2.7-video-edit API description: >- - Le modèle WAN2.7 (wan2.7-video-edit) prend en charge l'édition vidéo pour les tâches **d'édition par instruction** et **de transfert vidéo** - **Requis :** charger exactement 1 vidéo (`video_urls`) ; jusqu'à 4 images de référence en option (`image_urls`) - Deux schémas d'utilisation : - **Édition par instruction uniquement :** envoyez `video_urls` + `prompt` (par ex. changement de style, changement de tenue) - **Instruction + image de référence :** envoyez `video_urls` + `image_urls` + `prompt` (par ex. remplacement local par des éléments d'une image de référence) - Gestion audio : contrôlée via `keep_original_sound` (`true` conserve l'audio original ; `false` laisse le modèle gérer l'audio intelligemment) - Mode de traitement asynchrone, utilisez l'ID de tâche renvoyé pour [interroger le statut](/fr/api-manual/task-management/get-task-detail) - Les liens vidéo générés sont valides 24 heures, veuillez les sauvegarder rapidement - **Facturation :** facturée selon « durée de la vidéo d'entrée + durée de la vidéo de sortie » ; seules les générations réussies sont facturées, les tâches en échec sont gratuites operationId: createWan27VideoEditGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Wan27VideoEditRequest' examples: instruction_edit: summary: Édition par instruction uniquement (changement de style) value: model: wan2.7-video-edit prompt: Convertis toute la scène en style pâte à modeler video_urls: - https://example.com/source.mp4 instruction_with_reference: summary: Instruction + image de référence (remplacement local) value: model: wan2.7-video-edit prompt: >- Remplace les vêtements de la fille dans la vidéo par les vêtements de l'image de référence video_urls: - https://example.com/source.mp4 image_urls: - https://example.com/clothes.png responses: '200': description: Tâche vidéo créée avec succès content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Paramètres de requête invalides content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Non authentifié, jeton invalide ou expiré content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Quota insuffisant, recharge requise content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Accès refusé content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: wan2.7-video-edit' type: invalid_request_error '429': description: Limite de débit dépassée content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Erreur interne du serveur content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: Wan27VideoEditRequest: required: - model - video_urls type: object properties: model: type: string description: Nom du modèle, doit être `wan2.7-video-edit` enum: - wan2.7-video-edit example: wan2.7-video-edit prompt: type: string description: >- 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 maxLength: 5000 example: >- Habille le personnage avec une tenue stylée et mets-lui le chapeau de l'image de référence negative_prompt: type: string description: >- 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 maxLength: 500 example: Flou, basse qualité video_urls: type: array items: type: string format: uri description: |- 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` minItems: 1 maxItems: 1 example: - https://example.com/source.mp4 image_urls: type: array items: type: string format: uri description: >- 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` maxItems: 4 example: - https://example.com/ref.jpg keep_original_sound: type: boolean description: >- 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 default: false example: true quality: type: string description: |- Qualité vidéo, par défaut `720p` **Options :** - `720p` : définition standard, prix standard (par défaut) - `1080p` : haute définition, prix plus élevé enum: - 720p - 1080p default: 720p example: 720p aspect_ratio: type: string description: >- 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 | enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' example: '16:9' duration: type: number description: >- 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 minimum: 0 maximum: 10 default: 0 example: 0 seed: type: integer description: >- 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é minimum: 1 maximum: 2147483647 example: 42 prompt_extend: type: boolean description: >- 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. default: false example: false callback_url: type: string description: >- 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 format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Horodatage de création de la tâche example: 1757169743 id: type: string description: ID de la tâche example: task-unified-1757169743-7cvnl5zw model: type: string description: Nom du modèle réellement utilisé example: wan2.7-video-edit object: type: string enum: - video.generation.task description: Type spécifique de tâche progress: type: integer description: Pourcentage d'avancement de la tâche (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Statut de la tâche enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Informations détaillées sur la tâche vidéo type: type: string enum: - text - image - audio - video description: Type de sortie de la tâche example: video usage: $ref: '#/components/schemas/Usage' description: Informations d'utilisation et de facturation ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identifiant du code d'erreur message: type: string description: Description de l'erreur type: type: string description: Type d'erreur VideoTaskInfo: type: object properties: can_cancel: type: boolean description: Si la tâche peut être annulée example: true estimated_time: type: integer description: Temps estimé jusqu'à la fin (secondes) minimum: 0 example: 120 Usage: type: object description: Informations d'utilisation et de facturation properties: billing_rule: type: string description: Règle de facturation enum: - per_call - per_token - per_second example: per_call credits_reserved: type: number description: Crédits estimés à consommer minimum: 0 example: 5 user_group: type: string description: Catégorie de groupe d'utilisateurs enum: - default - vip example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## Toutes les API nécessitent une authentification Bearer Token ## **Obtenir votre clé API :** Rendez-vous sur la [page de gestion des clés API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API **Ajoutez à l'en-tête de la requête :** ``` Authorization: Bearer YOUR_API_KEY ``` ````