主体（创建主体)
OpenAPI Specification
创建自定义主体：提交主体名称、图片等素材，返回主体标识，供视频生成时保持人物/物体一致性使用。
请求方式：POST
接口地址
text
https://api.allyang.cn/kling/v1/general/custom-elements
请求头
Authorization（可选）：鉴权头，使用控制台创建的令牌，格式为 Bearer + 令牌。（示例：Bearer {{YOUR_API_KEY}}）
请求参数（application/json）
element_name（string，必填）element_description（string，必填）element_frontal_image（string，必填）element_refer_list（array
请求示例
json
{
"element_name": "",
"element_description": "",
"element_frontal_image": "",
"element_refer_list": [
{}
]
}
返回字段
code（integer，必填）message（string，必填）request_id（string，必填）data（array
返回示例
json
{
"code": 0,
"message": "SUCCEED",
"request_id": "2cc4e73a-76a8-48ca-b510-eee57982f6b0",
"data": [
{
"element_id": 171,
"element_name": "天台",
"element_description": "天台",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
},
{
"element_id": 170,
"element_name": "雪地",
"element_description": "雪地",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
},
{
"element_id": 169,
"element_name": "宋代园林",
"element_description": "宋代园林",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
},
{
"element_id": 168,
"element_name": "咖啡店",
"element_description": "咖啡店",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
},
{
"element_id": 167,
"element_name": "雪山",
"element_description": "雪山",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
},
{
"element_id": 166,
"element_name": "东方明珠",
"element_description": "东方明珠",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
},
{
"element_id": 165,
"element_name": "旧游戏厅",
"element_description": "旧游戏厅",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
},
{
"element_id": 164,
"element_name": "外星地表",
"element_description": "外星地表",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
},
{
"element_id": 163,
"element_name": "城市雨夜街道",
"element_description": "城市雨夜街道",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
},
{
"element_id": 162,
"element_name": "童年卧室",
"element_description": "童年卧室",
"element_frontal_image": "https://example.com/…",
"element_refer_list": [
{
"image_url": "https://example.com/…"
}
],
"owned_by": "kling",
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
]
}
]
}
使用提示：素材需为公网可访问地址并满足格式要求；创建后可凭主体 ID 在生成接口中引用。