> ## 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 Универсальный справочник

> Эта серия поддерживает формат генерации видео OpenAI (подробности см. по ссылке [совместимые форматы видео生成Sora ](/api-reference/ru/generaciya-video-sovmestimyi-format-sora/sozdat-video)).

Нативный интерфейс задач Kling 4.0. Для аутентификации используйте Bearer API Key этого сайта. В теле запроса не требуется model; при settings.resolution=720p используется kling-4.0, при 1080p — kling-4.0-1080p; по умолчанию — 1080p. После успешного создания используйте возвращённый data.id для вызова GET /tasks?task_ids=ID_задачи; несколько ID разделяйте запятыми. data в ответе на запрос представляет собой массив, URL результирующего видео находится в data[].outputs[].url.

В настоящее время поддерживаются соответствующие сценарии генерации для промпта, first_frame, last_frame, refer_image и feature_video. Не поддерживаются middle_frame, base_video, element, voice, аудиореференсы, callback или пользовательский внешний ID задачи; непустые options.callback_url, options.external_task_id, contents.id и другие неподдерживаемые поля приведут к ошибке 400. Параметр options можно не указывать или передать пустой объект; также можно передать watermark_info.enabled=false. Включение водяного знака пока не поддерживается. В настоящее время поддерживается длительность от 4 до 30 секунд, по умолчанию — 10 секунд; 3 секунды не поддерживаются. Для сценариев генерации по тексту и с референсом соотношение сторон по умолчанию — 16:9; явное указание adaptive приведёт к ошибке 400. Сценарии с первым и последним кадрами не принимают явный settings.aspect_ratio; соотношение сторон определяется размером первого изображения frame.

Поле contents для универсального референса должно содержать непустой prompt и хотя бы один поддерживаемый медиафайл. В устаревшем сценарии с начальным и конечным кадрами можно передать first_frame, last_frame или оба параметра, однако возможность обработки зависит от возможностей доступной в данный момент модели; при несовместимости возможностей запрос будет отклонён, а изображения кадров не будут автоматически преобразованы в обычные референсные изображения. Для новой интеграции сценария с начальным и конечным кадрами рекомендуется использовать вход image-to-video. Начальный и конечный кадры нельзя использовать вместе с референсным изображением refer_image или референсным видео feature_video; при смешанном использовании будет возвращён код 400. В сценарии референса можно комбинировать референсное изображение refer_image и референсное видео feature_video. Для каждого из first_frame, last_frame и refer_image допускается не более 1 элемента, для feature_video — не более 5 элементов. Сценарии с несколькими референсными изображениями, на которые ссылаются по id, пока не поддерживаются.



## OpenAPI

````yaml api-reference/ru/openapi.json POST /omni-video/kling-4.0
openapi: 3.0.0
info:
  title: Справочная документация API для "出海营"
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: Формат OpenAI (Chat)
  - name: Формат OpenAI (Responses)
  - name: Формат Gemini для генерации изображений
  - name: Генерация изображенийOpenAI в формате DALL-E
  - name: Получить список моделей
  - name: Генерация видеоHappyHorse и Wan
  - name: ФорматKling генерации видео
  - name: Видео-генерация Omni и формат Veo
  - name: Генерация видео Seedance
  - name: Совместимый формат для Sora генерации видео
  - name: Генерация видео Vidu
  - name: Формат задачи генерации музыки
