`POST https://ark.cn-beijing.volcengineapi.com/?Action=ListAssetGroups&Version=2024-01-01`
查询符合筛选条件的Asset Groups（素材资产组合）列表。

```mixin-react
return (<Tabs>
<Tabs.TabPane title="快速入口" key="NdTz6AmVwP"><RenderMd content={`<span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_57d0bca8e0d122ab1191b40101b5df75.png =20x) </span> [调用教程](https://www.volcengine.com/docs/82379/2333565) <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f45b5cd5863d1eed3bc3c81b9af54407.png =20x) </span> [接口列表](https://www.volcengine.com/docs/82379/2318269) <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bef4bc3de3535ee19d0c5d6c37b0ffdd.png =20x) </span> [开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)
`}></RenderMd></Tabs.TabPane>
<Tabs.TabPane title="鉴权说明" key="jAo0Qz18Pr"><RenderMd content={`本接口仅支持 Access Key（AK/SK）鉴权。
`}></RenderMd></Tabs.TabPane></Tabs>);
```


---


<span id="request-params"></span>
## 请求参数
<span id="request-body"></span>
### 请求体

---


**Filter** `object` %%require%%
搜索的过滤条件。

属性
Filter.**GroupIds** `array`
Asset Group（素材资产组合）的 Id 列表。

---


Filter.**GroupType** `string` %%require%%
Asset Group（素材资产组合）的类型。可选值：

* `AIGC`：虚拟人像
* `LivenessFace`: 真人素材


---


Filter.**Name** `string`
Asset Group（素材资产组合）的名称，上限为 64 个字符。



---


**PageNumber** `integer (i64)` %%require%%
搜索页码，可用于列表分页功能，从 1 开始。例如："page_number": 1，即返回第一页的搜索结果。

---


**PageSize** `integer (i64)` %%require%%
每页搜索结果的数量，上限为 100。

---


**SortBy** `string`
用于排序的字段名称，默认值为 `CreateTime`。可选值：

* `CreateTime`：根据创建时间排序
* `UpdateTime`：根据更新时间排序


---


**SortOrder** `string`
排序顺序，默认值为 `Desc`。可选值：

* `Desc`：降序
* `Asc`：升序


---


**ProjectName** `string`
资源所属的项目名称，默认值为 default。
若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
<span id="response-params"></span>
## 响应参数

---


**TotalCount ** `int (i64)`
返回的 Asset Group（素材资产组合）的总数。

---


**Items** `array[] `
符合筛选条件的 Asset Group（素材资产组合）数组。

---


  Items.**Id** `string`
  Asset Group（素材资产组合）的 Id。

---


  Items.**Name** `string`
  Asset Group（素材资产组合）的名称，上限为64个字符。

---


  Items.**Description** `string`
  Asset Group（素材资产组合）的描述，上限为 300 字符。

---


  Items.**GroupType** `string`
  Asset Group（素材资产组合）的类型。

   * `AIGC`：虚拟人像。
   * `LivenessFace`: 真人素材


---


  Items.**ProjectName** `string`
  资源所属的项目名称。

---


  Items.**CreateTime** `string`
  创建时间。

---


  Items.**UpdateTime** `string`
  更新时间。

---


<span id="jb2Vro9B"></span>
### **PageNumber ** int (i64)
返回的页数。

---


<span id="r0oQyygI"></span>
### **PageSize ** int (i64)
每页搜索结果的数量，上限为100。

---


<span id=".6K-35rGC56S65L6L"></span>
## 请求示例
```text
POST /?Action=ListAssetGroups&Version=2024-01-01 HTTP/1.1
Host: ark.cn-beijing.volcengineapi.com
Content-Type: application/json
X-Date: 20260328T000000Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=AKLTYz******/20260328/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=47a7d934******e41085f

{
  "Filter": {
    "Name": "test",
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc",
  "ProjectName": "default"
}
```

<span id=".5ZON5bqU56S65L6L"></span>
## 响应示例
```json
{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "TotalCount": 1,
    "Items": [
      {
        "Id": "group-2026**********-*****",
        "Name": "test",
        "Title": "test",
        "Description": "test",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-03-28T00:00:00Z",
        "UpdateTime": "2026-03-28T00:00:00Z"
      }
    ],
    "PageNumber": 1,
    "PageSize": 10
  }
}
```



