查询素材组列表

Authorization

AuthorizationBearer <token>

兼容网关 API Key，例如 sk-...。

In: header

Query Parameters

Action*string

Default"ListAssetGroups"

Version*string

Default"2024-01-01"

Header Parameters

X-Date?string

使用 HMAC-SHA256 时必填，格式为 YYYYMMDDTHHMMSSZ。

X-Content-Sha256?string

使用 HMAC-SHA256 时必填，请求体 SHA-256 小写十六进制。

Request Body

application/json

Filter*

PageNumber*integer

Range1 <= value

PageSize*integer

Range1 <= value <= 100

SortBy?string

Default"CreateTime"

Value in"CreateTime" | "UpdateTime"

SortOrder?string

Default"Desc"

Value in"Desc" | "Asc"

ProjectName?string

资源所属项目名称，大小写敏感。省略时使用 default。

Default"default"

Response Body

application/json

curl -X POST "https://jieyun.cc/?Action=ListAssetGroups&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -d '{
    "Filter": {
      "GroupType": "AIGC",
      "Name": "产品"
    },
    "PageNumber": 1,
    "PageSize": 20,
    "SortBy": "CreateTime",
    "SortOrder": "Desc",
    "ProjectName": "default"
  }'

curl -X POST "https://jieyun.cc/?Action=ListAssetGroups&Version=2024-01-01" \  -H "Content-Type: application/json" \  -d '{    "Filter": {      "GroupType": "AIGC",      "Name": "产品"    },    "PageNumber": 1,    "PageSize": 20,    "SortBy": "CreateTime",    "SortOrder": "Desc",    "ProjectName": "default"  }'

{
  "ResponseMetadata": {
    "RequestId": "20260721000000000000000000000000",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "TotalCount": 1,
    "Items": [
      {
        "Id": "group-202607210001-example",
        "Name": "产品素材",
        "Description": "产品图片和视频素材",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-07-21T00:00:00Z",
        "UpdateTime": "2026-07-21T00:00:00Z"
      }
    ],
    "PageNumber": 1,
    "PageSize": 20
  }
}

{
  "ResponseMetadata": {
    "RequestId": "string",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {
      "Code": "string",
      "Message": "string"
    }
  }
}

Empty

接口说明

按素材组 ID、类型或名称分页查询 Asset Group。本文档已按火山引擎官方接口说明校对。

POST https://jieyun.cc/?Action=ListAssetGroups&Version=2024-01-01
Content-Type: application/json
Authorization: Bearer <API_KEY>

也可使用 AK/SK HMAC-SHA256 签名，详见素材库认证与签名。

请求参数

字段	类型	必选	说明
`Filter`	object	是	搜索过滤条件。
`Filter.GroupIds`	string[]	否	精确匹配的素材组 ID 列表。
`Filter.GroupType`	string	是	`AIGC`（虚拟人像）或 `LivenessFace`（真人素材）。
`Filter.Name`	string	否	按名称搜索，最长 64 个字符。
`PageNumber`	integer	是	页码，从 1 开始。
`PageSize`	integer	是	每页数量，最大 100。
`SortBy`	string	否	默认 `CreateTime`；可选 `CreateTime` 或 `UpdateTime`。
`SortOrder`	string	否	默认 `Desc`；可选 `Desc` 或 `Asc`。
`ProjectName`	string	否	资源所属项目，默认 `default`，大小写敏感。

{
  "Filter": {
    "GroupType": "AIGC",
    "Name": "产品"
  },
  "PageNumber": 1,
  "PageSize": 20,
  "SortBy": "CreateTime",
  "SortOrder": "Desc",
  "ProjectName": "default"
}

响应内容

字段	类型	说明
`TotalCount`	integer	符合筛选条件的素材组总数。
`Items`	object[]	素材组列表。
`Items.Id`	string	素材组 ID。
`Items.Name`	string	素材组名称。
`Items.Description`	string	素材组描述。
`Items.GroupType`	string	`AIGC` 或 `LivenessFace`。
`Items.ProjectName`	string	所属项目名称。
`Items.CreateTime`	string	创建时间。
`Items.UpdateTime`	string	更新时间。
`PageNumber`	integer	当前页码。
`PageSize`	integer	当前每页数量。

200application/json

400application/json

401

403

404

503

application/json

application/json