> ## 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 Flash Video Edit

> - Edition d'une video d'entree : remplacer des sujets, ajouter ou supprimer des objets, restyliser ou repeindre des zones
- Décrivez directement la modification dans le prompt, par exemple : "Supprimer tous les passants de @video1 et ne garder que le personnage principal"
- Fournissez exactement 1 vidéo à éditer (obligatoire, `4` à `30` secondes) + des images de référence facultatives (0–10) + de l'audio de référence (0–5) ; la durée et le rapport d'aspect de sortie suivent la vidéo d'entrée
- 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-flash-video-edit.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: API Seedance 2.5 Flash Video Edit
  description: >-
    API d'edition video Seedance 2.5 Flash : modifie une video d'entree —
    remplacer des sujets, ajouter ou supprimer des objets, restyliser des zones
  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 Flash Video Edit
      description: >-
        - Edition d'une video d'entree : remplacer des sujets, ajouter ou
        supprimer des objets, restyliser ou repeindre des zones

        - Décrivez directement la modification dans le prompt, par exemple :
        "Supprimer tous les passants de @video1 et ne garder que le personnage
        principal"

        - Fournissez exactement 1 vidéo à éditer (obligatoire, `4` à `30`
        secondes) + des images de référence facultatives (0–10) + de l'audio de
        référence (0–5) ; la durée et le rapport d'aspect de sortie suivent la
        vidéo d'entrée

        - 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: createSeedance25FlashVideoEdit
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              remove_objects:
                summary: Editer la video (supprimer des objets)
                value:
                  model: seedance-2.5-flash-video-edit
                  prompt: >-
                    Supprimer tous les passants de @video1 et ne garder que le
                    personnage principal
                  video_urls:
                    - https://example.com/original.mp4
                  quality: 720p
                  generate_audio: true
              replace_subject:
                summary: >-
                  Editer la video (remplacer un element a partir d'une image de
                  reference)
                value:
                  model: seedance-2.5-flash-video-edit
                  prompt: >-
                    Remplacer le parfum du coffret cadeau de @video1 par la
                    creme visage de @image1, sans modifier le mouvement de
                    camera
                  image_urls:
                    - https://example.com/cream.jpg
                  video_urls:
                    - https://example.com/original.mp4
                  quality: 720p
      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-flash-video-edit
                  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-flash-video-edit
          default: seedance-2.5-flash-video-edit
          example: seedance-2.5-flash-video-edit
        prompt:
          type: string
          description: >-
            Prompt textuel decrivant l'edition souhaitee. Prend en charge le
            chinois et l'anglais ; 500 caracteres maximum recommandes en
            chinois. Longueur maximale du prompt : 10000 tokens


            **Details :**

            - Décrivez directement la modification souhaitée, par exemple :
            "Supprimer tous les passants de @video1 et ne garder que le
            personnage principal"

            - Vous pouvez preciser en langage naturel le role de chaque element,
            par exemple : "remplacer le personnage de @video1 par celui de
            @image1"

            - Le modele comprend automatiquement la correspondance entre les
            numeros des elements et leur usage
          example: >-
            Supprimer tous les passants de @video1 et ne garder que le
            personnage principal
        video_urls:
          type: array
          description: >-
            Tableau d'URL de vidéos d'entrée, **obligatoire ; exactement 1
            vidéo**


            **Condition :** fournissez exactement 1 vidéo, celle à éditer. La
            durée et le rapport d'aspect de sortie suivent cette vidéo.


            **Exigences pour les videos :**

            - Formats pris en charge : `.mp4`, `.mov`

            - Resolution : 480p, 720p, 1080p, 4K

            - Durée de la vidéo : `4` à `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

            - Les URLs de videos doivent etre directement accessibles par le
            serveur
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 1
          example:
            - https://example.com/original.mp4
        image_urls:
          type: array
          description: >-
            Tableau d'URLs d'images de reference, **facultatif ; 1 a 10 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,
            sujet de remplacement (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: 10
          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 5 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 5 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: 5
          example:
            - https://example.com/bgm.mp3
        duration:
          type: integer
          description: >-
            Duree de la video de sortie (secondes), par defaut `-1`


            **Details :**

            - Ce champ peut être omis ; s'il est fourni, seule la valeur `-1`
            est acceptée et la durée de sortie suit la vidéo d'entrée

            - Les durees personnalisees sont refusees
          enum:
            - -1
          default: -1
          example: -1
        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 vidéo d'entrée ; ce
            champ peut aussi être omis

            - 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` : aucun nouvel audio n'est généré
          default: true
          example: true
        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-flash-video-edit
        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 Flash 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: >-
            Durée de la vidéo (secondes). Pour l'édition vidéo, il s'agit de la
            durée de la vidéo d'entrée arrondie à la seconde entière supérieure
          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.