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

upload_group_video

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

上传群聊 MP4 视频,并返回可直接发送的视频消息段。

调用

const video = await api.upload_group_video(self_id, group_id, file_path)

参数

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

后端通过已安装并运行的 FFmpeg 镜像读取视频尺寸与时长,并自动提取 PNG 封面。

返回值

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

返回段可直接传给 send_group_msg,并应发送到上传时指定的群聊。视频必须作为唯一消息段单独发送。

示例

const video = await api.upload_group_video(
  123456789,
  987654321,
  'D:/videos/example.mp4',
)

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

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