> ## Documentation Index
> Fetch the complete documentation index at: https://docs-vip.apigo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ListAssetGroups

> 按条件查询素材组列表。

```text theme={null}
POST {BaseUrl}/?Action=ListAssetGroups&Version=2024-01-01
Content-Type: application/json
```

请求需使用 HMAC-SHA256 签名，见[鉴权与通用约定](https://docs-vip.apigo.ai/api-reference/endpoints/seedance/asset-overview.md#鉴权)。

## 请求参数

**Filter** `object` *required*

筛选条件。

**属性**

**GroupType** `string` *required*

素材组类型：`AIGC`（普通素材组）或 `LivenessFace`（[真人素材组](https://docs-vip.apigo.ai/api-reference/endpoints/seedance/asset-overview.md#真人素材)）。

**GroupIds** `string[]`

按素材组 ID 筛选。

**Name** `string`

按名称模糊匹配。

**SortBy** `string` (default: CreateTime)

排序字段：`CreateTime` 或 `UpdateTime`。

**SortOrder** `string` (default: Desc)

排序方向：`Asc` 或 `Desc`。

**MaxResults** `integer` (default: 10)

NextToken 分页的每页条数，1–100。

**NextToken** `string`

NextToken 分页的翻页凭证，首次请求不传。

**PageNumber** `integer`

页码分页的页码，从 1 开始，需与 `PageSize` 同时传。

**PageSize** `integer`

页码分页的每页条数，1–100。`PageNumber × PageSize` 不能超过 10000。

**ProjectName** `string`

可传 `default` 或不传。

两种分页方式的规则见[分页](https://docs-vip.apigo.ai/api-reference/endpoints/seedance/asset-overview.md#分页)。

## 响应参数

**Result.Items** `object[]`

素材组列表，字段同 [GetAssetGroup](https://docs-vip.apigo.ai/api-reference/endpoints/seedance/get-asset-group.md) 的 `Result`。无匹配时为空数组。

**Result.NextToken** `string`

下一页凭证，仅 NextToken 分页且存在下一页时返回。

**Result.TotalCount** `integer`

符合条件的总数，仅页码分页返回。

**Result.PageNumber** `integer`

当前页码，仅页码分页返回。

**Result.PageSize** `integer`

每页条数，仅页码分页返回。

```json NextToken 分页 theme={null}
{
  "Filter": {
    "GroupType": "AIGC",
    "Name": "product"
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}
```

```json 页码分页 theme={null}
{
  "Filter": {
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}
```

```json NextToken 分页 theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [
      {
        "Id": "group-20261020080000-abcde",
        "Name": "product-assets",
        "Description": "产品广告参考素材",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-10-20T08:00:00Z",
        "UpdateTime": "2026-10-20T08:00:00Z"
      }
    ],
    "NextToken": "Q3JlYXRlVGltZToxNzkyMzk2ODAw"
  }
}
```

```json 页码分页 theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [],
    "TotalCount": 0,
    "PageNumber": 1,
    "PageSize": 10
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.