POST https://art-api.yuyuflow.com/?Action=ListAssetGroups&Version=2024-01-01

查询符合筛选条件的Asset Groups（素材资产组合）列表。

鉴权说明

本接口仅支持 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。

若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 文档。

响应参数​

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 integer (i64)

返回的页数。

PageSize integer (i64)

每页搜索结果的数量，上限为100。

请求示例​

POST /?Action=ListAssetGroups&Version=2024-01-01 HTTP/1.1
Host: art-api.yuyuflow.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"
}

响应示例​

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "TotalCount": 1,
    "Items": [
      {
        "Id": "group-2026**********-*****",
        "Name": "test",
        "Description": "test",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-03-28T00:00:00Z",
        "UpdateTime": "2026-03-28T00:00:00Z"
      }
    ],
    "PageNumber": 1,
    "PageSize": 10
  }
}