---
title: "素材组列表"
method: GET
path: "/api/ai/volcengine/assets/groups"
tags: ["AI 服务/虚拟人像素材"]
---

# 素材组列表

`GET /api/ai/volcengine/assets/groups`

## Request

- Base URL: `https://aitoearn.cn`
- URL: `https://aitoearn.cn/api/ai/volcengine/assets/groups`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/aitoearn/apis/aitoearn-api/docs/api/ai/volcengine/assets/groups/get.ts> (a function with typed inputs; its response is checked against the schema)

分页查询当前 API Key 所属账号的素材组。`avatarType` 选填：查询虚拟人像素材组传入 `Virtual`，查询真人认证素材组传入 `RealPerson`。这是查询参数，创建接口不接收。

## Query parameters

- `page` integer: 页码，从 1 开始。
- `pageSize` integer: 每页数量，取值范围 1-1000。
- `avatarType` 'Virtual' | 'RealPerson': 查询素材组时的可选参数。Virtual 表示虚拟人像素材组，RealPerson 表示真人认证成功后的素材组。创建接口不接收这个字段。

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` object
    - `page` integer, required: 当前页码。
    - `pageSize` integer, required: 每页数量。
    - `totalPages` integer, required: 总页数。
    - `total` integer, required: 总数量。
    - `list` object[], required: 数据列表。
      - `groupId` string, required: 素材组 ID。
      - `name` string, required: 素材组名称。
      - `description` string: 素材组描述。
      - `avatarType` 'Virtual' | 'RealPerson', required: 人像类型，由服务端返回，创建时不要传入。Virtual 表示虚拟人像组，RealPerson 表示真人认证成功后的素材组。
      - `createdAt` string, date-time, required: 创建时间。
      - `updatedAt` string, date-time, required: 更新时间。
  - `code` integer, required: 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required: 响应消息。
  - `requestId` string: 请求 ID。
  - `timestamp` integer: 错误响应时间戳，Unix 毫秒。

## Changes

- **2026-11-03** `7cc8f21c4c96`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/aitoearn/apis/aitoearn-api/changes/api/ai/volcengine/assets/groups/get.md)

---

[API](https://skmtc.dev/aitoearn/apis/aitoearn-api.md) - [All operations](https://skmtc.dev/aitoearn/apis/aitoearn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aitoearn/apis/aitoearn-api/revisions/7cc8f21c4c96?raw)