Docs Digital Human · Asset Groups /v1/private-avatar/groups/list
API reference

② Query the material group list

Paginated asset group list; filter by name, GroupIds, GroupType.

POST/v1/private-avatar/groups/list

Body Parametersapplication/json

Filter object

Filter conditions

properties
GroupIds array

List of group IDs

GroupType string

Group type

Name string

Group name fuzzy matching

PageNumber integer

Page number

PageSize integer

Number of items per page

model* string

Routing parameters (fixed to pass this value)

Responses

200 Query successful application/json
response-200 object
properties
ResponseMetadata object

Response metadata (Action / Version / RequestId, etc.)

Result object

Business result object

400 Bad request or validation failed application/json
response-400 object
properties
error* object
401 Missing or invalid API Key application/json
response-401 object
Request Body Example
1{
2"Filter": {
3"GroupIds": [
4"group-20260601191715-9q47m"
5],
6"GroupType": "AIGC",
7"Name": "暴建军"
8},
9"PageNumber": 1,
10"PageSize": 10,
11"model": "doubao-seedance-2-0-260128"
12}
Code Sample cURL
1curl -X POST "https://api.digislash.com/v1/private-avatar/groups/list" \
2-H "Authorization: Bearer <API Key>" \
3-H "Content-Type: application/json" \
4-d '{
5"Filter": {
6"GroupIds": [
7"group-20260601191715-9q47m"
8],
9"GroupType": "AIGC",
10"Name": "暴建军"
11},
12"PageNumber": 1,
13"PageSize": 10,
14"model": "doubao-seedance-2-0-260128"
15}'
Response
1▼{
2▼"ResponseMetadata": {
3"Action": "string",
4▶"Error": { 2 keys },
5"Region": "string",
6"RequestId": "string",
7"Service": "string",
8"Version": "string"
9},
10▼"Result": {
11▶"Items": [ 1 items ],
12"PageNumber": 0,
13"PageSize": 0,
14"Total": 0
15}
16}