Subject (Legacy)

POST https://www.kkiai.com/kling/v1/general/custom-elements

Request Parameters

Authorization

Add the Authorization parameter to the Header. Its value is the Token concatenated after Bearer.

Example: Authorization: Bearer ********************

Header Parameters

Parameter Name	Type	Required	Description	Example
Content-Type	string	Optional		application/json
Authorization	string	Optional		Bearer {{YOUR_API_KEY}}

Body Parameters (application/json)

Parameter Name	Type	Required	Description
element_name	string	Required	Subject name. Cannot exceed 20 characters.
element_description	string	Required	Subject description. Cannot exceed 100 characters.
element_frontal_image	string	Required	Subject frontal reference image. Supports image Base64 encoding or image URL (ensure accessibility). Supported image formats: .jpg / .jpeg / .png. Image file size cannot exceed 10MB. Image dimensions must be at least 300px. Image aspect ratio must be between 1:2.5 ~ 2.5:1.
element_refer_list	array[object]	Required	Subject other reference list. Define subject appearance by uploading multiple reference images from different angles. Upload at least 1 reference image, at most 3 reference images. Carried by key:value pairs, details as follows: 1 2 3 4 5 "element_refer_list":[ {"image_url":"image_url_1"}, {"image_url":"image_url_2"}, {"image_url":"image_url_3"} ]
└ image_url	string	Required

Request Example

{
    "element_name": "",
    "element_description": "",
    "element_frontal_image": "",
    "element_refer_list": ""
}

cURL Example

curl --location --request POST 'https://www.kkiai.com/kling/v1/general/custom-elements' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "element_name": "",
    "element_description": "",
    "element_frontal_image": "",
    "element_refer_list": ""
}'

Response

🟢 200 Success

Response Example

{}