> ## 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.

# Kling-4.0-Flash Références vers Vidéo

> - Kling-4.0 Flash Reference to Video (kling-v4-flash-reference-to-video) génère de nouvelles vidéos à partir d’images et de vidéos de référence
- Les vidéos servent de références de caractéristiques (sans édition directe) et peuvent être combinées avec du texte et des images de référence
- Seule la résolution `720p` est prise en charge, pour une durée de `3` à `20` secondes
- Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour [consulter le statut](/fr/api-manual/task-management/get-task-detail)
- Les liens vidéo générés sont valides pendant 24 heures, veuillez les sauvegarder rapidement

### Choisir entre Flash et Kling 4.0

Flash est conçu pour la création fréquente et les itérations créatives rapides, avec un accent sur la vitesse de génération et la maîtrise des coûts pour de courtes vidéos en `720p`. La comparaison ci-dessous présente les fonctionnalités actuellement prises en charge par l’API EvoLink.

| Caractéristique | Kling 4.0 Flash | Kling 4.0 |
| --- | --- | --- |
| Résolution de sortie | `720p` | `720p`, `1080p` |
| Durée de sortie | `3` à `20` secondes | `3` à `30` secondes |
| Images de référence | Jusqu’à `10` | Jusqu’à `10` |
| Vidéos de référence | Jusqu’à `5` clips, pour un total de `20` secondes maximum | Jusqu’à `5` clips, pour un total de `30` secondes maximum |

La durée totale des vidéos de référence et la durée de sortie ont des limites distinctes. Réduire la durée de sortie n’augmente pas la limite d’entrée. Pour des références plus longues, une sortie en `1080p` ou une durée de sortie supérieure à `20` secondes, utilisez [Kling 4.0 Référence vers vidéo](/fr/api-manual/video-series/kling/kling-v4-reference-to-video).

Flash utilise des identifiants de modèle distincts. Lors de la migration, vérifiez `model`, `quality` et `duration`. Les frais réels dépendent du tarif en vigueur du modèle Flash choisi et de la facturation finale de la tâche.



## OpenAPI

````yaml fr/api-manual/video-series/kling/kling-v4-flash-reference-to-video.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: API kling-v4-flash-reference-to-video
  description: >-
    Créer des tâches de génération vidéo à partir de références avec des modèles
    IA
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Génération vidéo
    description: APIs de génération de vidéos IA
