> ## 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 影片選取

> 使用 Kling 的 Add Video Selection 端點，在多元素影片編輯中新增選取元素，透過 CometAPI 實現針對性編輯與場景控制。

使用此端點來標記你希望多模態編輯器操作的影片區域。

## 選取如何運作

* `session_id` 來自[初始化待編輯影片](./initialize-video-for-editing)
* 使用相同帳號，以及初始化時回傳的完全相同 `session_id`
* `frame_index` 會選擇你放置點位的影格
* `points` 是介於 `0` 到 `1` 之間的正規化座標
* Kling 文件說明最多可標記 10 個影格，且每個影格最多可有 10 個點位

## 工作流程中的角色

<Steps>
  <Step title="先初始化">
    先從[初始化待編輯影片](./initialize-video-for-editing)開始，以取得有效的 `session_id`。
  </Step>

  <Step title="新增或微調點位">
    在你建立要編輯的區域時呼叫此端點。
  </Step>

  <Step title="預覽區域">
    在最終提交前，使用[預覽已選取的影片區域](./preview-selected-video-area)。
  </Step>
</Steps>

<Tip>
  如需完整的參數參考，請參閱 [Kling API 文件](https://kling.ai/document-api/apiReference/model/multiElements)。
</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.

````