查询预置主体列表（新）
更新时间：2026-03-13
GET
https://qianfan.baidubce.com/beta/aigc/generations/qianfan-elements?model={model}&pageNum={pageNum}&pageSize={pageSize}
查询预置主体列表，返回指定模型下的主体信息及相关配置。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
model
string
查询预置主体列表，固定值：Presets-Elements。
必选
pageNum
integer
页码，取值范围：[1, 1000]，默认值：1。
可选
pageSize
integer
每页数据量，取值范围：[1, 500]，默认值：30。
可选
请求结构
GET /beta/aigc/generations/qianfan-elements?model=Presets-Elements&pageNum={pageNum}&pageSize={pageSize} HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>示例代码
curl
curl -X GET "https://qianfan.baidubce.com/beta/aigc/generations/qianfan-elements?model=Presets-Elements&pageNum=1&pageSize=30" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码，0 表示成功
必选
message
string
错误信息
必选
request_id
string
请求 ID，用于问题追踪
必选
data
array
元素列表数据
必选
显示子属性
隐藏子属性
items
object {6}
显示子属性
隐藏子属性
task_id
string
任务ID，系统生成
必选
created_at
integer
任务创建时间，Unix时间戳、单位ms
必选
updated_at
integer
任务更新时间，Unix时间戳、单位ms
必选
task_result
object {1}
任务成功后返回的结果对象
必选
显示子属性
隐藏子属性
elements
array
主体结果列表
必选
显示子属性
隐藏子属性
items
object {9}
显示子属性
隐藏子属性
tag_list
array
标签列表
必选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
id
string
标签ID
必选
name
string
标签名称
必选
description
string
标签描述
可选
element_id
integer
主体ID
必选
element_name
string
主体名称
必选
element_type
string
主体参考方式
必选
element_image_list
object {2}
图片参考配置信息
必选
显示子属性
隐藏子属性
refer_images
array
其他参考图列表
可选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
image_url
string
参考图片URL
必选
frontal_image
string
正面参考图
必选
element_video_list
object {1}
视频参考配置信息
必选
显示子属性
隐藏子属性
refer_videos
array
参考视频列表
必选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
video_url
string
参考视频URL
必选
element_voice_info
object {3}
音色绑定信息
必选
显示子属性
隐藏子属性
voice_id
string
定制的音色的ID；全局唯一
必选
trial_url
string
定制的音色的试听音频下载URL
可选
voice_name
string
定制的音色的名称
可选
element_description
string
主体描述
必选
status
string
主体状态，正常时为succeed，已被删除时为 deleted
必选
task_status
string
任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
必选
task_status_msg
string
任务状态信息，当任务失败时展示失败原因
必选
返回示例
{
"code": 0,
"message": "success",
"request_id": "your_request_id",
"data": [
{
"task_id": "your_task_id",
"task_status": "succeed",
"task_status_msg": "",
"task_info": {},
"task_result": {
"elements": [
{
"element_id": 171,
"element_name": "示例主体",
"element_description": "这是一个示例主体描述",
"element_image_list": {
"frontal_image": "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/kling/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-kling.klingai.com/bs2/upload-ylab-stunt/kling/element/%E5%A4%A9%E5%8F%B0-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
}
]
},
"element_video_list": {
"refer_videos": null
},
"element_voice_id": "",
"element_voice_info": {},
"element_type": "image_refer",
"tag_list": [
{
"id": "tag-001",
"name": "标签名称",
"description": "标签描述"
}
],
"status": "succeed"
}
]
},
"created_at": 0,
"updated_at": 0
}
]
}评价此篇文章