从运行时动作目录生成的 OpenAPI：参数、应答、示例和试调 SnowLuma 的 HTTP API 与 OneBot v11 兼容。每个动作一页，由 OpenAPI 插件渲染：请求体、鉴权、应答信封、代码示例，以及对着你自己的实例试调。 方法： POST /{动作名} 请求体： Content-Type: application/json 默认服务： http://127.0.0.1:3000/ （同一 Docker 网络里用 http://snowluma:3000/ ） 鉴权（配置了 token 时）： Authorization: Bearer <token> ，或查询参数 ?access_token= WebSocket： ws://127.0.0.1:3001/ ，动作名与 HTTP 相同 HTTP 200 仍可能是业务失败。看信封里的 retcode ： retcode 为 0 才是成功。 data 的形状见各动作页。 打开任意动作页，填服务地址和 token，用试调面板直接发请求。请求发自你的浏览器，目标是你填的服务器，不是文档站。 MCP 客户端不必手写 HTTP，见 MCP 。 删除群公告（fid 或 notice_id 二选一） POST 获取指定 QQ 号正在使用的个性装扮（挂件/名片/来电/输入状态等） POST 获取机型展示（兼容 mock） POST 发送群公告（支持置顶、弹窗、新成员、群昵称引导与确认） POST 设置机型展示（占位） POST 下载文件（url 或 base64）到 data/downloads POST 解析闪传文件下载直链（不下载，由调用方实现下载） POST 获取表情回应用户（NapCat 分页） POST 获取 AI 语音角色 POST 获取 clientkey POST 获取 Cookies POST 获取 CSRF 令牌 POST 获取文件信息（仅图片/语音缓存；群文件请用 get_group_file_url） POST 从 QQ 闪传分享码或官方分享链接获取 fileset_id POST 获取合并转发消息（id 或 message_id） POST 获取好友消息历史（无锚点时从服务器获取最新双向记录） POST 获取群 @全体成员 剩余次数 POST 获取被忽略的入群请求（NapCat） POST 获取被过滤的入群请求 POST 获取小程序卡片 ark POST 获取一条消息的全部表情回应 POST 获取最近会话（占位） POST 获取语音信息；传 out_format 则服务端转码并附带 base64 POST 获取 rkey 服务器信息 POST 列出当前账号的所有闪传文件集 POST 标记消息已读（群聊/私聊自动路由） POST 获取 packet 状态（占位） POST 获取用户在线/扩展状态 POST OCR 图片（服务端，需图片 URL 或已缓存的图片 file_id） POST 分享用户/群 Ark 卡片（NapCat 标准名） POST 发送闪传消息（私聊或群聊，引用 fileset_id 让对端下载） POST 发送合并转发（按 message_type/群号自动路由） POST 发送 AI 语音到群 POST 分享群 Ark 卡片（NapCat 标准名） POST 发送原始 SSO 包（cmd + hex data） POST 拍一拍（群聊/私聊自动路由） POST 发送图文 Ark 卡片（私聊/群聊） POST 设置群机器人加群选项 POST 设置个性签名（longNick/long_nick，严格 string） POST 分享群 Ark 卡片 POST 分享用户/群 Ark 卡片 POST 上传转发消息（别名拼写） POST 向某个群分类添加资料标签 POST 从某个群分类移除资料标签 POST 读取指定管理员的撤回、移除成员、每日移除上限及接收验证消息状态 POST 获取群管理设置的当前值 POST 读取某个群分类下的资料标签 POST 设置指定管理员的撤回和移除成员权限 POST 设置指定管理员是否接收加群验证消息 POST 匿名开关（未实现，返回 ok） POST 匿名禁言（未实现，返回 ok） POST

禁言群成员（duration=0 解除） POST 设置群名片（空字符串清除） POST 设置群成员权限（仅群主可改） POST 设置新成员是否可查看历史消息 POST 设置群被搜索方式（群指纹 / 群号搜索开关） POST can_send_image POST can_send_record POST get_login_info POST get_status POST get_version_info POST cancel_group_album_media_like POST 删除群相册图片或视频 POST do_group_album_comment POST get_group_album_list POST get_group_album_media_list POST get_qun_album_list POST set_group_album_media_like POST upload_image_to_qun_album POST 清理流式传输临时文件(仅清理 stream 上传/下载目录) POST 以流式方式下载图片(缓存图片 id / URL / stream 目录本地文件) POST 以流式方式下载语音(缓存语音 id / URL / stream 目录本地文件) POST 以流式方式下载文件(stream 目录本地文件 / URL / 缓存媒体) POST 测试下载流(推送 10 个数据帧,验证流式传输,不触达 QQ) POST 以流式分块方式上传文件到机器人本地(返回可用于发送的本地路径) POST 评论说说或回复指定评论（普通评论支持带图，楼中楼仅支持文字） POST 评论推荐动态，支持文本或上游富文本条目 POST 删除一条说说（QQ 空间，按 tid） POST 删除推荐动态的一条评论（需有权限） POST 删除推荐动态评论下的一条回复（需有权限） POST 将推荐动态转发到当前账号空间 POST 获取 QQ 空间好友动态，支持结构化正文与游标分页 POST 获取 QQ 空间说说详情与一页评论（含服务端内联回复，需有访问权限） POST 获取 QQ 空间说说列表（默认机器人自己的空间） POST 获取 QQ 空间名称和说明（默认当前账号） POST 读取当前账号的空友爱看入口与推权限 POST 继续读取推荐动态评论 POST 读取推荐动态详情及初始评论 POST 读取空友爱看推荐动态，支持独立游标分页 POST 继续读取指定评论的回复 POST 给一条说说点赞（QQ 空间） POST 回复推荐动态的评论或其中某条回复 POST 发表说说（QQ 空间，支持纯文字或带图；传 images 自动上传；可设置查看权限） POST 拉黑或解除拉黑某人（修改机器人自身 QQ 空间黑名单；enable=true 拉黑，false 解除） POST 修改一条已发说说的查看权限（QQ 空间，按 tid） POST 修改当前账号的 QQ 空间名称或说明 POST 点赞或取消赞推荐动态中的评论或回复 POST 蹲或取消蹲推荐动态作者 POST 点赞或取消赞推荐动态 POST 推或取消推空友爱看动态（独立于普通赞） POST 取消对一条说说的点赞（QQ 空间；取消赞端点待真机核实） POST 获取群子目录文件列表 POST 获取群根目录文件列表 POST 获取私聊文件下载链接 POST 发送账号收藏表情（emoji_id 或 MD5），保留表情显示样式 POST 发送消息（按 message_type/群号 自动路由群聊或私聊） POST 按编号查询 QQ 系统表情 POST 判断 QQ 系统表情是否使用超级表情格式 POST 获取 QQ 系统表情目录 POST 搜索 QQ 系统表情 POST 增量上传、逐块下载，以及流式响应的取消、校验和错误处理 删除群公告（fid 或 notice_id 二选一） POST