paths:
  /omni-video/kling-4.0:
    post:
      tags:
        - ФорматKling генерации видео
      summary: Kling Универсальный справочник
      description: >-
        Эта серия поддерживает формат генерации видео OpenAI (подробности см. по
        ссылке [совместимые форматы видео生成Sora
        ](/api-reference/ru/generaciya-video-sovmestimyi-format-sora/sozdat-video)).


        Нативный интерфейс задач Kling 4.0. Для аутентификации используйте
        Bearer API Key этого сайта. В теле запроса не требуется model; при
        settings.resolution=720p используется kling-4.0, при 1080p —
        kling-4.0-1080p; по умолчанию — 1080p. После успешного создания
        используйте возвращённый data.id для вызова GET
        /tasks?task_ids=ID_задачи; несколько ID разделяйте запятыми. data в
        ответе на запрос представляет собой массив, URL результирующего видео
        находится в data[].outputs[].url.


        В настоящее время поддерживаются соответствующие сценарии генерации для
        промпта, first_frame, last_frame, refer_image и feature_video. Не
        поддерживаются middle_frame, base_video, element, voice, аудиореференсы,
        callback или пользовательский внешний ID задачи; непустые
        options.callback_url, options.external_task_id, contents.id и другие
        неподдерживаемые поля приведут к ошибке 400. Параметр options можно не
        указывать или передать пустой объект; также можно передать
        watermark_info.enabled=false. Включение водяного знака пока не
        поддерживается. В настоящее время поддерживается длительность от 4 до 30
        секунд, по умолчанию — 10 секунд; 3 секунды не поддерживаются. Для
        сценариев генерации по тексту и с референсом соотношение сторон по
        умолчанию — 16:9; явное указание adaptive приведёт к ошибке 400.
        Сценарии с первым и последним кадрами не принимают явный
        settings.aspect_ratio; соотношение сторон определяется размером первого
        изображения frame.


        Поле contents для универсального референса должно содержать непустой
        prompt и хотя бы один поддерживаемый медиафайл. В устаревшем сценарии с
        начальным и конечным кадрами можно передать first_frame, last_frame или
        оба параметра, однако возможность обработки зависит от возможностей
        доступной в данный момент модели; при несовместимости возможностей
        запрос будет отклонён, а изображения кадров не будут автоматически
        преобразованы в обычные референсные изображения. Для новой интеграции
        сценария с начальным и конечным кадрами рекомендуется использовать вход
        image-to-video. Начальный и конечный кадры нельзя использовать вместе с
        референсным изображением refer_image или референсным видео
        feature_video; при смешанном использовании будет возвращён код 400. В
        сценарии референса можно комбинировать референсное изображение
        refer_image и референсное видео feature_video. Для каждого из
        first_frame, last_frame и refer_image допускается не более 1 элемента,
        для feature_video — не более 5 элементов. Сценарии с несколькими
        референсными изображениями, на которые ссылаются по id, пока не
        поддерживаются.
      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: >-
                    Можно не указывать, передать пустой объект или явно
                    отключить водяной знак.
                  properties:
                    watermark_info:
                      type: object
                      additionalProperties: false
                      required:
                        - enabled
                      properties:
                        enabled:
                          type: boolean
                          enum:
                            - false
                contents:
                  type: array
                  minItems: 2
                  description: >-
                    Необходимо одновременно указать непустой `prompt` и
                    поддерживаемый медиаресурс; для генерации видео из
                    изображения обязательно требуется `first_frame`.
                    `first_frame`/`last_frame` нельзя использовать вместе с
                    `refer_image`/`feature_video`, иначе будет возвращён код
                    400. Ограничения на количество каждого типа медиаресурсов
                    см. в описании API. Устаревшие запросы с начальным и
                    конечным кадрами проверяются в соответствии с возможностями
                    доступных в данный момент моделей; для новой интеграции с
                    начальным и конечным кадрами рекомендуется использовать
                    эндпоинт генерации видео из изображения.
                  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: >-
                    Сценарии совместимости исторических первого и последнего
                    кадров: first_frame, last_frame или оба — с учетом
                    ограничений возможностей доступных в настоящее время
                    моделей. Не смешивайте референсные материалы; опустите
                    aspect_ratio, соотношение сторон будет взято из первого
                    frame.
                  properties:
                    contents:
                      items:
                        properties:
                          type:
                            enum:
                              - prompt
                              - first_frame
                              - last_frame
                    settings:
                      not:
                        required:
                          - aspect_ratio
                - description: >-
                    Справочный сценарий: refer_image и feature_video можно
                    использовать вместе; соотношение сторон по умолчанию — 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: Успешно
          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 задачи на этом сайте; при запросе передавайте без
                          изменений.
                      status:
                        type: string
                        enum:
                          - submitted
                          - processing
                          - succeeded
                          - failed
                      create_time:
                        type: integer
                        format: int64
                        description: Время создания в миллисекундах Unix.
                      update_time:
                        type: integer
                        format: int64
                        description: Время обновления в миллисекундах Unix.
                      external_id:
                        type: string
                        maxLength: 0
              examples:
                success:
                  summary: Успешно
                  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: >-
            Параметры запроса недействительны или содержат неподдерживаемые
            поля.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Используйте проверку подлинности Bearer Token.
        Формат: `Authorization: Bearer sk-xxxxxx`

````

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