> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiid.edu.kg/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling Référence complète

> Cette série prend en charge le format de génération vidéo OpenAI (voir le lien [Formats compatibles pour la génération vidéo Sora](/api-reference/fr/generation-video-format-compatible-sora/creer-video)).

Interface de tâches native Kling 4.0. Utilise l'authentification Bearer API Key de ce site. Le corps de la requête ne nécessite pas `model` ; `settings.resolution=720p` utilise `kling-4.0`, `1080p` utilise `kling-4.0-1080p`, avec `1080p` par défaut. Après une création réussie, utilisez le `data.id` renvoyé pour appeler `GET /tasks?task_ids=ID_DE_TÂCHE` ; séparez plusieurs ID par des virgules. Le `data` de la requête est un tableau ; la vidéo générée se trouve dans `data[].outputs[].url`.

Les scénarios de génération actuellement pris en charge correspondent à l'invite, à first_frame, à last_frame, à refer_image et à feature_video. middle_frame, base_video, element, voice, les références audio, les rappels et les ID de tâche externes personnalisés ne sont pas pris en charge ; une valeur non vide pour options.callback_url, options.external_task_id ou contents.id, ainsi que tout autre champ non pris en charge, renverra une erreur 400. options peut être omis ou transmis comme objet vide ; vous pouvez également transmettre watermark_info.enabled=false. L'activation du filigrane n'est pas encore prise en charge. Les durées prises en charge sont actuellement de 4 à 30 secondes, avec une valeur par défaut de 10 secondes ; 3 secondes ne sont pas prises en charge. Pour les scénarios de génération à partir de texte et de référence, le format par défaut est 16:9 ; spécifier explicitement adaptive renverra une erreur 400. Les scénarios avec première et dernière image n'acceptent pas de settings.aspect_ratio explicite ; le format est déterminé par les dimensions de la première image frame.

Le champ contents de la référence polyvalente doit contenir un prompt non vide et au moins un média pris en charge. Pour les anciens cas d’usage avec image de début et de fin, vous pouvez transmettre first_frame, last_frame ou les deux, mais les capacités de traitement dépendent des modèles actuellement disponibles. En cas d’incompatibilité de capacité, la requête est refusée ; les images de frame ne sont pas silencieusement converties en images de référence standard. Pour les nouvelles intégrations d’images de début et de fin, il est recommandé d’utiliser le point d’entrée de génération de vidéo à partir d’image. Les images de début et de fin ne peuvent pas être combinées avec des images de référence refer_image ou des vidéos de référence feature_video ; une telle combinaison renvoie une erreur 400. Dans les scénarios de référence, les images de référence refer_image peuvent être combinées avec les vidéos de référence feature_video. first_frame, last_frame et refer_image acceptent chacun au maximum 1 élément, tandis que feature_video en accepte au maximum 5. Les scénarios de plusieurs images de référence reposant sur des références par id ne sont pas encore pris en charge.



## OpenAPI

````yaml api-reference/fr/openapi.json POST /omni-video/kling-4.0
openapi: 3.0.0
info:
  title: Documentation de référence de 出海营 API
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: OpenAIFormat (Chat)
  - name: Format OpenAI(Responses)
  - name: Format Gemini pour la génération d’images
  - name: Génération d’imagesOpenAI au format DALL-E
  - name: Obtenir la liste des modèles
  - name: Génération vidéoHappyHorse avec Wan
  - name: Format de génération vidéo Kling
  - name: Format Omni de génération vidéo et Veo
  - name: Génération vidéo Seedance
  - name: Formats compatibles avec la génération de vidéosSora
  - name: Génération vidéo Vidu
  - name: Format de tâche de génération musicale
