跳转到主要内容
自定义主体允许您将参考图片绑定为可复用的主体 ID，在 Kling 视频生成中引用。创建为异步任务——提交后请轮询查询接口，直到 task_status 为 succeed。

​
核心能力

  • 人物与场景主体 — 上传正面 + 侧面图片，构建可复用的角色或背景
  • 多种分类 — 支持人物、动物、道具、服饰、场景、特效等类型
  • 异步处理 — 创建在后台进行，使用 task_id 轮询状态

​
快速示例

curl https://www.anyfast.ai/kling/v1/general/advanced-custom-elements \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "element_name": "my-character",
    "element_description": "视频系列主角",
    "reference_type": "image_refer",
    "element_image_list": {
      "frontal_image": "https://example.com/frontal.jpg",
      "refer_images": [
        {"image_url": "https://example.com/side.jpg"}
      ]
    },
    "tag_list": [{"tag_id": "o_102"}]
  }'

​
请求参数

参数类型必填说明
element_namestring✅主体名称
element_descriptionstring✅主体描述
reference_typestring✅固定值 image_refer
element_image_list.frontal_imagestring✅正面参考图片 URL
element_image_list.refer_imagesarray✅其他参考图片数组，每项包含 image_url
tag_listarray✅标签列表，每项包含 tag_id

​
tag_id 可用值

tag_id标签名称
o_101热梗
o_102人物（Character）
o_103动物
o_104道具
o_105服饰
o_106场景（Scene）
o_107特效
o_108其他

​
返回结果

接口立即返回 task_id，请使用查询自定义主体轮询，直到 task_status 为 succeed。
字段说明
id / task_id任务 ID
object固定 video
model固定 kling-element
status初始为空
progress进度 0–100

API 参考

查看 Kling 创建自定义主体的交互式 API 文档。