② 查询素材组列表

POST

/v1/private-avatar/groups/list

分页查询素材组列表，支持按名称、GroupIds、GroupType 筛选。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "model": "doubao-seedance-2-0-260128",
    "Filter": {
        "Name": "暴建军",
        "GroupIds": [
            "group-20260601191715-9q47m"
        ],
        "GroupType": "AIGC"
    },
    "PageNumber": 1,
    "PageSize": 10
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/private-avatar/groups/list' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-260128",
    "Filter": {
        "Name": "暴建军",
        "GroupIds": [
            "group-20260601191715-9q47m"
        ],
        "GroupType": "AIGC"
    },
    "PageNumber": 1,
    "PageSize": 10
}'

返回响应

🟢200成功

application/json

查询成功

Bodyapplication/json

示例

{
    "ResponseMetadata": {
        "RequestId": "string",
        "Action": "string",
        "Version": "string",
        "Service": "string",
        "Region": "string",
        "Error": {
            "Code": "string",
            "Message": "string"
        }
    },
    "Result": {
        "Total": 0,
        "PageNumber": 0,
        "PageSize": 0,
        "Items": [
            {
                "Id": "string",
                "Name": "string",
                "Description": "string",
                "GroupType": "AIGC",
                "CreateTime": "string",
                "UpdateTime": "string"
            }
        ]
    }
}

🟠400请求有误

🟠401没有权限

修改于 2026-10-24 18:33:03

① 创建素材组

⑦ 查询素材列表