{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/tmmeivqiv","result":{"data":{"markdownRemark":{"html":"\n
\n
\n
\n
\n
GET
\n
\nhttps://qianfan.baidubce.com/beta/aigc/generations/qianfan-presets-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
Query 参数
\n
\n
\n
\n
\n
\n\npageNum\n\ninteger\n
\n

页码，取值范围：[1, 1000]。

\n
\n
可选
\n
\n
\n
\n\npageSize\n\ninteger\n
\n

每页数据量，取值范围：[1, 500]。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
GET /beta/aigc/generations/qianfan-presets-elements?pageNum=1&pageSize=20 HTTP/1.1\nHOST: qianfan.baidubce.com\nAuthorization: Bearer <API Key>
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n\n
\n
\n
\n
请求示例
\n\n
\n
\n\n
\n
curl -X GET \"https://qianfan.baidubce.com/beta/aigc/generations/qianfan-presets-elements?pageNum=1&pageSize=20\" \\\n  -H \"Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408\"
\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

错误码，0 表示成功。

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

错误信息。

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

请求 ID，用于问题追踪。

\n
\n
可选
\n
\n
\n
\n\ndata\n\narray\n
\n

元素列表数据。

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nobject {7}\n
\n
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nelement_id\n\ninteger\n
\n

元素唯一 ID。

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

元素名称。

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

元素描述。

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

元素正面展示图 URL。

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

元素参考图片列表。

\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

参考图片 URL。

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

元素标签列表。

\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。

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

标签名称。

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

标签描述。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\nowned_by\n\nstring\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  \"code\": 0,\n  \"message\": \"success\",\n  \"request_id\": \"abc123xyz\",\n  \"data\": [\n    {\n      \"element_id\": 1001,\n      \"element_name\": \"示例元素\",\n      \"element_description\": \"这是一个示例预置元素\",\n      \"element_frontal_image\": \"https://example.com/images/element_frontal.jpg\",\n      \"element_refer_list\": [\n        {\n          \"image_url\": \"https://example.com/images/ref1.jpg\"\n        },\n        {\n          \"image_url\": \"https://example.com/images/ref2.jpg\"\n        }\n      ],\n      \"tag_list\": [\n        {\n          \"id\": \"tag_001\",\n          \"name\": \"人物\",\n          \"description\": \"人物类标签\"\n        }\n      ],\n      \"owned_by\": \"system\"\n    }\n  ]\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
","fields":{"slug":"tmmeivqiv","title":"查询预置主体列表","date":"2026-03-06","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"tmmeivqiv","prev":null,"next":null,"parents":[]}}}