> ## 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 비디오 선택 미리보기

> CometAPI를 통해 Kling 멀티모달 비디오 편집에서 선택한 영역의 빠른 미리보기를 렌더링하려면 Preview Selected Video Area 엔드포인트를 사용하세요.

최종 멀티모달 편집 작업을 제출하기 전에 선택한 영역을 미리보는 데 이 엔드포인트를 사용하세요.

## 미리보기가 중요한 이유

* 선택 지점이 의도한 객체나 영역을 제대로 포함하는지 확인할 수 있습니다
* 생성 호출을 쓰기 전에 잘못된 마스크를 찾아낼 수 있습니다
* 선택 편집과 최종 작업 생성 사이에서 가장 안전한 확인 지점입니다

## 워크플로에서의 역할

<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="생성 전에 미리보기">
    이 엔드포인트를 호출한 다음, 선택이 올바르게 보일 때만 [Create Task](./create-task)로 진행하세요.
  </Step>
</Steps>

<Tip>
  전체 파라미터 참조는 [Kling API documentation](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.

````