ListAssets

{
  "Filter": {
    "GroupType": "AIGC",
    "GroupIds": ["group-20261020080000-abcde"],
    "Statuses": ["Active"]
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}

{
  "Filter": {
    "GroupType": "AIGC",
    "GroupIds": ["group-20261020080000-abcde"]
  },
  "PageNumber": 1,
  "PageSize": 10
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [
      {
        "Id": "asset-20261020080000-abcde",
        "GroupId": "group-20261020080000-abcde",
        "Name": "tea-reference",
        "AssetType": "Image",
        "Status": "Active",
        "URL": "https://media.example.com/reference.jpg?signature=xxx",
        "Moderation": {
          "Strategy": "Default"
        },
        "ProjectName": "default",
        "CreateTime": "2026-10-20T08:00:00Z",
        "UpdateTime": "2026-10-20T08:00:03Z"
      }
    ]
  }
}

{
  "Filter": {
    "GroupType": "AIGC",
    "GroupIds": ["group-20261020080000-abcde"],
    "Statuses": ["Active"]
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}

{
  "Filter": {
    "GroupType": "AIGC",
    "GroupIds": ["group-20261020080000-abcde"]
  },
  "PageNumber": 1,
  "PageSize": 10
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [
      {
        "Id": "asset-20261020080000-abcde",
        "GroupId": "group-20261020080000-abcde",
        "Name": "tea-reference",
        "AssetType": "Image",
        "Status": "Active",
        "URL": "https://media.example.com/reference.jpg?signature=xxx",
        "Moderation": {
          "Strategy": "Default"
        },
        "ProjectName": "default",
        "CreateTime": "2026-10-20T08:00:00Z",
        "UpdateTime": "2026-10-20T08:00:03Z"
      }
    ]
  }
}

POST {BaseUrl}/?Action=ListAssets&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. Different fields are combined with AND.

Hide properties

string

required

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

string[]

Filter by group. Multiple groups are combined with OR.

string

Fuzzy match on name.

string[]

Filter by status: Active, Processing, Failed.

string

default:"CreateTime"

Sort field: CreateTime, UpdateTime or GroupId.

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 20000.

string

Pass default or omit.

See Pagination for the rules of both modes.

Response parameters

object[]

Assets, with the same fields as the Result of GetAsset. 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",
    "GroupIds": ["group-20261020080000-abcde"],
    "Statuses": ["Active"]
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}

{
  "Filter": {
    "GroupType": "AIGC",
    "GroupIds": ["group-20261020080000-abcde"]
  },
  "PageNumber": 1,
  "PageSize": 10
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [
      {
        "Id": "asset-20261020080000-abcde",
        "GroupId": "group-20261020080000-abcde",
        "Name": "tea-reference",
        "AssetType": "Image",
        "Status": "Active",
        "URL": "https://media.example.com/reference.jpg?signature=xxx",
        "Moderation": {
          "Strategy": "Default"
        },
        "ProjectName": "default",
        "CreateTime": "2026-10-20T08:00:00Z",
        "UpdateTime": "2026-10-20T08:00:03Z"
      }
    ]
  }
}

Interface Guide

API Endpoints

Usage Examples

Request parameters

Response parameters

​Request parameters

​Response parameters

Request parameters

Response parameters