`POST https://ark.cn-beijing.volcengineapi.com/?Action=ListAssetGroups&Version=2024-01-01` 查询符合筛选条件的Asset Groups（素材资产组合）列表。快速入口 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_57d0bca8e0d122ab1191b40101b5df75.png) [调用教程](https://www.volcengine.com/docs/82379/2333565) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f45b5cd5863d1eed3bc3c81b9af54407.png) [接口列表](https://www.volcengine.com/docs/82379/2333565) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bef4bc3de3535ee19d0c5d6c37b0ffdd.png) [开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false) 鉴权说明本接口仅支持 Access Key（AK/SK）鉴权。 --- ## 请求参数 ### 请求体 --- **Filter** `object` 必选搜索的过滤条件。属性 Filter.**GroupIds** `array` Asset Group（素材资产组合）的 Id 列表。 --- Filter.**GroupType** `string` 必选 Asset Group（素材资产组合）的类型。可选值： * `AIGC`：虚拟人像 * `LivenessFace`: 真人素材 --- Filter.**Name** `string` Asset Group（素材资产组合）的名称，上限为 64 个字符。 --- **PageNumber** `integer (i64)` 必选搜索页码，可用于列表分页功能，从 1 开始。例如："page_number": 1，即返回第一页的搜索结果。 --- **PageSize** `integer (i64)` 必选每页搜索结果的数量，上限为 100。 --- **SortBy** `string` 用于排序的字段名称，默认值为 `CreateTime`。可选值： * `CreateTime`：根据创建时间排序 * `UpdateTime`：根据更新时间排序 --- **SortOrder** `string` 排序顺序，默认值为 `Desc`。可选值： * `Desc`：降序 * `Asc`：升序 --- **ProjectName** `string` 资源所属的项目名称，默认值为 default。若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。 ## 响应参数 --- **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` 更新时间。 --- ### **PageNumber ** int (i64) 返回的页数。 --- ### **PageSize ** int (i64) 每页搜索结果的数量，上限为100。 --- ## 请求示例 ```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" } ``` ## 响应示例 ```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 } } ```

火山方舟