paths:
  /v1/videos/generations:
    post:
      tags:
        - Génération vidéo
      summary: API kling-v4-flash-reference-to-video
      description: >-
        - Kling-4.0 Flash Reference to Video (kling-v4-flash-reference-to-video)
        génère de nouvelles vidéos à partir d’images et de vidéos de référence

        - Les vidéos servent de références de caractéristiques (sans édition
        directe) et peuvent être combinées avec du texte et des images de
        référence

        - Seule la résolution `720p` est prise en charge, pour une durée de `3`
        à `20` secondes

        - Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour
        [consulter le statut](/fr/api-manual/task-management/get-task-detail)

        - Les liens vidéo générés sont valides pendant 24 heures, veuillez les
        sauvegarder rapidement


        ### Choisir entre Flash et Kling 4.0


        Flash est conçu pour la création fréquente et les itérations créatives
        rapides, avec un accent sur la vitesse de génération et la maîtrise des
        coûts pour de courtes vidéos en `720p`. La comparaison ci-dessous
        présente les fonctionnalités actuellement prises en charge par l’API
        EvoLink.


        | Caractéristique | Kling 4.0 Flash | Kling 4.0 |

        | --- | --- | --- |

        | Résolution de sortie | `720p` | `720p`, `1080p` |

        | Durée de sortie | `3` à `20` secondes | `3` à `30` secondes |

        | Images de référence | Jusqu’à `10` | Jusqu’à `10` |

        | Vidéos de référence | Jusqu’à `5` clips, pour un total de `20`
        secondes maximum | Jusqu’à `5` clips, pour un total de `30` secondes
        maximum |


        La durée totale des vidéos de référence et la durée de sortie ont des
        limites distinctes. Réduire la durée de sortie n’augmente pas la limite
        d’entrée. Pour des références plus longues, une sortie en `1080p` ou une
        durée de sortie supérieure à `20` secondes, utilisez [Kling 4.0
        Référence vers
        vidéo](/fr/api-manual/video-series/kling/kling-v4-reference-to-video).


        Flash utilise des identifiants de modèle distincts. Lors de la
        migration, vérifiez `model`, `quality` et `duration`. Les frais réels
        dépendent du tarif en vigueur du modèle Flash choisi et de la
        facturation finale de la tâche.
      operationId: createVideoGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              basic:
                summary: Référence vidéo basique
                value:
                  model: kling-v4-flash-reference-to-video
                  prompt: >-
                    Conserver le style de mouvement de <<<video_1>>> et
                    remplacer le fond par un paysage enneigé
                  video_urls:
                    - https://example.com/reference.mp4
                  duration: 5
                  aspect_ratio: '16:9'
                  quality: 720p
              with_reference_image:
                summary: Références vidéo et image
                value:
                  model: kling-v4-flash-reference-to-video
                  prompt: >-
                    La personne de <<<image_1>>> marche dans une scène reprenant
                    le style de <<<video_1>>>
                  video_urls:
                    - https://example.com/reference.mp4
                  image_urls:
                    - https://example.com/character.jpg
                  duration: 5
                  aspect_ratio: '9:16'
                  quality: 720p
              image_only:
                summary: Images de référence uniquement
                value:
                  model: kling-v4-flash-reference-to-video
                  prompt: >-
                    Le produit de <<<image_1>>> est posé sur une table en bois
                    tandis que la caméra tourne lentement autour
                  image_urls:
                    - https://example.com/product.jpg
                  duration: 5
                  aspect_ratio: '1:1'
                  quality: 720p
      responses:
        '200':
          description: Tâche de génération 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é, token 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, rechargement nécessaire
          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:
                    kling-v4-flash-reference-to-video
                  type: invalid_request_error
        '429':
          description: Limite de requêtes 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:
    VideoGenerationRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          description: Nom du modèle de génération vidéo
          enum:
            - kling-v4-flash-reference-to-video
          default: kling-v4-flash-reference-to-video
          example: kling-v4-flash-reference-to-video
        prompt:
          type: string
          description: >-
            Prompt textuel de 2500 caractères maximum


            **Syntaxe de référence :** Utilisez `<<<xxx>>>` dans le prompt pour
            référencer des images et des vidéos, par exemple : `La personne de
            <<<image_1>>> marche dans la rue avec les mouvements de caméra de
            <<<video_1>>>`
          example: >-
            La personne de <<<image_1>>> marche dans la rue avec les mouvements
            de caméra de <<<video_1>>>
          maxLength: 2500
        video_urls:
          type: array
          description: >-
            Tableau d’URL de vidéos de référence, jusqu’à `5` clips,
            correspondant dans l’ordre à `<<<video_1>>>`, `<<<video_2>>>`, etc.
            dans le prompt


            **Exigences vidéo :**

            - Formats : MP4 / MOV

            - Taille : ≤ 200MB par clip

            - Durée : ≥ 3 secondes par clip, ≤ 20 secondes au total

            - Dimensions : largeur et hauteur de 720px à 2160px

            - Fréquence d’images : de 24fps à 60fps

            - Les URL des vidéos doivent être directement accessibles par le
            serveur
          items:
            type: string
            format: uri
          maxItems: 5
          example:
            - https://example.com/reference.mp4
        image_urls:
          type: array
          description: >-
            Tableau d’URL d’images de référence (style, scène ou sujet),
            correspondant dans l’ordre à `<<<image_1>>>`, `<<<image_2>>>`, etc.
            dans le prompt


            **Limite :** Jusqu’à `10` images

            **Remarque :** Les URL doivent être directement accessibles par le
            serveur ou déclencher un téléchargement direct lors de l’accès
          items:
            type: string
            format: uri
          example:
            - https://example.com/character.jpg
          maxItems: 10
        duration:
          type: integer
          description: |-
            Durée de la vidéo en secondes. Valeur par défaut : `5` secondes

            **Plage :**
            - Entier de `3` à `20`
          minimum: 3
          maximum: 20
          default: 5
          example: 5
        aspect_ratio:
          type: string
          description: |-
            Rapport d’aspect de la vidéo

            **Options :**
            - `16:9` : Paysage
            - `9:16` : Portrait
            - `1:1` : Carré
            - `21:9` : Ultra-large
          enum:
            - '16:9'
            - '9:16'
            - '1:1'
            - '21:9'
          example: '16:9'
          default: '16:9'
        quality:
          type: string
          description: |-
            Niveau de résolution

            **Options :**
            - Seule la résolution `720p` est prise en charge
          enum:
            - 720p
          default: 720p
          example: 720p
        callback_url:
          type: string
          description: >-
            URL de rappel HTTPS pour l'achèvement de la tâche


            **Moment du rappel :**

            - Déclenché lorsque la tâche est terminée, échouée ou annulée

            - Envoyé après confirmation de la facturation


            **Restrictions de sécurité :**

            - Protocole HTTPS uniquement

            - Les adresses IP internes sont interdites (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 rappel :**

            - Délai d'expiration : `10` secondes

            - Maximum `3` tentatives après échec (à `1`/`2`/`4` secondes après
            l'échec)

            - Le format de réponse du rappel est cohérent avec l'API de requête
            de tâche

            - Un code de statut 2xx est considéré comme un succès, les autres
            codes déclenchent une nouvelle tentative
          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 tâche
          example: task-unified-1757169743-7cvnl5zw
        model:
          type: string
          description: Nom du modèle réellement utilisé
          example: kling-v4-flash-reference-to-video
        object:
          type: string
          enum:
            - video.generation.task
          description: Type de tâche
        progress:
          type: integer
          description: Pourcentage de progression 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: Détails de 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/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: Si la tâche peut être annulée
          example: false
        estimated_time:
          type: integer
          description: Temps d'achèvement estimé (secondes)
          minimum: 0
          example: 300
        video_duration:
          type: integer
          description: Durée de la vidéo (secondes)
          example: 5
    VideoUsage:
      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_second
        credits_reserved:
          type: number
          description: Crédits estimés consommés
          minimum: 0
          example: 42.84
        user_group:
          type: string
          description: Catégorie de groupe d'utilisateurs
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ## Toutes les API nécessitent une authentification Bearer Token ##


        **Obtenir une clé API :**


        Visitez la [Page de gestion des clés
        API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API


        **Ajouter à l'en-tête de requête :**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.