주체 생성

POST

/kling/v1/general/advanced-custom-elements

이후 동영상 생성 등에 사용할 사용자 정의 주체를 생성합니다.

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

20자를 초과할 수 없습니다.

100자를 초과할 수 없습니다.

허용 값: video_refer, image_refer

• video_refer: 동영상 캐릭터 주체, element_video_list로 외형 정의
• image_refer: 다중 이미지 주체, element_image_list로 외형 정의
  동영상과 이미지로 만든 주체의 지원 범위가 다릅니다. 기능 맵과 매개변수 설명을 참고하세요.

object

여러 이미지로 주체와 세부 사항을 설정할 수 있습니다.

정면 참조와 다른 각도·클로즈업 참조를 포함합니다. 정면은 frontal_image로 최소 1장, image_url로 정면과 다른 참조 이미지 1~3장.

key:value 형식 예:

"element_image_list": {
"frontal_image": "image_url_0",
"refer_images": [{ "image_url": "image_url_1" }, ...]
}

Base64 인코딩 이미지 또는 접근 가능한 URL을 지원합니다.

형식: .jpg / .jpeg / .png. 최대 10MB, 최소 300px, 종횡비 1:2.5~2.5:1.

reference_type이 image_refer일 때 필수입니다.

object

동영상으로 주체와 세부 사항을 설정할 수 있습니다.

음성이 있는 동영상 업로드 가능. 사람 목소리가 있으면 음색 맞춤(학습·라이브러리 저장·주체 바인딩)이 트리거됩니다.

현재는 동영상으로 사실적인 인형 주체만 지원합니다.

동영상 참조 시 필수, 이미지 참조 시 무시됩니다.

key:value 형식. MP4/MOV만 지원. 길이 3~8초, 16:9 또는 9:16, 1080p. 최대 1개, 200MB 이하. video_url은 비어 있을 수 없습니다.

"element_video_list": {
"refer_videos": [{ "video_url": "video_url_1" }, ...]
}

동영상 주체는 kling-video-o3 이후 모델에서만 지원됩니다.

음색 라이브러리의 기존 음색을 바인딩할 수 있습니다.

비어 있으면 음색을 바인딩하지 않습니다.

음색 관련 API로 ID를 가져올 수 있습니다.

동영상 주체만 음색 바인딩을 지원합니다.

object[]

하나의 주체에 여러 태그를 설정할 수 있습니다.

key:value 형식. 태그 ID와 이름: o_101 밈, o_102 인물, o_103 동물, o_104 소품, o_105 의상, o_106 장면, o_107 효과, o_108 기타

설정 시 작업 상태 변경 콜백 URL.

호출자 정의 작업 ID. 시스템 ID를 덮어쓰지 않으며 이 ID로 조회할 수 있습니다. 사용자별로 고유해야 합니다.