> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Seedance 2.5 Video Extend > - Prolonge une video d'entree vers l'avant ou vers l'arriere - Le prompt doit exprimer l'intention d'extension (par exemple "Prolonger @video1 vers l'arriere, le personnage sort du cadre") - Fournissez la video a prolonger (obligatoire) + des images de reference facultatives (0–30) + des videos de reference (10 au maximum au total) + de l'audio de reference (0–10) - **Prend desormais en charge les contenus humains realistes generes par IA (AIGC)** - Le **mode brouillon** est pris en charge : envoyez `draft: true` pour générer un brouillon en 480p, puis utilisez [Draft-to-Video](/fr/api-manual/video-series/seedance2.5/seedance-2.5-draft-to-video) pour obtenir une vidéo finale en 1080p si le résultat vous convient. Les deux générations sont facturées séparément - Mode de traitement asynchrone, utilisez l'ID de tache retourne pour [consulter le statut](/fr/api-manual/task-management/get-task-detail) - Le lien de la video generee est valide pendant 24 heures, veuillez le sauvegarder rapidement ## OpenAPI ````yaml fr/api-manual/video-series/seedance2.5/seedance-2.5-video-extend.json POST /v1/videos/generations openapi: 3.1.0 info: title: API Seedance 2.5 Video Extend description: >- API d'extension video Seedance 2.5 : prolonge une video d'entree vers l'avant ou vers l'arriere license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production security: - bearerAuth: [] tags: - name: Generation video description: Interfaces de generation video par IA paths: /v1/videos/generations: post: tags: - Generation video summary: Seedance 2.5 Video Extend description: >- - Prolonge une video d'entree vers l'avant ou vers l'arriere - Le prompt doit exprimer l'intention d'extension (par exemple "Prolonger @video1 vers l'arriere, le personnage sort du cadre") - Fournissez la video a prolonger (obligatoire) + des images de reference facultatives (0–30) + des videos de reference (10 au maximum au total) + de l'audio de reference (0–10) - **Prend desormais en charge les contenus humains realistes generes par IA (AIGC)** - Le **mode brouillon** est pris en charge : envoyez `draft: true` pour générer un brouillon en 480p, puis utilisez [Draft-to-Video](/fr/api-manual/video-series/seedance2.5/seedance-2.5-draft-to-video) pour obtenir une vidéo finale en 1080p si le résultat vous convient. Les deux générations sont facturées séparément - Mode de traitement asynchrone, utilisez l'ID de tache retourne pour [consulter le statut](/fr/api-manual/task-management/get-task-detail) - Le lien de la video generee est valide pendant 24 heures, veuillez le sauvegarder rapidement operationId: createSeedance25VideoExtend requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: extend_backward: summary: Prolonger la video vers l'arriere (duree personnalisee) value: model: seedance-2.5-video-extend prompt: >- Prolonger @video1 vers l'arriere : le personnage sort du cadre et la camera recule lentement pour reveler la rue vide video_urls: - https://example.com/original.mp4 duration: 12 quality: 720p generate_audio: true content_filter: true extend_forward: summary: Prolonger la video vers l'avant (duree automatique) value: model: seedance-2.5-video-extend prompt: >- Prolonger @video1 vers l'avant : le personnage continue de marcher vers le coucher de soleil tandis que la lumiere faiblit video_urls: - https://example.com/original.mp4 duration: -1 quality: 720p draft: summary: Mode brouillon (480p) value: model: seedance-2.5-video-extend prompt: >- Prolonger @video1 vers l'arriere : le personnage sort du cadre et la camera recule lentement pour reveler la rue vide video_urls: - https://example.com/original.mp4 duration: 12 quality: 480p generate_audio: true content_filter: true draft: true responses: '200': description: Tache de generation video creee avec succes content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Erreur de parametres de requete content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_parameter message: Invalid request parameters type: invalid_request_error '401': description: Non authentifie, token invalide ou expire content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Quota insuffisant, rechargement necessaire 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: Acces non autorise content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: >- Token does not have access to model: seedance-2.5-video-extend type: invalid_request_error '429': description: Limite de frequence de requetes depassee 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 '503': description: >- Service temporairement indisponible ; le code draft_unavailable peut être renvoyé lorsque le mode brouillon est indisponible content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: draft_unavailable: summary: Mode brouillon temporairement indisponible value: error: code: draft_unavailable message: >- Draft mode is not available on the selected service right now. Retry later or send the request without draft. type: invalid_request_error components: schemas: VideoGenerationRequest: type: object required: - model - prompt - video_urls properties: model: type: string description: Nom du modele de generation video enum: - seedance-2.5-video-extend default: seedance-2.5-video-extend example: seedance-2.5-video-extend prompt: type: string description: >- Prompt textuel decrivant l'extension souhaitee. Prend en charge le chinois et l'anglais ; 500 caracteres maximum recommandes en chinois. Longueur maximale du prompt : 10000 tokens **Details :** - Le prompt doit exprimer l'intention d'extension, par exemple : "Prolonger @video1 vers l'arriere, le personnage sort du cadre" - Vous pouvez preciser en langage naturel le role de chaque element, par exemple : "prolonger @video1 vers l'avant en suivant le style de @image1" - Le modele comprend automatiquement la correspondance entre les numeros des elements et leur usage example: >- Prolonger @video1 vers l'arriere : le personnage sort du cadre et la camera recule lentement pour reveler la rue vide video_urls: type: array description: >- Tableau d'URL de videos d'entree, **obligatoire ; de 1 a 10 videos** **Condition :** au moins 1 video est requise, celle a prolonger. La premiere video est l'objet de l'extension ; les suivantes servent de reference. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Video | `reference_video` | La video a prolonger (la premiere), reference de mouvement de camera ou d'action (les suivantes) | **Exigences pour les videos :** - Formats pris en charge : `.mp4`, `.mov` - Resolution : 480p, 720p, 1080p, 4K - Duree par video : `2` a `30` secondes, maximum 10 videos, duree totale de toutes les videos ≤ `30` secondes - Rapport d'aspect (largeur/hauteur) : `0.4` a `2.5` - Dimensions en pixels : `300` a `6000` px - Pixels d'image (largeur x hauteur) : `409 600` a `8 295 044` (ex. 640×640 a 3326×2494) - Taille maximale par video : `200 Mo` - Frequence d'images : `24` a `60` FPS - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - La validite du codec, de la resolution et des autres caracteristiques du contenu est verifiee en plus par le modele - L'utilisation de references video entraine des frais supplementaires (la duree de la video d'entree est comptabilisee dans la facturation) - Les URLs de videos doivent etre directement accessibles par le serveur items: type: string format: uri minItems: 1 maxItems: 10 example: - https://example.com/original.mp4 image_urls: type: array description: >- Tableau d'URLs d'images de reference, **facultatif ; 1 a 30 images si fourni** **Condition :** `video_urls` est obligatoire pour ce modele ; les images sont des references complementaires facultatives. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Image | `reference_image` | Reference de style, visuel produit, reference de scene (indique dans le prompt) | **Exigences pour les images :** - Formats pris en charge : `.jpeg`, `.png`, `.webp` - Rapport d'aspect (largeur/hauteur) : `0.4` a `2.5` - Dimensions en pixels : `300` a `6000` px - Taille maximale par image : `30 Mo` - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - Les URLs d'images doivent etre directement accessibles par le serveur items: type: string format: uri minItems: 1 maxItems: 30 example: - https://example.com/ref1.jpg - https://example.com/ref2.jpg audio_urls: type: array description: >- Tableau d'URLs d'audios de reference, **facultatif ; 1 a 10 segments si fourni** **Condition :** `video_urls` est obligatoire pour ce modele ; l'audio est une reference complementaire facultative. **Description des roles :** | Type de media | Role | Utilisation typique | |---------|------|----------| | Audio | `reference_audio` | Musique de fond, effets sonores, reference vocale/dialogue | **Exigences pour les audios :** - Formats pris en charge : `.wav`, `.mp3` - Duree par segment audio : `2` a `30` secondes, maximum 10 segments, duree totale de tous les audios ≤ `30` secondes - Taille maximale par segment : `15 Mo` - Taille totale du corps de requete ne depassant pas `64 Mo`, ne pas utiliser l'encodage Base64 - Les URLs d'audios doivent etre directement accessibles par le serveur items: type: string format: uri minItems: 1 maxItems: 10 example: - https://example.com/bgm.mp3 duration: type: integer description: >- Duree de la video de sortie (secondes), par defaut `5` secondes **Details :** - Prend en charge toute valeur entiere comprise entre `4` et `30` secondes - `-1` : duree automatique, facturee selon la duree reellement produite - La duree influe directement sur la facturation default: 5 example: 12 quality: type: string description: >- Resolution video, par defaut `720p` **Valeurs possibles :** - `480p` : resolution inferieure, prix reduit - `720p` : resolution standard, valeur par defaut - `1080p` : resolution Ultra HD **Mode brouillon :** lorsque `draft` vaut `true`, seule la résolution `480p` est autorisée. Si `quality` est omis, `480p` est utilisé automatiquement enum: - 480p - 720p - 1080p default: 720p example: 720p draft: type: boolean default: false description: >- Active le mode brouillon, `false` par défaut **Détails :** - `true` : génère d’abord un brouillon en 480p, plus rapidement, au tarif normal de la résolution 480p - Lorsque ce mode est activé, `quality` doit valoir `480p` ou être omis. Toute autre résolution renvoie une erreur de paramètre 400 - Ce champ doit figurer au niveau racine du corps de la requête. Le placer dans `model_params` renvoie une erreur de paramètre 400 **Conversion en vidéo finale :** - Une fois le brouillon terminé, la [consultation de la tâche](/fr/api-manual/task-management/get-task-detail) renvoie `draft_expires_at` - Avant cette échéance, transmettez l’ID de tâche du brouillon à [Seedance 2.5 Draft-to-Video](/fr/api-manual/video-series/seedance2.5/seedance-2.5-draft-to-video) pour générer une vidéo finale en 1080p au contenu identique - La vidéo finale et le brouillon sont facturés séparément. Si le brouillon ne vous convient pas, vous pouvez renoncer à la conversion et ne payer que le brouillon - Par défaut, le brouillon reste convertible pendant 24 heures après son achèvement ; `draft_expires_at` indique l’échéance réelle. Envoyez la demande de conversion suffisamment tôt : une expiration pendant l’attente dans la file entraîne également l’échec de la conversion **Indisponibilité temporaire :** une réponse 503 peut être renvoyée lorsque le service est temporairement indisponible. Si le code d’erreur est `draft_unavailable`, réessayez plus tard ou retirez `draft` pour utiliser le mode normal example: false aspect_ratio: type: string description: >- Rapport d'aspect de la video, par defaut `adaptive` **Valeurs possibles :** - `adaptive` : le rapport de sortie suit la premiere video d'entree ; c'est la seule valeur acceptee par ce modele - Les rapports fixes comme `16:9` ou `9:16` sont refuses enum: - adaptive default: adaptive example: adaptive generate_audio: type: boolean description: >- Generer ou non un audio synchronise, par defaut `true` **Valeurs possibles :** - `true` : la video inclut un audio synchronise, sans frais supplementaires - `false` : video muette en sortie default: true example: true content_filter: type: boolean description: >- Filtre de contenu, par defaut `true` **Valeurs possibles :** - `true` : verification standard de securite du contenu, c'est la valeur par defaut - `false` : assouplit les restrictions de contenu, facture avec +10% (`1.1x`). Les contenus illegaux et interdits sont toujours appliques independamment de ce parametre **Incompatible avec la recherche web :** - `content_filter: false` et `model_params.web_search: true` ne peuvent pas etre utilises ensemble ; les envoyer ensemble renvoie une erreur de parametre 400 - Conservez `content_filter: true` (valeur par defaut) si la recherche web est necessaire default: true example: true output_format: type: string description: >- Format de conteneur de sortie, par defaut `mp4` **Valeurs possibles :** - `mp4` : encodage H.264, meilleure compatibilite et precision colorimetrique standard ; c'est la valeur par defaut - `mov` : H.264 + echantillonnage chroma yuv444p + audio PCM, fidelite colorimetrique superieure, recommande pour l'etalonnage, l'incrustation et le compositing. La lecture dans le navigateur peut ne pas fonctionner ; telechargez le fichier et lisez-le avec VLC / mpv / ffplay. Sans frais supplementaires enum: - mp4 - mov default: mp4 example: mp4 callback_url: type: string description: >- URL de rappel HTTPS apres l'achevement de la tache **Declenchement du rappel :** - Déclenché lorsque la tâche est terminée (completed) ou a échoué (failed) - Envoye apres la confirmation de la facturation **Restrictions de securite :** - Seul le protocole HTTPS est pris en charge - Les rappels vers les adresses IP privees 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 depasser `2048` caracteres **Mecanisme de rappel :** - Delai d'expiration : `10` secondes - Jusqu'a `3` tentatives apres un echec (respectivement `1`/`2`/`4` secondes apres l'echec) - Le format du corps de reponse du rappel est identique a celui de l'interface de consultation de tache - Un code de statut 2xx est considere comme un succes, les autres codes declenchent une nouvelle tentative format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Horodatage de creation de la tache example: 1761313744 id: type: string description: ID de la tache example: task-unified-1774857405-abc123 model: type: string description: Nom du modele effectivement utilise example: seedance-2.5-video-extend object: type: string enum: - video.generation.task description: Type specifique de la tache progress: type: integer description: Pourcentage de progression de la tache (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Statut de la tache enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Informations detaillees de la tache video type: type: string enum: - text - image - audio - video description: Type de sortie de la tache example: video usage: $ref: '#/components/schemas/VideoUsage' 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: >- Indique si la tâche peut être annulée. Seedance 2.5 ne permet pas aux utilisateurs d’annuler une tâche ; ce champ renvoie toujours `false`. example: false estimated_time: type: integer description: Temps estime d'achevement (secondes) minimum: 0 example: 165 video_duration: type: integer description: Duree de la video (secondes) example: 8 VideoUsage: type: object description: Informations d'utilisation et de facturation properties: billing_rule: type: string description: Regle de facturation enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: Nombre de credits estimes consommes minimum: 0 example: 50 user_group: type: string description: Categorie du groupe utilisateur example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## Toutes les interfaces necessitent une authentification par Bearer Token ## **Obtenir une cle API :** Visitez la [Page de gestion des cles API](https://evolink.ai/dashboard/keys) pour obtenir votre cle API **Ajoutez dans l'en-tete de la requete :** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.