POST/kling/v1/general/custom-elements

主体(旧)

API Key application/json

Request

请求

/kling/v1/general/custom-elements

Body

必填

Bodyobject

element_namestring必填

主体名称不能超过20个字符

element_descriptionstring必填

主体描述不能超过100个字符

element_frontal_imagestring必填

主体正面参考图支持传入图片Base64编码或图片URL（确保可访问）图片格式支持.jpg / .jpeg / .png 图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在1:2.5 ~ 2.5:1之间

element_refer_listarray<object>必填

主体其他参考列表可通过上传多张、不同角度的主体参考图来定义主体外观至少上传1张参考图，至多上传3张参考图用key:value承载，其中具体如下： 1 2 3 4 5 "element_refer_list":[ {"image_url":"image_url_1"}, {"image_url":"image_url_2"}, {"image_url":"image_url_3"} ]

元素object

image_urlstring必填

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	否	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl -X POST https://top.qingyuntop.ai/kling/v1/general/custom-elements \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "element_name": "",
  "element_description": "",
  "element_frontal_image": "",
  "element_refer_list": ""
}'

Response

返回响应 `200`

HTTP 响应

响应 200object