> ## 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 Texte vers Vidéo > - Le modèle WAN2.7 (wan2.7-text-to-video) prend en charge la génération texte-vers-vidéo, produisant des vidéos fluides à partir d'invites textuelles - **Narration multi-plans :** contrôlez la structure des plans via le langage naturel dans `prompt` - Plan unique : indiquez « générer une vidéo en plan unique » dans le prompt - Plans multiples : utilisez « générer une vidéo multi-plans » ou des listes horodatées (par ex. « Plan 1 [0-3s] grand angle : rue nocturne sous la pluie ») - Par défaut : si non précisé, le modèle interprète le contenu du `prompt` lui-même - **Gestion audio :** - Avec `audio_urls` : le modèle utilise l'audio fourni comme source pilote - Sans `audio_urls` : le modèle génère automatiquement une musique de fond ou des effets sonores adaptés au contenu visuel - 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-text-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: wan2.7-text-to-video API description: >- Générez des vidéos à partir de texte avec le modèle WAN2.7 et une configuration de paramètres simplifiée 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-text-to-video API description: >- - Le modèle WAN2.7 (wan2.7-text-to-video) prend en charge la génération texte-vers-vidéo, produisant des vidéos fluides à partir d'invites textuelles - **Narration multi-plans :** contrôlez la structure des plans via le langage naturel dans `prompt` - Plan unique : indiquez « générer une vidéo en plan unique » dans le prompt - Plans multiples : utilisez « générer une vidéo multi-plans » ou des listes horodatées (par ex. « Plan 1 [0-3s] grand angle : rue nocturne sous la pluie ») - Par défaut : si non précisé, le modèle interprète le contenu du `prompt` lui-même - **Gestion audio :** - Avec `audio_urls` : le modèle utilise l'audio fourni comme source pilote - Sans `audio_urls` : le modèle génère automatiquement une musique de fond ou des effets sonores adaptés au contenu visuel - 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: createWan27TextToVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Wan27TextToVideoRequest' examples: single_shot: summary: Texte-vers-vidéo en plan unique value: model: wan2.7-text-to-video prompt: Un petit chaton qui court sous le clair de lune aspect_ratio: '16:9' duration: 5 multi_shot_storyboard: summary: Storyboard multi-plans value: model: wan2.7-text-to-video prompt: >- Une enquête tendue. Plan 1 [0-3s] grand angle : rue nocturne sous la pluie, néons clignotants. Plan 2 [3-6s] plan moyen : le détective entre dans un vieux bâtiment. Plan 3 [6-9s] gros plan : regard déterminé, sirènes au loin. Plan 4 [9-12s] plan moyen : il avance prudemment dans un couloir sombre. Plan 5 [12-15s] gros plan : il découvre l'indice clé, expression de révélation. aspect_ratio: '16:9' duration: 15 with_audio: summary: Avec audio pilote value: model: wan2.7-text-to-video prompt: >- Un mignon petit général chat de dessin animé en armure dorée chevauche un cheval de guerre et récite un poème classique audio_urls: - https://example.com/recital.mp3 duration: 10 with_negative_prompt: summary: Avec prompt négatif value: model: wan2.7-text-to-video prompt: Un petit chaton qui court sous le clair de lune negative_prompt: fleurs 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-text-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: Wan27TextToVideoRequest: required: - model - prompt type: object properties: model: type: string description: Nom du modèle, doit être `wan2.7-text-to-video` enum: - wan2.7-text-to-video example: wan2.7-text-to-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 compte pour 1, le surplus est tronqué automatiquement. Longueur maximale : 5000 caractères **Narration multi-plans :** contrôlez la structure des plans via le langage naturel - Plan unique : indiquez « générer une vidéo en plan unique » dans le prompt - Plans multiples : utilisez « générer une vidéo multi-plans » ou des listes horodatées (par ex. « Plan 1 [0-3s] ») maxLength: 5000 example: Un petit chaton qui court sous le clair de lune 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é audio_urls: type: array items: type: string format: uri minItems: 1 maxItems: 1 description: >- Liste d'URL audio pilote (optionnel). **Actuellement, un seul élément est pris en charge** **Comportement :** - Fourni : le modèle utilise cet audio comme source pilote - Omis : le modèle génère automatiquement une musique de fond ou des effets sonores adaptés au visuel **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 aspect_ratio: type: string description: >- Rapport d'aspect vidéo, par défaut `16:9` **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, plage 2-15 **Note :** - Toute valeur entière entre `2~15` secondes est prise en charge - La facturation finale est 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-text-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 ``` ````