媒体库

要让机器人发送图片和文件，需要有地方存储它们。GetMyBot 拥有自己的媒体库：你上传一次文件，平台自动将其插入消息。媒体库支持相同文件去重，属于 premium 功能；对于基本场景，有免费的通过 Telegram 聊天上传方式。

自有存储

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

按内容去重

每个文件通过sha256 内容哈希标识。如果重复上传相同文件，平台不会创建副本，而是返回已存储对象的链接。这样相同图片不会占用两倍空间，标识符始终保持稳定。

Premium 访问

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

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

通过 Telegram 聊天上传（无需 premium）

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

如何选择

  • 经常复用相同图片且需要去重和预览功能——使用媒体库（premium）。
  • 需要快速获取 file_id 且没有订阅——通过服务聊天使用 sink-upload。

下一步