paths:
  /omni-video/kling-4.0:
    post:
      tags:
        - Format de génération vidéo Kling
      summary: Kling Référence complète
      description: >-
        Cette série prend en charge le format de génération vidéo OpenAI (voir
        le lien [Formats compatibles pour la génération vidéo
        Sora](/api-reference/fr/generation-video-format-compatible-sora/creer-video)).


        Interface de tâches native Kling 4.0. Utilise l'authentification Bearer
        API Key de ce site. Le corps de la requête ne nécessite pas `model` ;
        `settings.resolution=720p` utilise `kling-4.0`, `1080p` utilise
        `kling-4.0-1080p`, avec `1080p` par défaut. Après une création réussie,
        utilisez le `data.id` renvoyé pour appeler `GET
        /tasks?task_ids=ID_DE_TÂCHE` ; séparez plusieurs ID par des virgules. Le
        `data` de la requête est un tableau ; la vidéo générée se trouve dans
        `data[].outputs[].url`.


        Les scénarios de génération actuellement pris en charge correspondent à
        l'invite, à first_frame, à last_frame, à refer_image et à feature_video.
        middle_frame, base_video, element, voice, les références audio, les
        rappels et les ID de tâche externes personnalisés ne sont pas pris en
        charge ; une valeur non vide pour options.callback_url,
        options.external_task_id ou contents.id, ainsi que tout autre champ non
        pris en charge, renverra une erreur 400. options peut être omis ou
        transmis comme objet vide ; vous pouvez également transmettre
        watermark_info.enabled=false. L'activation du filigrane n'est pas encore
        prise en charge. Les durées prises en charge sont actuellement de 4 à 30
        secondes, avec une valeur par défaut de 10 secondes ; 3 secondes ne sont
        pas prises en charge. Pour les scénarios de génération à partir de texte
        et de référence, le format par défaut est 16:9 ; spécifier explicitement
        adaptive renverra une erreur 400. Les scénarios avec première et
        dernière image n'acceptent pas de settings.aspect_ratio explicite ; le
        format est déterminé par les dimensions de la première image frame.


        Le champ contents de la référence polyvalente doit contenir un prompt
        non vide et au moins un média pris en charge. Pour les anciens cas
        d’usage avec image de début et de fin, vous pouvez transmettre
        first_frame, last_frame ou les deux, mais les capacités de traitement
        dépendent des modèles actuellement disponibles. En cas d’incompatibilité
        de capacité, la requête est refusée ; les images de frame ne sont pas
        silencieusement converties en images de référence standard. Pour les
        nouvelles intégrations d’images de début et de fin, il est recommandé
        d’utiliser le point d’entrée de génération de vidéo à partir d’image.
        Les images de début et de fin ne peuvent pas être combinées avec des
        images de référence refer_image ou des vidéos de référence feature_video
        ; une telle combinaison renvoie une erreur 400. Dans les scénarios de
        référence, les images de référence refer_image peuvent être combinées
        avec les vidéos de référence feature_video. first_frame, last_frame et
        refer_image acceptent chacun au maximum 1 élément, tandis que
        feature_video en accepte au maximum 5. Les scénarios de plusieurs images
        de référence reposant sur des références par id ne sont pas encore pris
        en charge.
      operationId: create_kling4_native_omni_video
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - contents
              properties:
                settings:
                  type: object
                  additionalProperties: false
                  properties:
                    resolution:
                      type: string
                      enum:
                        - 720p
                        - 1080p
                      default: 1080p
                    duration:
                      type: integer
                      minimum: 4
                      maximum: 30
                      default: 10
                    aspect_ratio:
                      type: string
                      enum:
                        - '21:9'
                        - '16:9'
                        - '9:16'
                        - '1:1'
                options:
                  type: object
                  additionalProperties: false
                  description: >-
                    Peut être omis, recevoir un objet vide ou désactiver
                    explicitement le filigrane.
                  properties:
                    watermark_info:
                      type: object
                      additionalProperties: false
                      required:
                        - enabled
                      properties:
                        enabled:
                          type: boolean
                          enum:
                            - false
                contents:
                  type: array
                  minItems: 2
                  description: >-
                    Doit inclure à la fois un `prompt` non vide et un média pris
                    en charge ; la génération de vidéo à partir d’une image doit
                    inclure `first_frame`. `first_frame`/`last_frame` ne peuvent
                    pas être utilisés conjointement avec
                    `refer_image`/`feature_video`, sinon une erreur 400 est
                    renvoyée. Consultez la documentation de l’API pour les
                    limites de quantité de chaque média. Les requêtes
                    historiques avec image de début et de fin sont validées
                    selon les capacités des modèles actuellement disponibles ;
                    pour les nouvelles intégrations avec image de début et de
                    fin, il est recommandé d’utiliser le point d’entrée de
                    génération de vidéo à partir d’une image.
                  items:
                    oneOf:
                      - type: object
                        additionalProperties: false
                        required:
                          - type
                          - text
                        properties:
                          type:
                            type: string
                            enum:
                              - prompt
                          text:
                            type: string
                            minLength: 1
                      - type: object
                        additionalProperties: false
                        required:
                          - type
                          - url
                        properties:
                          type:
                            type: string
                            enum:
                              - first_frame
                              - last_frame
                              - refer_image
                              - feature_video
                          url:
                            type: string
                            format: uri
                            pattern: ^https?://
                  not:
                    items:
                      properties:
                        type:
                          enum:
                            - prompt
              oneOf:
                - description: >-
                    Scénarios historiques compatibles avec la première et la
                    dernière image : `first_frame`, `last_frame` ou les deux,
                    sous réserve des capacités actuellement disponibles du
                    modèle. Ne mélangez pas les ressources de référence ;
                    omettez `aspect_ratio`, le format suivra la première
                    `frame`.
                  properties:
                    contents:
                      items:
                        properties:
                          type:
                            enum:
                              - prompt
                              - first_frame
                              - last_frame
                    settings:
                      not:
                        required:
                          - aspect_ratio
                - description: >-
                    Scénario de référence : `refer_image` et `feature_video`
                    peuvent être utilisés ensemble. Le format d’image par défaut
                    est 16:9.
                  properties:
                    contents:
                      items:
                        properties:
                          type:
                            enum:
                              - prompt
                              - refer_image
                              - feature_video
                    settings:
                      properties:
                        aspect_ratio:
                          type: string
                          enum:
                            - '21:9'
                            - '16:9'
                            - '9:16'
                            - '1:1'
                          default: '16:9'
            examples:
              kling4_native_720p:
                summary: Kling 720p
                value:
                  settings:
                    resolution: 720p
                    duration: 10
                    aspect_ratio: '16:9'
                  options: {}
                  contents:
                    - type: prompt
                      text: A cinematic product shot with natural motion
                    - type: refer_image
                      url: https://example.com/reference.jpg
                    - type: feature_video
                      url: https://example.com/motion.mp4
              kling4_native_1080p:
                summary: Kling 1080p
                value:
                  settings:
                    resolution: 1080p
                    duration: 10
                    aspect_ratio: '16:9'
                  options: {}
                  contents:
                    - type: prompt
                      text: A cinematic product shot with natural motion
                    - type: refer_image
                      url: https://example.com/reference.jpg
                    - type: feature_video
                      url: https://example.com/motion.mp4
      responses:
        '200':
          description: Succès
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - message
                  - request_id
                  - data
                properties:
                  code:
                    type: integer
                    example: 0
                  message:
                    type: string
                  request_id:
                    type: string
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: >-
                          ID de tâche de ce site, à transmettre tel quel lors de
                          la requête.
                      status:
                        type: string
                        enum:
                          - submitted
                          - processing
                          - succeeded
                          - failed
                      create_time:
                        type: integer
                        format: int64
                        description: Heure de création, en millisecondes Unix.
                      update_time:
                        type: integer
                        format: int64
                        description: Heure de mise à jour, en millisecondes Unix.
                      external_id:
                        type: string
                        maxLength: 0
              examples:
                success:
                  summary: Succès
                  value:
                    code: 0
                    message: SUCCEED
                    request_id: request_example
                    data:
                      id: task_example
                      status: submitted
                      create_time: 1792710000000
                      update_time: 1792710000000
                      external_id: ''
        '400':
          description: >-
            Les paramètres de la requête sont invalides ou contiennent des
            champs non pris en charge.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Utilisez l'authentification Bearer Token.
        Format : `Authorization: Bearer sk-xxxxxx`

````

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