> ## 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 video seçimi ekle

> CometAPI üzerinden hedefli düzenlemeler ve sahne kontrolü sağlayarak, çok öğeli video düzenlemede seçim öğeleri eklemek için Kling Add Video Selection endpoint'ini kullanın.

Multimodal düzenleyicinin üzerinde çalışmasını istediğiniz video bölgesini işaretlemek için bu endpoint'i kullanın.

## Seçim nasıl çalışır

* `session_id`, [Initialize Video for Editing](./initialize-video-for-editing) işleminden gelir
* Başlatma sırasında döndürülen aynı hesabı ve tam `session_id` değerini kullanın
* `frame_index`, noktaları yerleştirdiğiniz kareyi seçer
* `points`, `0` ile `1` arasında normalize edilmiş koordinatlardır
* Kling, en fazla 10 işaretli kareyi ve kare başına en fazla 10 noktayı belgelemektedir

## İş akışı rolü

<Steps>
  <Step title="Önce başlatın">
    Geçerli bir `session_id` almak için [Initialize Video for Editing](./initialize-video-for-editing) ile başlayın.
  </Step>

  <Step title="Noktaları ekleyin veya iyileştirin">
    Düzenlenecek bölgeyi oluştururken bu endpoint'i çağırın.
  </Step>

  <Step title="Alanı önizleyin">
    Son gönderimden önce [Preview Selected Video Area](./preview-selected-video-area) kullanın.
  </Step>
</Steps>

<Tip>
  Tam parametre başvurusu için [Kling API documentation](https://kling.ai/document-api/apiReference/model/multiElements) sayfasına bakın.
</Tip>


## OpenAPI

````yaml api/openapi/video/kling/multimodal-video-editing/post-add-video-selection.openapi.json POST /kling/v1/videos/multi-elements/add-selection
openapi: 3.1.0
info:
  title: Add Video Selection API
  version: 1.0.0
  description: Add or refine selection points for a Kling multimodal editing session.
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /kling/v1/videos/multi-elements/add-selection:
    post:
      summary: Add selection points to a Kling multimodal session
      description: >-
        Place normalized point coordinates on a chosen frame within the current
        session.
      operationId: add_video_selection
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - session_id
                - points
                - frame_index
              properties:
                session_id:
                  type: string
                  description: >-
                    Selection session id returned by init-selection. Follow-up
                    calls must use the same account and exact session id.
                frame_index:
                  type: integer
                  description: >-
                    Frame number


                    Supports adding up to 10 marked frames, meaning video
                    selections can be marked based on a maximum of 10 frames.

                    Only 1 frame can be marked at a time.
                points:
                  type: array
                  description: >-
                    Click coordinates, represented by x and y.

                    Value range: [0,1], expressed as a percentage; [0,1]
                    represents the top-left corner of the frame.

                    Supports adding multiple marked points simultaneously, with
                    a maximum of 10 points per frame.
                  items:
                    type: object
                    properties:
                      x:
                        type: number
                      'y':
                        type: number
              default:
                session_id: <session_id>
                points:
                  - x: 0.5
                    'y': 0.5
                frame_index: 1
            examples:
              Default:
                summary: Default
                value:
                  session_id: <session_id>
                  frame_index: 1
                  points:
                    - x: 0.5
                      'y': 0.5
      responses:
        '200':
          description: Selection updated.
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - message
                properties:
                  code:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    additionalProperties: true
      x-codeSamples:
        - lang: Shell
          label: Default
          source: >
            curl
            https://api.cometapi.com/kling/v1/videos/multi-elements/add-selection
            \
              -H "Authorization: Bearer $COMETAPI_KEY" \
              -H "Content-Type: application/json" \
              -d '{
                  "session_id": "<session_id>",
                  "frame_index": 1,
                  "points": [
                    {
                      "x": 0.5,
                      "y": 0.5
                    }
                  ]
                }'
        - lang: Python
          label: Default
          source: |
            import os
            import requests

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

            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/add-selection",
            {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "session_id": "<session_id>",
                "frame_index": 1,
                "points": [
                  {
                    "x": 0.5,
                    "y": 0.5
                  }
                ]
              }),
            });


            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.

````