/kling/v1/general/advanced-custom-elements主体（新版本）
请求
/kling/v1/general/advanced-custom-elementsBody
必填Bodyobjectelement_namestring必填不能超过20个字符
element_descriptionstring必填不能超过100个字符
reference_typestring必填枚举值：video_refer、 image_refer video_refer: 视频角色主体，此时将参考element_video_list定义主体外表 image_refer: 多图主体，此时将参考element_image_list定义主体外表 通过视频定制的主体和通过图片定制的主体的可用范围不同，详见能力地图和参数说明。
element_image_listobject可通过多张图片设定主体及其细节
包括正面参考图和其他角度或特写参考图，其中：至少包括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_image_listobject可通过多张图片设定主体及其细节 包括正面参考图和其他角度或特写参考图，其中：至少包括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 时，当前参数必填
frontal_imagestringrefer_imagesarray<object>
refer_imagesarray<object>元素object
元素objectimage_urlstring必填element_video_listobject可通过视频设定主体及其细节
可上传有声视频，有声视频包含人声则触发音色定制（定制+入音色库+与主体绑定）
暂时仅支持通过视频定制写实风格的人形形象
参考视频时当前参数必填，参考图片时当前参数无效
用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_video_listobject可通过视频设定主体及其细节 可上传有声视频，有声视频包含人声则触发音色定制（定制+入音色库+与主体绑定） 暂时仅支持通过视频定制写实风格的人形形象 参考视频时当前参数必填，参考图片时当前参数无效 用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 及之后的模型
refer_videosarray<object>
refer_videosarray<object>元素object
元素objectvideo_urlstringelement_voice_idstring可绑定音色库中已有音色 当前参数为空时，当前主体不绑定音色 可通过音色相关API获取ID，点此查看 仅视频定制的主体支持绑定音色
tag_listarray<object>一个主体可以配置多个标签
用key:value承载。tag的ID与名称：o_101 热梗, o_102 人物, o_103 动物, o_104 道具, o_105 服饰, o_106 场景, o_107 特效, o_108 其他
tag_listarray<object>一个主体可以配置多个标签 用key:value承载。tag的ID与名称：o_101 热梗, o_102 人物, o_103 动物, o_104 道具, o_105 服饰, o_106 场景, o_107 特效, o_108 其他
元素object
元素objecttag_idstringcallback_urlstring本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知
external_task_idstring自定义任务ID。用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询。请注意，单用户下需要保证唯一性
路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Content-Type | Header | string | 否 | - | application/json |
Authorization | Header | string | 是 | 必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。 | Bearer YOUR_API_KEY |
返回响应 200
响应 200object