创建主体
创建自定义主体,上传主体名称、描述及参考图片,返回主体唯一标识及详情信息。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
element_name:主体名称,不能超过20个字符。
element_description:主体描述,不能超过100个字符。
element_frontal_image:主体正面参考图,支持传入图片Base64编码或图片URL(确保可访问)。图片格式支持 .jpg / .jpeg / .png,图片文件大小不能超过10MB,图片宽高尺寸不小于300px,图片宽高比要在1:2.5 ~ 2.5:1之间。
element_refer_list:主体其他参考图列表,可通过上传多张、不同角度的主体参考图来定义主体外观。至少上传1张参考图,至多上传3张参考图。格式示例:"element_refer_list":[{"image_url":"image_url_1"},{"image_url":"image_url_2"},{"image_url":"image_url_3"}]
显示子属性
隐藏子属性
显示子属性
隐藏子属性
image_url:参考图片的URL地址。
tag_list:为主体配置的标签列表,一个主体可以配置多个标签。格式示例:"tag_list": [{"tag_id": "o_101"}, {"tag_id": "o_102"}]
显示子属性
隐藏子属性
显示子属性
隐藏子属性
tag_id:标签ID。可选值:o_101(热梗)、o_102(人物)、o_103(动物)、o_104(道具)、o_105(服饰)、o_106(场景)、o_107(特效)、o_108(其他)。
POST /beta/aigc/qianfan-custom-elements HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"element_name": "示例主体",
"element_description": "这是一个示例主体的描述",
"element_frontal_image": "https://example.com/image.jpg",
"element_refer_list": [
{
"image_url": "image_url_1"
}
],
"tag_list": [
{
"tag_id": "o_101"
}
]
}
示例代码
curl -X POST "https://qianfan.baidubce.com/beta/aigc/qianfan-custom-elements" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"element_name": "示例主体",
"element_description": "这是一个示例主体的描述",
"element_frontal_image": "https://example.com/image.jpg",
"element_refer_list": [
{
"image_url": "image_url_1"
}
],
"tag_list": [
{
"tag_id": "o_101"
}
]
}'
返回响应
code:错误码,0 表示成功。
message:错误信息或状态描述。
request_id:请求唯一ID,用于问题追踪。
data:元素详情数据。
显示子属性
隐藏子属性
element_id:元素唯一ID。
element_name:元素名称。
element_description:元素描述说明。
element_frontal_image:元素正面展示图URL。
element_refer_list:元素参考图列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
image_url:参考图片URL。
tag_list:元素标签信息列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
id:标签ID。
name:标签名称。
description:标签描述。
owned_by:元素来源标识。
{
"code": 0,
"message": "success",
"request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"data": {
"element_id": 123456789,
"element_name": "示例主体",
"element_description": "这是一个示例主体的描述",
"element_frontal_image": "https://example.com/image.jpg",
"element_refer_list": [
{
"image_url": "https://example.com/refer_image_1.jpg"
}
],
"tag_list": [
{
"id": "o_101",
"name": "热梗",
"description": "热梗类标签"
}
],
"owned_by": "user"
}
}
标签ID说明
| 标签ID | 标签名称 |
|---|---|
| o_101 | 热梗 |
| o_102 | 人物 |
| o_103 | 动物 |
| o_104 | 道具 |
| o_105 | 服饰 |
| o_106 | 场景 |
| o_107 | 特效 |
| o_108 | 其他 |
评价此篇文章
