Skip to content
EN

主体(创建主体)

方法: POST路径: /kling/v1/general/custom-elements

官方文档: https://docs.qingque.cn/d/home/eZQCRUy_LWt70n5Wz2sTiLV6J?identityId=1oEFzU43FYK#section=h.jpo0r85p0amj

请求参数

Header 参数

text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

text
element_name
string
必需
element_description
string
必需
element_frontal_image
string
必需
element_refer_list
array
[object]
必需
示例
{
"element_name"
:
""
,
"element_description"
:
""
,
"element_frontal_image"
:
""
,
"element_refer_list"
:
[
{
}
]
}

请求示例代码

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": [
        {}
    ]
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

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

示例

json
{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "2cc4e73a-76a8-48ca-b510-eee57982f6b0",
    "data": [
        {
            "element_id": 171,
            "element_name": "天台",
            "element_description": "天台",
            "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": "场景",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 170,
            "element_name": "雪地",
            "element_description": "雪地",
            "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": "场景",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 169,
            "element_name": "宋代园林",
            "element_description": "宋代园林",
            "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": "场景",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 168,
            "element_name": "咖啡店",
            "element_description": "咖啡店",
            "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": "场景",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 167,
            "element_name": "雪山",
            "element_description": "雪山",
            "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": "场景",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 166,
            "element_name": "东方明珠",
            "element_description": "东方明珠",
            "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": "场景",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 165,
            "element_name": "旧游戏厅",
            "element_description": "旧游戏厅",
            "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": "场景",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 164,
            "element_name": "外星地表",
            "element_description": "外星地表",
            "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": "场景",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 163,
            "element_name": "城市雨夜街道",
            "element_description": "城市雨夜街道",
            "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": "场景",
                    "description": "None"
                }
            ]
        },
        {
            "element_id": 162,
            "element_name": "童年卧室",
            "element_description": "童年卧室",
            "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": "场景",
                    "description": "None"
                }
            ]
        }
    ]
}