1. 首页
  2. API 文档
  3. 消息与媒体
  4. upload_group_image

upload_group_image

  • 发布于 2026-08-16
  • 11 次阅读

上传群聊图片,并返回可直接发送的图片消息段。

调用

const image = await api.upload_group_image(
  self_id,
  group_id,
  file_path,
)

参数

参数 类型 必填 说明
self_id number 在线 Bot QQ 号
group_id number 目标群聊 ID
file_path string 后端本地路径、file:// 或后端可访问的 HTTP(S) 地址
文件名由后端根据图片 MD5 自动生成,图片类型由后端设置为 1000

返回值

{ type: 'image', data: { file_id: 'FILE_ID' } }

示例

const image = await api.upload_group_image(
  123456789,
  987654321,
  'D:/images/example.png',
)

await api.send_group_msg(123456789, 987654321, [image])

插件与萌卡NT不在同一台主机时,不要传插件主机的本地路径;应传后端可访问的 HTTP(S) 地址。