Chuyển đến nội dung chính
POST
/
kling
/
v1
/
videos
/
multi-elements
/
add-selection
Add selection points to a Kling multimodal session
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/multi-elements/add-selection \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "784914037360041984",
  "frame_index": 1,
  "points": [
    {
      "x": 0,
      "y": 1
    }
  ]
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {}
}
Sử dụng endpoint này để đánh dấu vùng video mà bạn muốn trình chỉnh sửa multimodal thao tác trên đó.

​
Cách vùng chọn hoạt động

  • session_id đến từ Initialize Video for Editing
  • frame_index chọn khung hình nơi bạn đặt các điểm
  • points là các tọa độ đã được chuẩn hóa trong khoảng từ 0 đến 1
  • Tài liệu của Kling hiện hỗ trợ tối đa 10 khung hình được đánh dấu và tối đa 10 điểm cho mỗi khung hình

​
Vai trò trong quy trình

1

Khởi tạo trước

Bắt đầu với Initialize Video for Editing để lấy session_id hợp lệ.
2

Thêm hoặc tinh chỉnh các điểm

Gọi endpoint này khi bạn xây dựng vùng cần chỉnh sửa.
3

Xem trước khu vực

Sử dụng Preview Selected Video Area trước khi gửi lần cuối.
Để xem tài liệu tham chiếu tham số đầy đủ, hãy xem tài liệu API của Kling.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

application/json
​
session_id
string
mặc định:784914037360041984
bắt buộc

Session ID, generated based on the video initialization task, does not change with selection editing actions.

​
frame_index
integer
mặc định:1
bắt buộc

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[]
bắt buộc

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.

Phản hồi

200 - application/json

Selection updated.

​
code
integer
bắt buộc
​
message
string
bắt buộc
​
data
object