查询素材分组列表

国内端点

https://openai.qiniu.com

GET

/v1/asset-groups

分页查询当前用户的素材分组列表，支持按状态和类型过滤。

按创建时间倒序排序，已删除的分组不会返回。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

返回响应

🟢200

application/json

查询成功

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://openai.qiniu.com/v1/asset-groups?page=undefined&page_size=undefined&status=undefined&type=undefined' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "data": [
        {
            "qgroupid": "qgroup-uid001-1716100000000000000",
            "type": "aigc",
            "name": "我的虚拟人像分组",
            "description": "",
            "status": "active",
            "is_default": true,
            "created_at": 1716100000,
            "updated_at": 1716100050
        }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
}

修改于 2026-05-28 08:07:34

查询单个素材分组

更新素材分组