Kling 创建自定义主体 - AnyFast

通过参考图片或一段参考视频创建可复用主体。创建接口返回任务 ID；轮询至 task_status 为 succeed 后，从结果中取得可用于视频请求的 element_id。

核心能力

图片或视频参考 — 使用多张图片或一段参考视频定义主体
多种分类 — 支持人物、动物、道具、服饰、场景、特效等类型
异步返回 — 使用任务 ID 查询最终 element_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"}]
  }'

import requests

response = requests.post(
    "https://www.anyfast.ai/kling/v1/general/advanced-custom-elements",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "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"}]
    }
)

print(f"Task ID: {response.json()['task_id']}")

请求参数

参数	类型	必填	说明
`element_name`	string	是	主体名称，最长 20 个字符
`element_description`	string	是	主体描述，最长 100 个字符
`reference_type`	string	是	`image_refer` 或 `video_refer`
`element_image_list`	object	图片主体时	`frontal_image` 和 1–3 个 `refer_images`
`element_video_list`	object	视频主体时	一个包含 `video_url` 的 `refer_videos` 项
`element_voice_id`	string	否	绑定到兼容主体的已有音色 ID
`tag_list`	array	否	标签列表，每项包含 `tag_id`

tag_id 可用值

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

返回结果

创建响应返回 id、task_id、model: "kling-element"、status、progress 和 created_at。随后调用 GET /kling/v1/general/advanced-custom-elements/{task_id} 查询结果。

字段	说明
`data.task_status`	`submitted`、`processing`、`succeed` 或 `failed`
`data.task_result.elements[].element_id`	视频请求使用的主体 ID
`data.task_result.elements[].element_image_list`	处理后的图片参考信息
`data.task_result.elements[].element_video_list`	处理后的视频参考信息
`data.task_result.elements[].element_voice_info`	已绑定的音色信息（如有）

API 参考

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