创建主体

POST

/kling/v1/general/advanced-custom-elements

创建自定义主体，用于后续视频生成等能力。

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

不能超过20个字符

不能超过100个字符

枚举值：video_refer、image_refer

• video_refer：视频角色主体，参考 element_video_list 定义主体外表
• image_refer：多图主体，参考 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 时，当前参数必填。

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 及之后的模型。

可绑定音色库中已有音色。

当前参数为空时，当前主体不绑定音色。

可通过音色相关 API 获取 ID。

仅视频定制的主体支持绑定音色。

object[]

一个主体可以配置多个标签。

用 key:value 承载。tag 的 ID 与名称：o_101 热梗, o_102 人物, o_103 动物, o_104 道具, o_105 服饰, o_106 场景, o_107 特效, o_108 其他

本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知。

自定义任务 ID。用户自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询。请注意，单用户下需要保证唯一性。