`POST https://ark.cn-beijing.volcengineapi.com/?Action=ListAssets&Version=2024-01-01`
查询符合筛选条件的 Assets（素材资产）列表。

```mixin-react
return (<Tabs>
<Tabs.TabPane title="快速入口" key="X3ZqVHf6Rr"><RenderMd content={`<span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_57d0bca8e0d122ab1191b40101b5df75.png =20x) </span> [调用教程](https://www.volcengine.com/docs/82379/2333565) <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f45b5cd5863d1eed3bc3c81b9af54407.png =20x) </span> [接口列表](https://www.volcengine.com/docs/82379/2318269) <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bef4bc3de3535ee19d0c5d6c37b0ffdd.png =20x) </span> [开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)
`}></RenderMd></Tabs.TabPane>
<Tabs.TabPane title="鉴权说明" key="hEYP88LFdX"><RenderMd content={`本接口仅支持 Access Key（AK/SK）鉴权。
`}></RenderMd></Tabs.TabPane></Tabs>);
```


---


<span id="request-params"></span>
## 请求参数
<span id="request-body"></span>
### 请求体

---


**Filter** `object` %%require%%
搜索的过滤条件。
属性

---


    Filter.**GroupIds** `string[]`
    Asset（素材资产）所属的 Asset Group（素材资产组合）的 Id 列表。

---


    Filter.**GroupType** `string` %%require%%
    Asset Group（素材资产组合）的类型。可选值：

   * `AIGC`：虚拟人像
   * `LivenessFace`：真人素材


---


    Filter.**Statuses** `string[]`
    素材资产状态。可选值：

   * `Active`：素材资产已处理完毕，可以使用
   * `Processing`：素材资产正在预处理，无法使用
   * `Failed`：素材资产处理失败


---


    Filter.**Name** `string`
    Asset（素材资产）的名称，上限为 64 个字符。

---


**PageNumber** `integer (i64)` %%require%%
搜索页码，从 1 开始。例如：`1` 表示返回第一页的搜索结果。

---


**PageSize** `integer (i64)` %%require%%
每页搜索结果的数量，上限为 100。

---


**SortBy** `string`
用于排序的字段名称，默认值为 `CreateTime`。可选值：

* `CreateTime`：根据创建时间排序
* `UpdateTime`：根据更新时间排序
* `GroupId`：根据资产素材组的 Id 排序


---


**SortOrder** `string`
排序顺序，默认值为 `Desc`。可选值：

* `Desc`：降序
* `Asc`：升序


---


**ProjectName** `string`
资源所属的项目名称，默认值为default。
若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
<span id="response-params"></span>
## 响应参数

---


**Items** `object[]`
符合筛选条件的 Asset（素材资产）数组。
属性

---


  Items.**Id** `string`
  Asset（素材资产）的 Id。

---


  Items.**Name** `string`
  Asset（素材资产）的名称，上限为 64 个字符。

---


  Items.**URL** `string`
  Asset（素材资产）的公共可访问地址。有效期为 12 小时，请及时保存。

---


  Items.**GroupId** `string`
  Asset（素材资产）所属的 Asset Group（素材资产组合）的 Id。

---


  Items.**AssetType** `string`
  Asset（素材资产）的类型。可选值：

   * `Image`：图像
   * `Video`：视频
   * `Audio`：音频


---


  Items.**Status** `string`
  任务状态。可选值：

   * `Active`
   * `Processing`
   * `Failed`


---


  Items.**Error** `object`
  错误信息。
    属性

---


    Items.Error.**Code** `string`
    错误码。

---


    Items.Error.**Message** `string`
    错误信息。

---


  Items.**ProjectName** `string`
  资源所属的项目名称。

---


  Items.**CreateTime** `string`
  创建时间。

---


  Items.**UpdateTime** `string`
  更新时间。

---


**TotalCount** `integer (i64)`
返回总数。

---


**PageNumber** `integer (i64)`
返回的页数。

---


**PageSize** `integer (i64)`
每页搜索结果的数量，上限为 100。

---


<span id=".6K-35rGC56S65L6L"></span>
## 请求示例
```text
POST /?Action=ListAssets&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": {
    "GroupIds": [
      "group-2026**********-*****"
    ],
    "GroupType": "AIGC",
    "Statuses": [
      "Active"
    ],
    "Name": "test"
  },
  "PageNumber": 1,
  "PageSize": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc",
  "ProjectName": "default"
}
```

<span id=".5ZON5bqU56S65L6L"></span>
## 响应示例
```json
{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Items": [
      {
        "Id": "Asset-2026**********-*****",
        "Name": "test",
        "URL": "https://example.com/asset-url",
        "GroupId": "group-2026**********-*****",
        "AssetType": "Image",
        "Status": "Active",
        "Error": {
          "Code": "",
          "Message": ""
        },
        "ProjectName": "default",
        "CreateTime": "2026-03-28T00:00:00Z",
        "UpdateTime": "2026-03-28T00:00:00Z"
      }
    ],
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 10
  }
}
```



