通过 POST http://127.0.0.1:3000/get_qun_album_list（请求体为 JSON 参数）或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
group_id |
uint | ✓ | 群号 | |
attach_info |
string | – | "" |
NapCat 风格的相册列表封套：{album_list, attach_info, has_more}。
所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
album_list |
object[] | ✓ | 相册列表 |
attach_info |
string | ✓ | 下一页分页游标 |
has_more |
boolean | ✓ | 是否还有更多 |
{
"type": "object",
"properties": {
"album_list": {
"type": "array",
"description": "相册列表",
"items": {
"type": "object",
"properties": {
"album_id": {
"type": "string",
"description": "相册 id"
},
"name": {
"type": "string",
"description": "相册名称"
},
"create_time": {
"type": "string",
"description": "相册创建时间（unix 秒）"
},
"last_upload_time": {
"type": "string",
"description": "最后上传时间（unix 秒）"
},
"upload_number": {
"type": "string",
"description": "相册内媒体数量"
},
"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"
]
},
"creator": {
"type": "object",
"description": "相册创建者信息",
"properties": {
"uin": {
"type": "string",
"description": "创建者 QQ 号"
},
"uid": {
"type": "string",
"description": "创建者 UID"
},
"nick": {
"type": "string",
"description": "创建者原始 Unicode 昵称"
}
}
}
},
"required": [
"album_id",
"name",
"create_time",
"last_upload_time",
"upload_number",
"cover"
]
}
},
"attach_info": {
"type": "string",
"description": "下一页分页游标"
},
"has_more": {
"type": "boolean",
"description": "是否还有更多"
}
},
"required": [
"album_list",
"attach_info",
"has_more"
]
}curl -X POST http://127.0.0.1:3000/get_qun_album_list \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <access-token>' \
-d '{"group_id":123456,"attach_info":""}'支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。