创建主体（新）
创建自定义主体，支持通过视频或图片设定主体及其细节。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
创建主体的模型名称，固定值：Custom-Elements。
显示子属性
隐藏子属性
主体名称，不超过20个字符。
主体描述，不超过100个字符。
主体参考方式。
video_refer：视频角色主体，参考element_video_list定义主体外表。image_refer：多图主体，参考element_image_list定义主体外表。
注：通过视频定制的主体和通过图片定制的主体的可用范围不同。
主体参考图，可通过多张图片设定主体及其细节，包括正面参考图和其他角度或特写参考图。
- 至少包括1张正面参考图，由
frontal_image参数定义。 - 需包括1～3张其他参考图，需与正面参考图有差异，由
image_url参数定义。 - 支持传入图片 Base64 编码或图片 URL（确保公网可访问）。
- 图片格式支持
.jpg/.jpeg/.png。 - 图片文件大小不超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 ~ 2.5:1 之间。
- 当
reference_type参数值为image_refer时，当前参数必填。
显示子属性
隐藏子属性
正面参考图 URL 或 Base64 编码。
其他角度或特写的参考图列表。数量限制：1～3 张。图片内容需与正面参考图存在视觉差异。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
参考图片 URL 或 Base64 编码。
主体参考视频配置。通过单段视频设定主体外貌及细节。
当 reference_type 值为 video_refer 时，此参数必填。
至多仅支持上传 1 段视频。
格式规格：仅支持 MP4/MOV 格式。必须为 1080P 分辨率，时长限制 3s～8s，宽高比例限定为 16:9 或 9:16，文件大小 ≤ 200MB。
当前仅支持定制写实风格的人形形象。若上传带有声视频且包含人声，将自动触发音色定制（定制入库并与当前主体绑定）。
通过视频定制的主体，仅支持用于 Qianfan-Video K 系列的 K30 和 K3.0 模型。
显示子属性
隐藏子属性
参考视频列表，至多上传 1 段视频。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
参考视频 URL，不得为空。
绑定音色的 ID。当前参数为空时，当前主体不绑定音色。仅视频定制的主体支持绑定音色。
为主体配置的标签列表，一个主体可以配置多个标签。标签 ID 与名称对应关系：
| ID | 名称 |
|---|---|
o_101 |
热梗 |
o_102 |
人物 |
o_103 |
动物 |
o_104 |
道具 |
o_105 |
服饰 |
o_106 |
场景 |
o_107 |
特效 |
o_108 |
其他 |
显示子属性
隐藏子属性
显示子属性
隐藏子属性
标签 ID，如 o_101。
POST /beta/aigc/generations/qianfan-elements HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "Custom-Elements",
"model_parameters": {
"element_name": "天台",
"element_description": "天台",
"reference_type": "image_refer",
"element_image_list": {
"frontal_image": "https://example.com/frontal.jpg",
"refer_images": [
{
"image_url": "https://example.com/refer1.png"
}
]
},
"tag_list": [
{
"tag_id": "o_101"
}
]
}
}示例代码
curl -X POST "https://qianfan.baidubce.com/beta/aigc/generations/qianfan-elements" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "Custom-Elements",
"model_parameters": {
"element_name": "天台",
"element_description": "天台",
"reference_type": "image_refer",
"element_image_list": {
"frontal_image": "https://p2-****.****ai.com/bs2/upload-ylab-stunt/element/%E5%A4%A9%E5%8F%B0-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.jpeg?x-kcdn-pid=112452",
"refer_images": [
{
"image_url": "https://p2-****.****ai.com/bs2/upload-ylab-stunt/element/%E5%A4%A9%E5%8F%B0-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
}
]
},
"tag_list": [
{
"tag_id": "o_106"
}
]
}
}'curl -X POST "https://qianfan.baidubce.com/beta/aigc/generations/qianfan-elements" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "Custom-Elements",
"model_parameters": {
"element_name": "我的角色",
"element_description": "写实风格人形角色",
"reference_type": "video_refer",
"element_video_list": {
"refer_videos": [
{
"video_url": "https://example.com/my_character.mp4"
}
]
},
"tag_list": [
{
"tag_id": "o_102"
}
]
}
}'返回响应
错误码，0 表示成功。
错误信息或状态描述。
请求唯一 ID，用于问题追踪。
详细信息。
显示子属性
隐藏子属性
任务 ID，由系统生成。
任务创建时的参数信息。
显示子属性
隐藏子属性
暂无参数
任务状态。可选值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）。
任务创建时间，Unix 时间戳，单位 ms。
任务更新时间，Unix 时间戳，单位 ms。
{
"code": 0,
"message": "",
"request_id": "*****",
"data": {
"task_id": "task_01",
"task_info": {},
"task_status": "submitted",
"created_at": 1718****4756,
"updated_at": 1718****4756
}
}评价此篇文章