主体(旧)

POSThttps://www.aipro2.com/kling/v1/general/custom-elements

Header 参数

• Content-Typestring
  请求体 Content-Type，一般为 application/json

  示例application/json
• Authorizationstring
  Bearer API Key

  示例Bearer {{YOUR_API_KEY}}

请求体参数

application/json

• element_description*string
  主体描述
  不能超过100个字符
• element_frontal_image*string
  主体正面参考图
  支持传入图片Base64编码或图片URL（确保可访问）
  图片格式支持.jpg / .jpeg / .png
  图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在1:2.5 ~ 2.5:1之间
• element_name*string
  主体名称
  不能超过20个字符
• element_refer_list*array<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"}
  ]

响应

application/json

无响应结构说明

请求体示例示例 1

1{2  "element_description": "",3  "element_frontal_image": "",4  "element_name": "",5  "element_refer_list": ""6}

代码示例cURLPythonJavaScriptGoPHP

1curl -X POST "https://www.aipro2.com/kling/v1/general/custom-elements" \2  -H "Authorization: Bearer <API Key>" \3  -H "Content-Type: application/json" \4  -d '{5    "element_description": "",6    "element_frontal_image": "",7    "element_name": "",8    "element_refer_list": ""9  }'

响应示例 · 200example

1{2  "code": 0,3  "data": {4    "task_id": "task_example_001"5  },6  "message": "success"7}