> ## 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 Vidéo de Référence > - Le modèle WAN2.7 (wan2.7-reference-video) prend en charge la génération de référence-vers-vidéo, en utilisant des personnes ou des objets comme protagonistes pour produire des performances de personnage unique ou des interactions multi-personnages - Entrées multimodales : image de premier plan (`image_start`), plusieurs images de référence (`image_urls`), plusieurs vidéos de référence (`video_urls`) et liaisons vocales par personnage - **Au moins** une image de référence (`image_urls`) ou une vidéo de référence (`video_urls`) doit être fournie ; envoyer uniquement `image_start` ne suffit pas. Le total `image_urls` + `video_urls` doit être ≤ 5 - **Indexation des personnages dans le prompt :** en chinois, utilisez « 图1, 图2 / 视频1, 视频2 » ; en anglais, utilisez « Image 1 », « Video 1 » — ils correspondent 1-based à l'ordre de `image_urls` / `video_urls`. Les images et les vidéos sont comptées séparément, donc « Image 1 » et « Video 1 » peuvent coexister - **Liaison vocale multi-personnages :** privilégiez `model_params.voice_bindings` (liaison précise) ; le champ historique `audio_urls` (alignement positionnel) est également pris en charge - 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-reference-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: wan2.7-reference-video API description: >- Générez des vidéos avec le modèle WAN2.7 à partir d'images de référence, de vidéos de référence et d'entrées 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-reference-video API description: >- - Le modèle WAN2.7 (wan2.7-reference-video) prend en charge la génération de référence-vers-vidéo, en utilisant des personnes ou des objets comme protagonistes pour produire des performances de personnage unique ou des interactions multi-personnages - Entrées multimodales : image de premier plan (`image_start`), plusieurs images de référence (`image_urls`), plusieurs vidéos de référence (`video_urls`) et liaisons vocales par personnage - **Au moins** une image de référence (`image_urls`) ou une vidéo de référence (`video_urls`) doit être fournie ; envoyer uniquement `image_start` ne suffit pas. Le total `image_urls` + `video_urls` doit être ≤ 5 - **Indexation des personnages dans le prompt :** en chinois, utilisez « 图1, 图2 / 视频1, 视频2 » ; en anglais, utilisez « Image 1 », « Video 1 » — ils correspondent 1-based à l'ordre de `image_urls` / `video_urls`. Les images et les vidéos sont comptées séparément, donc « Image 1 » et « Video 1 » peuvent coexister - **Liaison vocale multi-personnages :** privilégiez `model_params.voice_bindings` (liaison précise) ; le champ historique `audio_urls` (alignement positionnel) est également pris en charge - 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: createWan27ReferenceVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Wan27ReferenceVideoRequest' examples: single_reference_video: summary: Vidéo de référence unique value: model: wan2.7-reference-video prompt: Le personnage de la vidéo de référence danse sur une prairie video_urls: - https://example.com/reference.mp4 multi_subject_with_voice_bindings: summary: Référence multi-sujets + liaison vocale précise (recommandé) value: model: wan2.7-reference-video prompt: >- Image 1 tient Image 2 et joue un doux folk country sur la chaise d'Image 3 en disant : « Quel beau soleil aujourd'hui » image_urls: - https://example.com/girl.jpg - https://example.com/object.png - https://example.com/chair.png model_params: voice_bindings: image1: https://example.com/girl_voice.mp3 duration: 10 multi_grid_storyboard: summary: Image de référence unique (storyboard multi-cases) value: model: wan2.7-reference-video prompt: >- Image de référence, style film d'aventure 3D cartoon. Storyboard : 1. Plan large d'une forêt fantastique ; 2. Le garçon écarte les lianes pour explorer ; 3. Le petit robot scanne devant ; 4. Gros plan sur la carte au trésor ; 5. Visage excité du garçon ; 6. Ils sautent par-dessus les racines et s'enfoncent plus loin image_urls: - https://example.com/storyboard.png duration: 10 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-reference-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: Wan27ReferenceVideoRequest: required: - model - prompt type: object properties: model: type: string description: Nom du modèle, doit être `wan2.7-reference-video` enum: - wan2.7-reference-video example: wan2.7-reference-video 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 / signe de ponctuation compte pour 1, le surplus est tronqué automatiquement. Longueur maximale 5000 caractères **Règles d'indexation des personnages :** - Chinois : utilisez « 图1, 图2 / 视频1, 视频2 » — correspond 1-based à l'ordre de `image_urls` / `video_urls` - Anglais : utilisez « Image 1 », « Video 1 » (majuscule initiale, espace entre le mot et le chiffre) - Les images et les vidéos sont comptées séparément, donc « Image 1 » et « Video 1 » peuvent coexister - Si une seule image ou une seule vidéo de référence est fournie, vous pouvez écrire « l'image de référence » ou « la vidéo de référence » **Image multi-cases (storyboard) :** lorsqu'une image multi-cases est fournie, décrivez les plans clés au format storyboard ; le modèle reconnaît la grille et complète les transitions maxLength: 5000 example: >- Video 1 tient Image 3 et joue un doux folk country sur la chaise d'Image 4 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, utilisée comme première image de la vidéo générée. **Ne compte pas** dans la limite `image_urls` + `video_urls` ≤ 5. **N'accepte pas la liaison vocale** (le premier plan ne participe pas à l'attribution des voix multi-personnages) **Cas d'usage :** - Le sujet apparaît déjà dans le premier plan : combinez avec des éléments de référence pour renforcer la cohérence d'identité - Le sujet n'est pas dans le premier plan : les éléments de référence définissent les nouveaux sujets qui apparaissent au cours de la vidéo **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_urls: type: array items: type: string format: uri description: >- Liste d'URL d'images de référence. Peut fournir des sujets (personnes / animaux / objets) ou des arrière-plans de scène ; lorsqu'un sujet est inclus, chaque image devrait contenir un **seul** personnage **Limites de quantité :** - `image_urls` + `video_urls` total ≤ 5 - Au moins l'un de `image_urls` / `video_urls` doit être fourni (envoyer uniquement `image_start` ne suffit pas) **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/ref1.jpg - https://example.com/ref2.jpg video_urls: type: array items: type: string format: uri description: >- Liste d'URL de vidéos de référence. La vidéo devrait contenir un sujet (personne / animal / objet) ; les plans vides ou purement de fond sont déconseillés. Lorsqu'un sujet est inclus, chaque vidéo devrait contenir un **seul** personnage. L'audio de la vidéo peut servir de référence vocale **Limites de quantité :** - `image_urls` + `video_urls` total ≤ 5 - Au moins l'un de `image_urls` / `video_urls` doit être fourni **Limites vidéo :** - Formats : mp4, mov - Durée : `1 ~ 30` secondes - Résolution : largeur et hauteur dans `[240, 4096]` pixels - Rapport d'aspect : 1:8 ~ 8:1 - Taille du fichier : jusqu'à `100 Mo` **Note :** lorsque `video_urls` est fourni, `duration` est plafonné à 10 secondes example: - https://example.com/reference.mp4 audio_urls: type: array items: type: string format: uri maxItems: 5 description: >- **[Champ de compatibilité — préférez `model_params.voice_bindings`]** Liste d'URL de voix de référence. Liées positionnellement aux éléments de référence dans cet ordre : d'abord avec `video_urls`, puis avec `image_urls` (dans l'ordre de leurs listes, un à un). Jusqu'à 5 éléments **Priorité :** - Lorsque `model_params.voice_bindings` et `audio_urls` sont tous deux fournis, seul `voice_bindings` est utilisé et ce champ est ignoré - Si une vidéo dans `video_urls` contient de l'audio et qu'aucune liaison vocale n'est définie, l'audio original est utilisé ; une liaison vocale explicite remplace l'audio original **Limites audio :** - Formats pris en charge : `wav`, `mp3` - Durée : `1 ~ 10` secondes - Taille du fichier : jusqu'à `15 Mo` example: - https://example.com/voice1.mp3 - https://example.com/voice2.mp3 model_params: type: object description: Conteneur de paramètres avancés (recommandé) properties: voice_bindings: type: object description: >- **Liaison vocale précise pour plusieurs personnages (recommandé).** A la priorité sur `audio_urls` **Règles de liaison :** - Les clés sont au format `image{N}` ou `video{N}` (1-based, sans zéros en tête, par ex. `image1`, `video2`) - Le N de la clé correspond à « 图N / Image N » ou « 视频N / Video N » dans le prompt et correspond à `image_urls[N-1]` / `video_urls[N-1]` - Chaque valeur est l'URL audio de la voix de ce personnage - Total des liaisons ≤ 5 - `image_start` (premier plan) **n'accepte pas** de liaison vocale - Vous pouvez ignorer certains personnages (par ex. lier seulement image1 et image3, en laissant image2 sans liaison) **Limites audio :** - Formats pris en charge : `wav`, `mp3` - Durée : `1 ~ 10` secondes - Taille du fichier : jusqu'à `15 Mo` **Erreurs de validation :** - Format de clé invalide : `voice_bindings key "img1"/"image01" invalid` - Index hors plage : `voice_bindings.image5 out of range` - Valeur vide, liaison en double, ou plus de 5 liaisons additionalProperties: type: string format: uri example: image1: https://example.com/voice_a.mp3 image3: https://example.com/voice_c.mp3 video1: https://example.com/voice_v.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 aspect_ratio: type: string description: >- Rapport d'aspect vidéo, par défaut `16:9` **Comportement :** - `image_start` non fourni : la vidéo est générée avec le `aspect_ratio` spécifié - `image_start` fourni : ce champ est **ignoré** ; la vidéo utilise un rapport d'aspect proche de l'image de premier plan **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' default: '16:9' example: '16:9' duration: type: number description: |- Durée vidéo en secondes (entier) **Plage :** - Sans `video_urls` : `2 ~ 15`, par défaut `5` - Avec `video_urls` : `2 ~ 10` (plafonné à 10 secondes) **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-reference-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 ``` ````