通过 POST http://127.0.0.1:3000/get_group_album_list（请求体为 JSON 参数）或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
group_id |
uint | ✓ | 群号 |
群相册列表数组，每项为一个相册的基本信息。
所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
data 为数组，每个元素：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
string | ✓ | 相册 id |
name |
string | ✓ | 相册名称 |
picNum |
integer | ✓ | 相册内照片数量 |
createTime |
integer | ✓ | 相册创建时间（unix 秒） |
last_upload_time |
integer | ✓ | 最后上传时间（unix 秒） |
cover |
object,null | ✓ | 相册封面；没有封面时为 null |
createuin |
string | ✓ | 相册创建者 QQ 号 |
createnickname |
string | ✓ | 相册创建者昵称（原始 Unicode） |
{
"type": "array",
"description": "群相册列表",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "相册 id"
},
"name": {
"type": "string",
"description": "相册名称"
},
"picNum": {
"type": "integer",
"description": "相册内照片数量"
},
"createTime": {
"type": "integer",
"description": "相册创建时间（unix 秒）"
},
"last_upload_time": {
"type": "integer",
"description": "最后上传时间（unix 秒）"
},
"cover": {
"type": [
"object",
"null"
],
"description": "相册封面；没有封面时为 null",
"properties": {
"type": {
"type": "integer",
"description": "封面媒体类型"
},
"image": {
"type": [
"object",
"null"
],
"description": "封面图片信息",
"properties": {
"name": {
"type": "string",
"description": "图片名称"
},
"sloc": {
"type": "string",
"description": "图片短定位标识"
},
"lloc": {
"type": "string",
"description": "图片长定位标识"
},
"photoUrls": {
"type": "array",
"description": "不同规格的封面地址",
"items": {
"type": "object",
"properties": {
"spec": {
"type": "integer",
"description": "图片规格"
},
"url": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": "string",
"description": "封面地址"
},
"width": {
"type": "integer",
"description": "封面宽度"
},
"height": {
"type": "integer",
"description": "封面高度"
}
},
"required": [
"url",
"width",
"height"
]
}
},
"required": [
"spec",
"url"
]
}
},
"defaultUrl": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": "string",
"description": "封面地址"
},
"width": {
"type": "integer",
"description": "封面宽度"
},
"height": {
"type": "integer",
"description": "封面高度"
}
},
"required": [
"url",
"width",
"height"
]
},
"isGif": {
"type": "boolean",
"description": "是否为动图"
},
"hasRaw": {
"type": "boolean",
"description": "是否有原图"
}
},
"required": [
"name",
"sloc",
"lloc",
"photoUrls",
"defaultUrl",
"isGif",
"hasRaw"
]
}
},
"required": [
"type",
"image"
]
},
"createuin": {
"type": "string",
"description": "相册创建者 QQ 号"
},
"createnickname": {
"type": "string",
"description": "相册创建者昵称（原始 Unicode）"
}
},
"required": [
"id",
"name",
"picNum",
"createTime",
"last_upload_time",
"cover",
"createuin",
"createnickname"
]
}
}curl -X POST http://127.0.0.1:3000/get_group_album_list \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <access-token>' \
-d '{"group_id":123456}'支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。