> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdn-fly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling 创建自定义主体

> 创建自定义主体（人物、场景、道具、服饰等），用于 Kling 视频生成。

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

## 核心能力

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

## 快速示例

```bash cURL theme={null}
curl https://dayu.cdn-fly.com/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"}]
  }'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://dayu.cdn-fly.com/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"}]
    }
)

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

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `element_name` | string | ✅ | 主体名称 |
| `element_description` | string | ✅ | 主体描述 |
| `reference_type` | string | ✅ | 固定值 `image_refer` |
| `element_image_list.frontal_image` | string | ✅ | 正面参考图片 URL |
| `element_image_list.refer_images` | array | ✅ | 其他参考图片数组，每项包含 `image_url` |
| `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` | 其他 |

## 返回结果

接口立即返回 `task_id`，请使用[查询自定义主体](/zh/guides/model-api/kuaishou/kling-element-query)轮询，直到 `task_status` 为 `succeed`。

| 字段 | 说明 |
| - | - |
| `id` / `task_id` | 任务 ID |
| `object` | 固定 `video` |
| `model` | 固定 `kling-element` |
| `status` | 初始为空 |
| `progress` | 进度 0–100 |

> **[API 参考](/zh/api-reference/model-api/kuaishou/kling-element-create)**
>
> 查看 Kling 创建自定义主体的交互式 API 文档。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.