> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Предпросмотр выбранной области видео Kling

> Используйте endpoint Preview Selected Video Area, чтобы быстро отрисовать предпросмотр выбранных областей при мультимодальном редактировании видео Kling через CometAPI.

Используйте этот endpoint, чтобы предварительно просмотреть выбранную область перед отправкой финальной задачи мультимодального редактирования.

## Почему предпросмотр важен

* Он позволяет проверить, что точки выделения охватывают нужный объект или область
* Он помогает выявить некорректные маски до того, как вы потратите вызов генерации
* Это самая безопасная контрольная точка между редактированием выделения и созданием финальной задачи

## Роль в рабочем процессе

<Steps>
  <Step title="Инициализируйте сессию">
    Начните с [Initialize Video for Editing](./initialize-video-for-editing) и сохраните возвращённый `session_id` в той же учётной записи.
  </Step>

  <Step title="Добавьте точки выделения">
    Используйте [Add Video Selection](./add-video-selection), пока область не станет близкой к правильной.
  </Step>

  <Step title="Сделайте предпросмотр перед генерацией">
    Вызовите этот endpoint, а затем переходите к [Create Task](./create-task) только после того, как убедитесь, что выделение выглядит правильно.
  </Step>
</Steps>

<Tip>
  Полное описание параметров см. в [документации Kling API](https://kling.ai/document-api/apiReference/model/multiElements).
</Tip>


## OpenAPI

````yaml api/openapi/video/kling/multimodal-video-editing/post-preview-selected-video-area.openapi.json POST /kling/v1/videos/multi-elements/preview-selection
openapi: 3.1.0
info:
  title: Preview Selected Video Area API
  version: 1.0.0
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /kling/v1/videos/multi-elements/preview-selection:
    post:
      summary: Preview Selected Video Area
      operationId: preview_selected_video_area
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - session_id
              properties:
                session_id:
                  type: string
                  description: Session id returned by the video initialization endpoint.
              default:
                session_id: <session_id>
            examples:
              Default:
                summary: Default
                value:
                  session_id: <session_id>
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - message
                properties:
                  code:
                    type: integer
                    description: Response code. `0` means the request succeeded.
                  message:
                    type: string
                    description: Response message.
                  data:
                    type: object
                    description: Route-specific response payload when present.
                    additionalProperties: true
                additionalProperties: true
      x-codeSamples:
        - lang: Shell
          label: Default
          source: >
            curl
            https://api.cometapi.com/kling/v1/videos/multi-elements/preview-selection
            \
              -H "Authorization: Bearer $COMETAPI_KEY" \
              -H "Content-Type: application/json" \
              -d '{
                  "session_id": "<session_id>"
                }'
        - lang: Python
          label: Default
          source: |
            import os
            import requests

            response = requests.post(
                "https://api.cometapi.com/kling/v1/videos/multi-elements/preview-selection",
                headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
                json={
                  "session_id": "<session_id>"
                },
            )

            result = response.json()
            print(result.get("code"), result.get("data"))
        - lang: JavaScript
          label: Default
          source: >
            const response = await
            fetch("https://api.cometapi.com/kling/v1/videos/multi-elements/preview-selection",
            {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "session_id": "<session_id>"
              }),
            });


            const result = await response.json();

            console.log(result.code, result.data);
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication. Use your CometAPI key.

````