English

简体中文

English

简体中文
中文

POST /kling/v1/general/custom-elements ​

Method: POSTEndpoint: /kling/v1/general/custom-elements

Official Documentation： https://docs.qingque.cn/d/home/eZQCRUy_LWt70n5Wz2sTiLV6J?identityId=1oEFzU43FYK#section=h.jpo0r85p0amj

Request Parameters ​

Header Parameters ​

text
Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json ​

text
element_name
string
Required
element_description
string
Required
element_frontal_image
string
Required
element_refer_list
array
[object]
Required
Example
{
"element_name"
:
""
,
"element_description"
:
""
,
"element_frontal_image"
:
""
,
"element_refer_list"
:
[
{
}
]
}

Example Request ​

Shell ​

bash
curl --location --request POST '/kling/v1/general/custom-elements' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{

    "element_name": "",
    "element_description": "",
    "element_frontal_image": "",
    "element_refer_list": [
        {}
    ]
}'

Response ​

🟢 200 Success ​

Content Type: application/json

Response Schema ​

text
code
integer
Required
message
string
Required
request_id
string
Required
data
array
[object]
Required
element_id
integer
Required
element_name
string
Required
element_description
string
Required
element_frontal_image
string
Required
element_refer_list
array
[object]
Required
owned_by
string
Required
tag_list
array
[object]
Required

Example ​

json
{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "2cc4e73a-76a8-48ca-b510-eee57982f6b0",
    "data": [
        {
            "element_id": 171,
            "element_name": "Rooftop",
            "element_description": "Rooftop",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%A4%A9%E5%8F%B0-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.jpeg?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%A4%A9%E5%8F%B0-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 170,
            "element_name": "Snowfield",
            "element_description": "Snowfield",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E9%9B%AA%E5%9C%B0-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.jpeg?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E9%9B%AA%E5%9C%B0-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.jpeg?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 169,
            "element_name": "Song Dynasty Garden",
            "element_description": "Song Dynasty Garden",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%AE%8B%E4%BB%A3%E5%9B%AD%E6%9E%97-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.jpeg?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%AE%8B%E4%BB%A3%E5%9B%AD%E6%9E%97-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 168,
            "element_name": "Coffee Shop",
            "element_description": "Coffee Shop",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%92%96%E5%95%A1%E5%BA%97-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.jpeg?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%92%96%E5%95%A1%E5%BA%97-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 167,
            "element_name": "Snow Mountain",
            "element_description": "Snow Mountain",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E9%9B%AA%E5%B1%B1-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.png?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E9%9B%AA%E5%B1%B1-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 166,
            "element_name": "Oriental Pearl Tower",
            "element_description": "Oriental Pearl Tower",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E4%B8%9C%E6%96%B9%E6%98%8E%E7%8F%A0-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.png?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E4%B8%9C%E6%96%B9%E6%98%8E%E7%8F%A0-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 165,
            "element_name": "Old Arcade",
            "element_description": "Old Arcade",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E6%97%A7%E6%B8%B8%E6%88%8F%E5%8E%85-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.png?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E6%97%A7%E6%B8%B8%E6%88%8F%E5%8E%85-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 164,
            "element_name": "Alien Surface",
            "element_description": "Alien Surface",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%A4%96%E6%98%9F%E5%9C%B0%E8%A1%A8-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.jpg?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%A4%96%E6%98%9F%E5%9C%B0%E8%A1%A8-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.jpg?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 163,
            "element_name": "Rainy City Street at Night",
            "element_description": "Rainy City Street at Night",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%9F%8E%E5%B8%82%E9%9B%A8%E5%A4%9C%E8%A1%97%E9%81%93-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.png?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%9F%8E%E5%B8%82%E9%9B%A8%E5%A4%9C%E8%A1%97%E9%81%93-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 162,
            "element_name": "Childhood Bedroom",
            "element_description": "Childhood Bedroom",
            "element_frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E7%AB%A5%E5%B9%B4%E5%8D%A7%E5%AE%A4-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.png?x-kcdn-pid=112452",
            "element_refer_list": [
                {
                    "image_url": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E7%AB%A5%E5%B9%B4%E5%8D%A7%E5%AE%A4-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.jpg?x-kcdn-pid=112452"
                }
            ],
            "owned_by": "kling",
            "tag_list": [
                {
                    "id": "o_106",
                    "name": "Scene",
                    "description": "None"
                }
            ]
        }
    ]
}

YutoAI © 2021-2026