Перейти до основного вмісту
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": {}
}
Використовуйте цей endpoint, щоб позначити область відео, з якою має працювати multimodal editor.

Як працює виділення

  • session_id надходить із Initialize Video for Editing
  • frame_index вибирає кадр, на якому ви розміщуєте точки
  • points — це нормалізовані координати в межах від 0 до 1
  • У документації Kling наразі зазначено до 10 позначених кадрів і до 10 точок на кадр

Роль у workflow

1

Initialize first

Почніть із Initialize Video for Editing, щоб отримати дійсний session_id.
2

Add or refine points

Викликайте цей endpoint у процесі побудови області для редагування.
3

Preview the area

Скористайтеся Preview Selected Video Area перед остаточним надсиланням.
Щоб переглянути повний довідник параметрів, дивіться документацію API Kling.

Авторизації

Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

application/json
session_id
string
за замовчуванням:784914037360041984
обов'язково

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

frame_index
integer
за замовчуванням:1
обов'язково

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[]
обов'язково

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.

Відповідь

200 - application/json

Selection updated.

code
integer
обов'язково
message
string
обов'язково
data
object