Skip to main content
POST
/
kling
/
v1
/
videos
/
multi-elements
/
add-selection
cURL
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
        }
      ]
    }'
{
  "code": 123,
  "message": "<string>",
  "data": {}
}
Use this endpoint to mark the video region you want the multimodal editor to operate on.

​
How selection works

  • session_id comes from Initialize Video for Editing
  • Use the same account and exact session_id returned by initialization
  • frame_index selects the frame where you place points
  • points are normalized coordinates between 0 and 1
  • Kling documents up to 10 marked frames and up to 10 points per frame

​
Workflow role

1

Initialize first

Start with Initialize Video for Editing to get a valid session_id.
2

Add or refine points

Call this endpoint as you build the region to edit.
3

Preview the area

Use Preview Selected Video Area before final submission.
For the complete parameter reference, see the Kling API documentation.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
session_id
string
required

Selection session id returned by init-selection. Follow-up calls must use the same account and exact session id.

​
frame_index
integer
required

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
object[]
required

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.

Response

200 - application/json

Selection updated.

​
code
integer
required
​
message
string
required
​
data
object