> ## 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 Image vers Vidéo > - Le modèle WAN2.7 (wan2.7-image-to-video) prend en charge la génération image-vers-vidéo avec des entrées multimodales (image / audio / vidéo) - Choisissez l'un des trois modes de génération via `generation_mode` : - `first_frame` : **Premier plan vers vidéo** — génère une vidéo à partir de l'image de premier plan, avec audio pilote optionnel - `first_last_frame` : **Premier et dernier plan vers vidéo** — génère une vidéo en interpolant entre la première et la dernière image, avec audio pilote optionnel - `video_continuation` : **Continuation vidéo** — continue un clip vidéo d'entrée ; un dernier plan optionnel est autorisé (pas d'audio pilote) - `generation_mode` est optionnel (rétrocompatibilité) ; en cas d'omission, le mode approprié est sélectionné automatiquement selon les éléments fournis - Combinaisons d'éléments valides (toute autre combinaison sera rejetée) : 1. `image_start` (premier plan) 2. `image_start` + `audio_urls` (premier plan + audio pilote) 3. `image_start` + `image_end` (premier + dernier plan) 4. `image_start` + `image_end` + `audio_urls` (premier + dernier plan + audio pilote) 5. `video_urls` (continuation vidéo) 6. `video_urls` + `image_end` (continuation vidéo + dernier plan) - 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 ## OpenAPI ````yaml fr/api-manual/video-series/wan2.7/wan2.7-image-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: wan2.7-image-to-video API description: >- Générez des vidéos à partir d'images avec le modèle WAN2.7. Prend en charge les images de premier/dernier plan, les clips de continuation vidéo et la génération pilotée par audio 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-image-to-video API description: >- - Le modèle WAN2.7 (wan2.7-image-to-video) prend en charge la génération image-vers-vidéo avec des entrées multimodales (image / audio / vidéo) - Choisissez l'un des trois modes de génération via `generation_mode` : - `first_frame` : **Premier plan vers vidéo** — génère une vidéo à partir de l'image de premier plan, avec audio pilote optionnel - `first_last_frame` : **Premier et dernier plan vers vidéo** — génère une vidéo en interpolant entre la première et la dernière image, avec audio pilote optionnel - `video_continuation` : **Continuation vidéo** — continue un clip vidéo d'entrée ; un dernier plan optionnel est autorisé (pas d'audio pilote) - `generation_mode` est optionnel (rétrocompatibilité) ; en cas d'omission, le mode approprié est sélectionné automatiquement selon les éléments fournis - Combinaisons d'éléments valides (toute autre combinaison sera rejetée) : 1. `image_start` (premier plan) 2. `image_start` + `audio_urls` (premier plan + audio pilote) 3. `image_start` + `image_end` (premier + dernier plan) 4. `image_start` + `image_end` + `audio_urls` (premier + dernier plan + audio pilote) 5. `video_urls` (continuation vidéo) 6. `video_urls` + `image_end` (continuation vidéo + dernier plan) - 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 operationId: createWan27ImageToVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Wan27ImageToVideoRequest' examples: first_frame: summary: Premier plan vers vidéo value: model: wan2.7-image-to-video generation_mode: first_frame prompt: Un chat qui joue du piano image_start: https://example.com/first_frame.jpg first_frame_with_audio: summary: Premier plan + audio pilote value: model: wan2.7-image-to-video generation_mode: first_frame prompt: Un jeune homme interprète un rap en anglais image_start: https://example.com/first_frame.jpg audio_urls: - https://example.com/rap.mp3 first_last_frame: summary: Premier et dernier plan vers vidéo value: model: wan2.7-image-to-video generation_mode: first_last_frame prompt: >- La caméra s'élève progressivement du niveau des yeux jusqu'à une vue plongeante image_start: https://example.com/first_frame.png image_end: https://example.com/last_frame.png video_continuation: summary: Continuation vidéo value: model: wan2.7-image-to-video generation_mode: video_continuation prompt: >- Une fille fait un selfie devant le miroir, puis quitte la maison avec son sac à dos video_urls: - https://example.com/clip.mp4 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-image-to-video' 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: Wan27ImageToVideoRequest: required: - model type: object properties: model: type: string description: Nom du modèle, doit être `wan2.7-image-to-video` enum: - wan2.7-image-to-video example: wan2.7-image-to-video generation_mode: type: string description: >- Mode de génération qui détermine quelles combinaisons d'éléments sont valides. **La spécification explicite est recommandée** **Valeurs :** - `first_frame` : Premier plan vers vidéo. Requis : `image_start`. Optionnel : `audio_urls`. Non accepté : `image_end`, `video_urls` - `first_last_frame` : Premier et dernier plan vers vidéo. Requis : `image_start` + `image_end`. Optionnel : `audio_urls`. Non accepté : `video_urls` - `video_continuation` : Continuation vidéo. Requis : `video_urls[0]`. Optionnel : `image_end` (comme dernier plan). Non accepté : `image_start`, `audio_urls` **Comportement de rétrocompatibilité :** lorsque `generation_mode` est omis, le mode approprié est sélectionné automatiquement selon les éléments fournis ; la spécification explicite évite l'ambiguïté enum: - first_frame - first_last_frame - video_continuation example: first_frame prompt: type: string description: >- Invite textuelle pour la génération vidéo. 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: Un chat qui joue du piano 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é image_start: type: string format: uri description: >- URL de l'image de premier plan **Contraintes par mode :** - Mode `first_frame` : **requis** - Mode `first_last_frame` : **requis** - Mode `video_continuation` : **non autorisé** **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` example: https://example.com/first_frame.jpg image_end: type: string format: uri description: >- URL de l'image de dernier plan **Contraintes par mode :** - Mode `first_last_frame` : **requis** - Mode `video_continuation` : optionnel (sert de dernier plan pour la continuation) - Mode `first_frame` : **non autorisé** (utilisez `first_last_frame` si vous avez besoin d'un premier et d'un dernier plan) **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` example: https://example.com/last_frame.jpg video_urls: type: array items: type: string format: uri description: >- Liste d'URL pour la continuation vidéo. **Un seul élément est pris en charge** **Contraintes par mode :** - Mode `video_continuation` : **requis** - Mode `first_frame` / `first_last_frame` : **non autorisé** - Ne peut pas être combiné avec `audio_urls` **Limites vidéo :** - Formats : mp4, mov - Durée : `2 ~ 10` secondes (longueur du clip d'entrée) - Résolution : largeur et hauteur dans `[240, 4096]` pixels - Rapport d'aspect : 1:8 ~ 8:1 - Taille du fichier : jusqu'à `100 Mo` **Règles de durée pour la continuation :** - `duration` représente la **durée totale de la vidéo finale** (clip d'entrée + continuation générée par le modèle) - Durée générée par le modèle = `duration` − durée de la vidéo d'entrée - `duration` doit être ≥ durée de la vidéo d'entrée - La facturation se base sur la durée totale de la vidéo finale (c'est-à-dire `duration`) **Exemples :** | Durée du clip d'entrée | duration | Continuation générée | Sortie finale | Facturé | | --- | --- | --- | --- | --- | | 3s | 15 | 12s | 15s | 15s | | 5s | 10 | 5s | 10s | 10s | | 8s | 8 | 0s (entrée seule) | 8s | 8s | example: - https://example.com/clip.mp4 audio_urls: type: array items: type: string format: uri minItems: 1 maxItems: 1 description: >- Liste d'URL audio pilote. **Actuellement, un seul élément est pris en charge**. Le modèle utilise cet audio comme source pilote pour la génération (par ex. synchronisation labiale, alignement de mouvement) **Contraintes par mode :** - Mode `first_frame` : optionnel - Mode `first_last_frame` : optionnel - Mode `video_continuation` : **non autorisé** (ne peut pas être combiné avec `video_urls`) **Exigences de format :** - Formats pris en charge : `wav`, `mp3` - Durée : `2 ~ 30` secondes - Taille du fichier : jusqu'à `15 Mo` **Gestion du dépassement :** - Si la durée audio dépasse `duration`, les premières N secondes sont utilisées et le reste est ignoré - Si la durée audio est plus courte que la durée vidéo, la portion restante est silencieuse. Par exemple : avec un audio de 3s et une vidéo de 5s, les 3 premières secondes ont du son et les 2 dernières sont muettes example: - https://example.com/audio.mp3 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 duration: type: number description: >- Durée vidéo en secondes (entier). Plage `2 ~ 15`, par défaut `5` **Signification :** - Modes `first_frame` / `first_last_frame` : longueur totale de la vidéo générée - Mode `video_continuation` : longueur totale de la vidéo finale (= clip d'entrée + continuation générée par le modèle) **Contraintes supplémentaires en mode `video_continuation` :** - `duration` doit être **≥ durée de la vidéo d'entrée** (sinon une erreur est renvoyée) - Durée générée par le modèle = `duration` − durée de la vidéo d'entrée - Quand `duration` est égal à la durée de la vidéo d'entrée, aucune continuation n'est générée et le clip d'entrée est renvoyé tel quel - Voir les règles et exemples de continuation dans le champ `video_urls` **Facturation :** basée sur la durée réelle de la vidéo générée minimum: 2 maximum: 15 default: 5 example: 5 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-image-to-video 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 ``` ````