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

# ListAssets

> 按素材组、名称、状态查询素材列表。

```text theme={null}
POST {BaseUrl}/?Action=ListAssets&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[]`

按所属素材组筛选，多个组取并集。

**Name** `string`

按名称模糊匹配。

**Statuses** `string[]`

按状态筛选，可选 `Active`、`Processing`、`Failed`。

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

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

**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` 不能超过 20000。

**ProjectName** `string`

可传 `default` 或不传。

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

## 响应参数

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

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

**Result.NextToken** `string`

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

**Result.TotalCount** `integer`

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

**Result.PageNumber** `integer`

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

**Result.PageSize** `integer`

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

```json NextToken 分页 theme={null}
{
  "Filter": {
    "GroupType": "AIGC",
    "GroupIds": ["group-20261020080000-abcde"],
    "Statuses": ["Active"]
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}
```

```json 页码分页 theme={null}
{
  "Filter": {
    "GroupType": "AIGC",
    "GroupIds": ["group-20261020080000-abcde"]
  },
  "PageNumber": 1,
  "PageSize": 10
}
```

```json 200 theme={null}
{
  "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"
      }
    ]
  }
}
```


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