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

upload_group_voice

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

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

调用

const voice = await api.upload_group_voice(self_id, group_id, file_path)

参数

参数 类型 必填 说明
self_id number 在线 Bot QQ 号
group_id number 目标群聊 ID
file_path string 后端本地路径、file:// 或后端可访问的 HTTP(S) 音频地址

后端通过 FFmpeg 解码常见音频格式,转换为单声道 24kHz PCM 后编码为 Silk,并生成语音波形。需要先安装并运行 FFmpeg 镜像。

返回值

{
  type: 'voice',
  data: {
    file_id: 'FILE_ID',
    duration: 5,
  },
}

返回段只能发送到上传时指定的群。

示例

const voice = await api.upload_group_voice(
  123456789,
  987654321,
  'D:/voices/example.mp3',
)

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

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