主体（新版本）

接口: POST https://4zapi.com/kling/v1/general/advanced-custom-elements

参数

Content-Type (header, string): 请求体 Content-Type，一般为 application/json
Authorization (header, string): Bearer API Key

请求体 (application/json)

element_description (string, 必填): 不能超过100个字符
element_name (string, 必填): 不能超过20个字符
reference_type (string, 必填): 枚举值：video_refer、 image_refer video_refer: 视频角色主体，此时将参考element_video_list定义主体外表 image_refer: 多图主体，此时将参考element_image_list定义主体外表通过视频定制的主体和通过图片定制的主体的可用范围不同，详见能力地图和参数说明。
callback_url (string): 本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知
element_image_list (object): 可通过多张图片设定主体及其细节包括正面参考图和其他角度或特写参考图，其中：至少包括1张正面参考图，由frontal_image参数定义；需包括1～3张其他参考图，需与正面参考图有差异，由image_url参数定义用key:value承载，如下： "element_image_list": { "frontal_image": "image_url_0", "refer_images": [{ "image_url": "image_url_1" }, ...] } 支持传入图片Base64编码或图片URL（确保可访问）图片格式支持.jpg / .jpeg / .png。图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在1:2.5 ~ 2.5:1之间 reference_type参数值为 image_refer 时，当前参数必填
element_video_list (object): 可通过视频设定主体及其细节可上传有声视频，有声视频包含人声则触发音色定制（定制+入音色库+与主体绑定）暂时仅支持通过视频定制写实风格的人形形象参考视频时当前参数必填，参考图片时当前参数无效用key:value承载。视频格式仅支持MP4/MOV。仅支持时长介于3s～8s之间、宽高比例需为16:9或9:16的1080P视频。至多仅支持上传1段视频，视频大小不超过200MB。video_url参数值不得为空 "element_video_list": { "refer_videos": [{ "video_url": "video_url_1" }, ...] } 视频定制的主体仅支持用于 kling-video-o3 及之后的模型
element_voice_id (string): 可绑定音色库中已有音色当前参数为空时，当前主体不绑定音色可通过音色相关API获取ID，点此查看仅视频定制的主体支持绑定音色
external_task_id (string): 自定义任务ID。用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询。请注意，单用户下需要保证唯一性
tag_list (array<object>): 一个主体可以配置多个标签用key:value承载。tag的ID与名称：o_101 热梗, o_102 人物, o_103 动物, o_104 道具, o_105 服饰, o_106 场景, o_107 特效, o_108 其他

请求示例

{
  "element_description": "测试",
  "element_image_list": {
    "frontal_image": "https://imageproxy.zhongzhuan.chat/api/proxy/image/bb9bd34363da4fa486c9e645a6b1349e.png",
    "refer_images": [
      {
        "image_url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/bb9bd34363da4fa486c9e645a6b1349e.png"
      }
    ]
  },
  "element_name": "主体ysh11112311213",
  "reference_type": "image_refer"
}