查询预置主体列表
更新时间：2026-03-06
GET
https://qianfan.baidubce.com/beta/aigc/generations/qianfan-presets-elements
查询预置主体列表，返回分页的预置元素数据，包含元素名称、描述、展示图及标签等信息。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
pageNum
integer
页码，取值范围：[1, 1000]。
可选
pageSize
integer
每页数据量，取值范围：[1, 500]。
可选
请求结构
GET /beta/aigc/generations/qianfan-presets-elements?pageNum=1&pageSize=20 HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>示例代码
请求示例
curl -X GET "https://qianfan.baidubce.com/beta/aigc/generations/qianfan-presets-elements?pageNum=1&pageSize=20" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码，0 表示成功。
可选
message
string
错误信息。
可选
request_id
string
请求 ID，用于问题追踪。
可选
data
array
元素列表数据。
可选
显示子属性
隐藏子属性
items
object {7}
显示子属性
隐藏子属性
element_id
integer
元素唯一 ID。
可选
element_name
string
元素名称。
可选
element_description
string
元素描述。
可选
element_frontal_image
string
元素正面展示图 URL。
可选
element_refer_list
array
元素参考图片列表。
可选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
image_url
string
参考图片 URL。
可选
tag_list
array
元素标签列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
id
string
标签 ID。
可选
name
string
标签名称。
可选
description
string
标签描述。
可选
owned_by
string
元素来源。
可选
返回示例
{
"code": 0,
"message": "success",
"request_id": "abc123xyz",
"data": [
{
"element_id": 1001,
"element_name": "示例元素",
"element_description": "这是一个示例预置元素",
"element_frontal_image": "https://example.com/images/element_frontal.jpg",
"element_refer_list": [
{
"image_url": "https://example.com/images/ref1.jpg"
},
{
"image_url": "https://example.com/images/ref2.jpg"
}
],
"tag_list": [
{
"id": "tag_001",
"name": "人物",
"description": "人物类标签"
}
],
"owned_by": "system"
}
]
}评价此篇文章