> ## 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)** - 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)** - 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 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 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 en amont - 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 enum: - 480p - 720p default: 720p example: 720p 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 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 :** - Declenche lorsque la tache est terminee (completed), echouee (failed) ou annulee (cancelled) - 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 tache peut etre annulee example: true 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 ``` ````