ListAssetGroups

{
  "Filter": {
    "GroupType": "AIGC",
    "Name": "product"
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}

{
  "Filter": {
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

{
  "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": "Reference assets for product ads",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-10-20T08:00:00Z",
        "UpdateTime": "2026-10-20T08:00:00Z"
      }
    ],
    "NextToken": "Q3JlYXRlVGltZToxNzkyMzk2ODAw"
  }
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [],
    "TotalCount": 0,
    "PageNumber": 1,
    "PageSize": 10
  }
}

{
  "Filter": {
    "GroupType": "AIGC",
    "Name": "product"
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}

{
  "Filter": {
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

{
  "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": "Reference assets for product ads",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-10-20T08:00:00Z",
        "UpdateTime": "2026-10-20T08:00:00Z"
      }
    ],
    "NextToken": "Q3JlYXRlVGltZToxNzkyMzk2ODAw"
  }
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [],
    "TotalCount": 0,
    "PageNumber": 1,
    "PageSize": 10
  }
}

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

Requests must be signed with HMAC-SHA256. See Authentication and conventions.

Request parameters

object

required

Filter conditions.

Hide properties

string

required

Group type: AIGC (regular group) or LivenessFace (real-person group).

string[]

Filter by group IDs.

string

Fuzzy match on name.

string

default:"CreateTime"

Sort field: CreateTime or UpdateTime.

string

default:"Desc"

Sort order: Asc or Desc.

integer

default:"10"

Items per page for NextToken pagination, 1–100.

string

Page token for NextToken pagination. Omit on the first request.

integer

Page number for page number pagination, starting at 1. Must be passed with PageSize.

integer

Items per page for page number pagination, 1–100. PageNumber × PageSize cannot exceed 10000.

string

Pass default or omit.

See Pagination for the rules of both modes.

Response parameters

object[]

Asset groups, with the same fields as the Result of GetAssetGroup. Empty array when nothing matches.

string

Token for the next page. Returned only in NextToken pagination when more pages exist.

integer

Total matching items. Page number pagination only.

integer

Current page number. Page number pagination only.

integer

Items per page. Page number pagination only.

{
  "Filter": {
    "GroupType": "AIGC",
    "Name": "product"
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}

{
  "Filter": {
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

{
  "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": "Reference assets for product ads",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-10-20T08:00:00Z",
        "UpdateTime": "2026-10-20T08:00:00Z"
      }
    ],
    "NextToken": "Q3JlYXRlVGltZToxNzkyMzk2ODAw"
  }
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [],
    "TotalCount": 0,
    "PageNumber": 1,
    "PageSize": 10
  }
}

Interface Guide

API Endpoints

Usage Examples

Request parameters

Response parameters

​Request parameters

​Response parameters

Request parameters

Response parameters