set_group_portrait
设置指定群聊的头像。萌卡NT会按 QQ Android 9.2.70 的 Highway command_id=3000 上传链路，先获取当前账号的 Highway 会话，再将公开群号转换为 QQ 内部群 UIN 后提交图片。
调用
js
const result = await api.set_group_portrait(self_id, group_id, file)参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | number | 是 | 在线 Bot QQ 号 |
group_id | number / string | 是 | 公开群号 |
file | string | 是 | 本地路径、file://、HTTP(S)、base64:// 或 Base64 data URL |
图片必须是有效的 GIF、JPEG 或 PNG，大小不超过 10 MiB。调用账号必须是群主或具备修改群头像的管理员权限。
路径属于后端主机
插件和萌卡NT不在同一台主机时，插件本机路径对后端不可见。此时应使用 HTTP(S)、base64:// 或 data URL。
返回值
js
{
result: 0,
errMsg: '',
new_seq: 24,
}result 为 0 表示 QQ 已接受上传；非零值会作为调用错误返回。权限不足时 QQ 会返回 No Perm，不会被框架伪装为上传成功。群头像 CDN 可能有短暂缓存。
示例
js
await api.set_group_portrait(
1060221,
106500,
'https://example.com/group-avatar.png',
)