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

# Anteprima della selezione video Kling

> Usa l'endpoint Preview Selected Video Area per generare un'anteprima rapida delle aree selezionate nelle modifiche video multimodali di Kling tramite CometAPI.

Usa questo endpoint per visualizzare in anteprima l'area selezionata prima di inviare l'attività finale di modifica multimodale.

## Perché l'anteprima è importante

* Ti permette di verificare che i punti di selezione coprano l'oggetto o l'area desiderata
* Aiuta a individuare maschere errate prima di consumare una chiamata di generazione
* È il punto di controllo più sicuro tra la modifica della selezione e la creazione dell'attività finale

## Ruolo nel flusso di lavoro

<Steps>
  <Step title="Inizializza la sessione">
    Inizia con [Initialize Video for Editing](./initialize-video-for-editing) e conserva il `session_id` restituito sullo stesso account.
  </Step>

  <Step title="Aggiungi punti di selezione">
    Usa [Add Video Selection](./add-video-selection) finché l'area non è quasi corretta.
  </Step>

  <Step title="Anteprima prima della generazione">
    Chiama questo endpoint, poi continua con [Create Task](./create-task) solo quando la selezione appare corretta.
  </Step>
</Steps>

<Tip>
  Per il riferimento completo dei parametri, consulta la [documentazione dell'API Kling](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.

````