Langsung ke konten utama
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": {}
}
Gunakan endpoint ini untuk menandai area video yang ingin diproses oleh editor multimodal.

Cara kerja seleksi

  • session_id berasal dari Initialize Video for Editing
  • frame_index memilih frame tempat Anda menempatkan titik
  • points adalah koordinat ternormalisasi antara 0 dan 1
  • Dokumentasi Kling saat ini menyebutkan hingga 10 frame yang ditandai dan hingga 10 titik per frame

Peran dalam alur kerja

1

Initialize first

Mulai dengan Initialize Video for Editing untuk mendapatkan session_id yang valid.
2

Add or refine points

Panggil endpoint ini saat Anda membangun area yang akan diedit.
3

Preview the area

Gunakan Preview Selected Video Area sebelum pengiriman akhir.
Untuk referensi parameter lengkap, lihat dokumentasi API Kling.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json
session_id
string
default:784914037360041984
wajib

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

frame_index
integer
default:1
wajib

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[]
wajib

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.

Respons

200 - application/json

Selection updated.

code
integer
wajib
message
string
wajib
data
object