GetMyBot 知识库

媒体库

带去重功能的自有媒体存储、premium 访问及通过 Telegram 聊天上传。

本页内容

如果机器人经常发送同一张照片或同一份课程文件,可以先上传到媒体库,之后在消息中重复使用。相同文件即使多次上传也只保存一份。媒体库需要包含 image_storage 的付费套餐;没有该功能时,也可通过工作用 Telegram 聊天上传,取得 Telegram 的 file_id。

自有存储

上传的文件保存在平台存储中并获得媒体标识符。在消息块的"图片"或"文件"中可引用该标识符——发送时平台会自动插入对应文件。上传:POST /api/bots/{id}/media,预览读取:GET /api/bots/{id}/media/{mediaID}。

按内容去重

GetMyBot 用文件的 SHA-256 校验和识别重复内容。再次上传完全相同的文件时,会返回原有的媒体 ID,不会占用第二份存储。

Premium 访问

媒体库是 premium 功能(image_storage)。需要包含该功能的付费套餐;没有有效订阅时,上传到媒体库将返回 402(需要付款) 错误。已存储文件的预览不受限制。

上传到媒体库的单个文件大小限制为 2 MiB。

通过 Telegram 聊天上传(无需 premium)

如果 premium 媒体库不可用,有免费途径:sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload。文件通过指定的 Telegram 聊天发送,响应返回可在机器人消息中使用的 Telegram file_id。此方式不需要付费媒体库;大小限制同样为 2 MiB。

如何选择

目的方式要求
保存并重复发送文件,可预览且不重复存储媒体库套餐含 image_storage,单文件最多 2 MiB
不使用付费媒体库而取得 Telegram file_id工作聊天中的 sink-uploadTelegram 聊天,单文件最多 2 MiB

下一步