文档中心

火山方舟

管理私域素材库

查询素材资产组合列表

POST https://ark.cn-beijing.volcengineapi.com/?Action=ListAssetGroups&Version=2024-01-01

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

分页方式说明

本接口支持以下两种分页方式查看返回数据：

方式一：NextToken 分页（推荐）：通过 MaxResults 参数设置每页返回的最大记录数，再通过 NextToken 参数传入翻页凭证，展示下一页内容。

首次查询时，可传入 MaxResults 设置每页返回的最大记录数，无需传入 NextToken。存在下一页时，响应中同时返回 NextToken。

后续查询时，传入前一次响应返回的 NextToken。如果未返回 NextToken，则表示遍历结束。

后续查询建议保持 Filter、ProjectName、SortBy 和 SortOrder 与首次查询一致。

使用该方式时，不返回 TotalCount、PageNumber 和 PageSize。

方式二：页码分页（兼容）：通过 PageSize 参数设置每页返回的记录数，通过 PageNumber 参数指定具体返回页码。

响应返回 TotalCount、PageNumber 和 PageSize。

说明：

两种分页方式只能任选其一，不可同时传入两类分页参数。

未传入任何分页参数时，默认使用方式一，按 MaxResults = 10 查询。后续查询可使用 NextToken 翻页。

当数据查询范围较大（即 PageSize * PageNumber > 10000）时，请通过 NextToken 方式来实现深翻页。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

Access Key 鉴权，请在 Access Key 管理页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

请求参数

Body 参数

Filter object 必选 | 过滤条件

NextToken string | 翻页凭证

MaxResults integer | 每页记录数

SortBy string 默认值 CreateTime | 排序字段

SortOrder string 默认值 Desc | 排序顺序

ProjectName string 默认值 default | 所属项目

PageNumber integer | 页码（当 PageSize * PageNumber > 10000 时，请使用 NextToken 深翻页）

PageSize integer | 每页记录数（当 PageSize * PageNumber > 10000 时，请使用 NextToken 深翻页）

响应参数

Items object[] | 素材组列表

NextToken string | 下一页翻页凭证

PageNumber integer | 页码

PageSize integer | 每页记录数

TotalCount integer | 总数

默认

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=ListAssetGroups&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
    "Filter": {
        "GroupIds": [
            "group-20240514212750-b5e9m",
            "group-20240514212810-c7n2p"
        ],
        "GroupType": "AIGC"
    },
    "MaxResults": 1,
    "SortBy": "CreateTime",
    "SortOrder": "Desc",
    "ProjectName": "default"
}
'

Response

{
    "ResponseMetadata": {
        "RequestId": "202405142130002B3C4D5E6F70819203",
        "Action": "ListAssetGroups",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Items": [
            {
                "Id": "group-20240514212750-b5e9m",
                "Name": "demo-portrait-group",
                "Description": "虚拟人像素材组示例",
                "GroupType": "AIGC",
                "ProjectName": "default",
                "CreateTime": "2024-05-14T21:27:50Z",
                "UpdateTime": "2024-05-14T21:30:00Z"
            }
        ],
        "NextToken": "****bmNyeXB0ZWRfY3Vyc29yIjoiLi4****"
    }
}

最近更新时间：2026.09.04 23:45:47

这个页面对您有帮助吗？

有用

无用