메인 콘텐츠로 건너뛰기
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": {}
}
이 엔드포인트를 사용하면 멀티모달 편집기가 작업할 비디오 영역을 표시할 수 있습니다.

선택 방식

  • session_id편집용 비디오 초기화에서 가져옵니다
  • frame_index는 포인트를 배치할 프레임을 선택합니다
  • points01 사이의 정규화된 좌표입니다
  • 현재 Kling 문서에서는 최대 10개의 표시된 프레임과 프레임당 최대 10개의 포인트를 지원합니다

워크플로에서의 역할

1

먼저 초기화

유효한 session_id를 얻기 위해 편집용 비디오 초기화부터 시작하세요.
2

포인트 추가 또는 보정

편집할 영역을 구성하는 동안 이 엔드포인트를 호출하세요.
3

영역 미리보기

최종 제출 전에 선택한 비디오 영역 미리보기를 사용하세요.
전체 파라미터 참조는 Kling API documentation에서 확인하세요.

인증

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