Tạo chủ thể

POST

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

Tạo chủ thể tùy chỉnh để dùng cho tạo video và các tính năng liên quan sau này.

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Không quá 20 ký tự.

Không quá 100 ký tự.

Giá trị: video_refer, image_refer

• video_refer: chủ thể nhân vật video; ngoại hình theo element_video_list
• image_refer: chủ thể đa ảnh; ngoại hình theo element_image_list
  Phạm vi dùng chủ thể tạo từ video và ảnh khác nhau; xem bản đồ năng lực và mô tả tham số.

object

Thiết lập chủ thể và chi tiết bằng nhiều ảnh.

Gồm ảnh mặt trước và góc/cận khác: ít nhất một ảnh mặt trước (frontal_image); 1–3 ảnh khác mặt trước (image_url).

Dạng key:value:

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

Hỗ trợ ảnh Base64 hoặc URL (phải truy cập được).

Định dạng: .jpg / .jpeg / .png. Tối đa 10MB, tối thiểu 300px, tỷ lệ 1:2.5 ~ 2.5:1.

Bắt buộc khi reference_type là image_refer.

object

Thiết lập chủ thể và chi tiết bằng video.

Có thể tải video có tiếng; tiếng người kích hoạt tùy chỉnh giọng (huấn luyện, thư viện, gắn chủ thể).

Hiện chỉ hỗ trợ chủ thể người chân thực từ video.

Bắt buộc khi tham chiếu video; bỏ qua khi tham chiếu ảnh.

Dạng key:value. Chỉ MP4/MOV. 3–8 giây, 16:9 hoặc 9:16, 1080p. Tối đa 1 video, 200MB. video_url không được rỗng.

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

Chủ thể từ video chỉ hỗ trợ trên kling-video-o3 trở lên.

Gắn giọng có sẵn trong thư viện.

Để trống thì không gắn giọng.

Lấy ID qua API giọng.

Chỉ chủ thể từ video hỗ trợ gắn giọng.

object[]

Một chủ thể có thể có nhiều thẻ.

Dạng key:value. ID và tên: o_101 meme, o_102 người, o_103 động vật, o_104 đạo cụ, o_105 trang phục, o_106 cảnh, o_107 hiệu ứng, o_108 khác

URL callback khi trạng thái tác vụ thay đổi (nếu cấu hình).

ID tác vụ do người gọi định nghĩa. Không ghi đè ID hệ thống nhưng có thể tra cứu. Phải duy nhất theo người dùng.