QQ 群 API ​

QQ 群 / 全域适配器下，bot.instance.api 的类型为 QQGroupAPI（继承自 QQGuildAPI）。

from amiyabot.adapters.tencent.qqGroup.api import QQGroupAPI

api: QQGroupAPI = bot.instance.api

消息 ​

post_group_message ​

发送群聊消息。

post_private_message ​

发送单聊消息。

delete_group_message ​

撤回群聊消息，发送超过 2 分钟不可撤回。

delete_private_message ​

撤回单聊消息，发送超过 2 分钟不可撤回。

post_stream_message ​

流式发送单聊消息（仅单聊）。首片响应的 id 即后续分片需携带的 stream_msg_id。

富媒体上传 ​

file_type 取值：1=图片 2=视频 3=语音 4=文件。

upload_file ​

整文件上传（传入公网可访问的 URL，平台自动转存）。

upload_prepare ​

分片上传第一步：预上传，返回 upload_id、block_size 与各分片预签名 URL。

upload_part_finish ​

分片上传第三步：通知服务端某个分片已完成（每片 PUT 成功后调用）。

分片上传流程 ​

1. upload_prepare      → upload_id + block_size + 预签名 URL 列表
2. 按 block_size 分片，逐片 HTTP PUT 到预签名 URL
3. 每片成功后调用 upload_part_finish
4. 全部完成后调用 upload_file(upload_id=...) 合并 → 得到 file_info

拿到 file_info 后，以 msg_type=7 发送：

{
    'msg_type': 7,
    'media': {'file_info': '...'},
}

群管理 ​

get_group_info ​

获取群基本信息。

get_group_bot_state ​

获取机器人在指定群中的状态信息。

get_group_members ​

获取群成员列表，单页最多 30 条。

get_group_member ​

获取单个群成员信息。

batch_remove_group_members ​

批量移除群成员，单次最多 20 个。

get_group_member_blacklist ​

查询群黑名单列表。

modify_group_member_blacklist ​

群黑名单操作。目标用户不在群中时才能加入黑名单。

get_group_restrict_chat_setting ​

查询群禁言状态（含全员禁言模式与成员级禁言列表）。需群管理员身份。

set_group_member_mute ​

设置群成员禁言。需群管理员身份，最长禁言 30 天，只能操作普通成员。

members 每项结构：

{
    'op': 'add',                 # add 增加 / update 更新到期时间 / del 解除
    'member_openid': '...',
    'mute_expire_at': '2026-08-05T11:23:05+08:00',  # RFC3339
}

get_group_join_request_list ​

拉取入群申请列表。需群管理员身份。

approval_group_join_request ​

审批入群申请。需群管理员身份。

互动与其他 ​

put_interaction_response ​

回应互动事件（按钮回调等）。收到 INTERACTION_CREATE 后应尽快调用，否则客户端会一直处于 loading 状态。

generate_url_link ​

生成机器人分享链接。