查询素材资产组合列表
更新时间：2026-07-27
POST
https://qianfan.baidubce.com/beta/aigc/generations/qianfan-assets-group/list
查询符合筛选条件的素材资产组合列表。支持按素材资产组合 Id、类型、名称筛选，支持分页和排序。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
Filter
object {3}
搜索的过滤条件。
必选
显示子属性
隐藏子属性
Name
string
Asset Group（素材资产组合）的名称，上限为 64 个字符。
可选
GroupIds
array
Asset Group（素材资产组合）的 Id 列表。
可选
显示子属性
隐藏子属性
items
string
GroupType
string
Asset Group（素材资产组合）的类型。可选值：AIGC：虚拟人像LivenessFace：真人素材
必选
PageNumber
integer
搜索页码，列表分页
必选
PageSize
integer
每页展示数量，上限为 100
必选
SortBy
string
排序字段。可选值：CreateTime：根据创建时间排序UpdateTime：根据更新时间排序
可选
SortOrder
string
排序顺序。默认降序（Desc），可选升序（Asc）
可选
请求结构
POST /beta/aigc/generations/qianfan-assets-group/list HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"Filter": {
"GroupType": "AIGC"
},
"PageNumber": 1,
"PageSize": 10
}示例代码
curl
curl -X POST "https://qianfan.baidubce.com/beta/aigc/generations/qianfan-assets-group/list" \
-H "Authorization: Bearer bce-v3/ALTAK-*************eb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"Filter": {
"GroupType": "AIGC"
},
"PageNumber": 1,
"PageSize": 10
}'curl -X POST "https://qianfan.baidubce.com/beta/aigc/generations/qianfan-assets-group/list" \
-H "Authorization: Bearer bce-v3/ALTAK-*************eb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"Filter": {
"GroupIds": ["6a54c458e59cfce7a6fd7b66"],
"GroupType": "AIGC"
},
"PageNumber": 1,
"PageSize": 10
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
field
object {4}
可选
显示子属性
隐藏子属性
code
integer
错误码，0 表示操作成功
可选
message
string
请求结果信息，成功时为 success
可选
request_id
string
本次请求的 ID
可选
result
object {4}
查询结果对象
可选
显示子属性
隐藏子属性
Items
array
符合筛选条件的素材资产组合列表
可选
显示子属性
隐藏子属性
items
object {6}
显示子属性
隐藏子属性
Id
string
素材资产组合的 Id
可选
Name
string
素材资产组合名称，上限为 64 个字符
可选
GroupType
string
素材资产组合的类型
可选
CreateTime
string
创建时间（UTC 时间，格式如 2026-07-15T04:43:26Z）
可选
UpdateTime
string
更新时间（UTC 时间，格式如 2026-07-15T04:45:13Z）
可选
Description
string
素材资产组合描述，上限为 300 字符
可选
PageSize
integer
每页展示数量，上限为 100
可选
PageNumber
integer
搜索页码，列表分页
可选
TotalCount
integer
返回的素材资产组合总数
可选
响应示例
{
"code": 0,
"message": "success",
"request_id": "as-he2dekpgd6",
"result": {
"TotalCount": 2,
"Items": [
{
"Id": "6a570feea3a97258df4144b8",
"Name": "0714testGroup-1134",
"Description": "test",
"GroupType": "AIGC",
"CreateTime": "2026-07-15T04:43:26Z",
"UpdateTime": "2026-07-15T04:45:13Z"
},
{
"Id": "6a54c458e59cfce7a6fd7b66",
"Name": "0713testGroup-02",
"Description": "",
"GroupType": "AIGC",
"CreateTime": "2026-07-13T10:56:24Z",
"UpdateTime": "2026-07-13T10:56:24Z"
}
],
"PageNumber": 1,
"PageSize": 10
}
}评价此篇文章