{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/Tmmej4qzu","result":{"data":{"markdownRemark":{"html":"\n
\n
\n
\n
\n
POST
\n
\nhttps://qianfan.baidubce.com/beta/aigc/qianfan-custom-elements\n
\n
\n
\n

创建自定义主体，上传主体名称、描述及参考图片，返回主体唯一标识及详情信息。

\n
\n
\n

权限说明

\n

调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。

\n
\n
\n

请求参数

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
Body 参数
\n
\n
\n
\n
\n
\n\nelement_name\n\nstring\n
\n

element_name：主体名称，不能超过20个字符。

\n
\n
必选
\n
\n
\n
\n\nelement_description\n\nstring\n
\n

element_description：主体描述，不能超过100个字符。

\n
\n
必选
\n
\n
\n
\n\nelement_frontal_image\n\nstring\n
\n

element_frontal_image：主体正面参考图，支持传入图片Base64编码或图片URL（确保可访问）。图片格式支持 .jpg / .jpeg / .png，图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在1:2.5 ~ 2.5:1之间。

\n
\n
必选
\n
\n
\n
\n\nelement_refer_list\n\narray\n
\n

element_refer_list：主体其他参考图列表，可通过上传多张、不同角度的主体参考图来定义主体外观。至少上传1张参考图，至多上传3张参考图。格式示例：\"element_refer_list\":[{\"image_url\":\"image_url_1\"},{\"image_url\":\"image_url_2\"},{\"image_url\":\"image_url_3\"}]

\n
\n
必选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nobject {1}\n
\n
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nimage_url\n\nstring\n
\n

image_url：参考图片的URL地址。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\ntag_list\n\narray\n
\n

tag_list：为主体配置的标签列表，一个主体可以配置多个标签。格式示例：\"tag_list\": [{\"tag_id\": \"o_101\"}, {\"tag_id\": \"o_102\"}]

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nobject {1}\n
\n
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\ntag_id\n\nstring\n
\n

tag_id：标签ID。可选值：o_101（热梗）、o_102（人物）、o_103（动物）、o_104（道具）、o_105（服饰）、o_106（场景）、o_107（特效）、o_108（其他）。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
POST /beta/aigc/qianfan-custom-elements HTTP/1.1\nHOST: qianfan.baidubce.com\nAuthorization: Bearer <API Key>\nContent-Type: application/json\n{\n  \"element_name\": \"示例主体\",\n  \"element_description\": \"这是一个示例主体的描述\",\n  \"element_frontal_image\": \"https://example.com/image.jpg\",\n  \"element_refer_list\": [\n    {\n      \"image_url\": \"image_url_1\"\n    }\n  ],\n  \"tag_list\": [\n    {\n      \"tag_id\": \"o_101\"\n    }\n  ]\n}
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n\n
\n
\n
\n
基础调用
\n\n
\n
\n\n
\n
curl -X POST \"https://qianfan.baidubce.com/beta/aigc/qianfan-custom-elements\" \\\n  -H \"Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"element_name\": \"示例主体\",\n    \"element_description\": \"这是一个示例主体的描述\",\n    \"element_frontal_image\": \"https://example.com/image.jpg\",\n    \"element_refer_list\": [\n      {\n        \"image_url\": \"image_url_1\"\n      }\n    ],\n    \"tag_list\": [\n      {\n        \"tag_id\": \"o_101\"\n      }\n    ]\n  }'
\n
\n
\n
\n
\n
\n
\n
\n

返回响应

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
返回参数
\n
\n
\n
\n
\n
\n\ncode\n\ninteger\n
\n

code：错误码，0 表示成功。

\n
\n
可选
\n
\n
\n
\n\nmessage\n\nstring\n
\n

message：错误信息或状态描述。

\n
\n
可选
\n
\n
\n
\n\nrequest_id\n\nstring\n
\n

request_id：请求唯一ID，用于问题追踪。

\n
\n
可选
\n
\n
\n
\n\ndata\n\nobject {7}\n
\n

data：元素详情数据。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nelement_id\n\ninteger\n
\n

element_id：元素唯一ID。

\n
\n
可选
\n
\n
\n
\n\nelement_name\n\nstring\n
\n

element_name：元素名称。

\n
\n
可选
\n
\n
\n
\n\nelement_description\n\nstring\n
\n

element_description：元素描述说明。

\n
\n
可选
\n
\n
\n
\n\nelement_frontal_image\n\nstring\n
\n

element_frontal_image：元素正面展示图URL。

\n
\n
可选
\n
\n
\n
\n\nelement_refer_list\n\narray\n
\n

element_refer_list：元素参考图列表。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nobject {1}\n
\n
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nimage_url\n\nstring\n
\n

image_url：参考图片URL。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\ntag_list\n\narray\n
\n

tag_list：元素标签信息列表。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nobject {3}\n
\n
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nid\n\nstring\n
\n

id：标签ID。

\n
\n
可选
\n
\n
\n
\n\nname\n\nstring\n
\n

name：标签名称。

\n
\n
可选
\n
\n
\n
\n\ndescription\n\nstring\n
\n

description：标签描述。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\nowned_by\n\nstring\n
\n

owned_by：元素来源标识。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\n
\n
\n
\n
返回示例
\n\n
\n
\n\n
\n
{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"request_id\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n  \"data\": {\n    \"element_id\": 123456789,\n    \"element_name\": \"示例主体\",\n    \"element_description\": \"这是一个示例主体的描述\",\n    \"element_frontal_image\": \"https://example.com/image.jpg\",\n    \"element_refer_list\": [\n      {\n        \"image_url\": \"https://example.com/refer_image_1.jpg\"\n      }\n    ],\n    \"tag_list\": [\n      {\n        \"id\": \"o_101\",\n        \"name\": \"热梗\",\n        \"description\": \"热梗类标签\"\n      }\n    ],\n    \"owned_by\": \"user\"\n  }\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

标签ID说明

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
标签ID标签名称
o_101热梗
o_102人物
o_103动物
o_104道具
o_105服饰
o_106场景
o_107特效
o_108其他
\n
\n
","fields":{"slug":"Tmmej4qzu","title":"创建主体","date":"2026-03-06","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2},{"value":"标签ID说明","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Tmmej4qzu","prev":null,"next":null,"parents":[]}}}