媒体库
带去重功能的自有媒体存储、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-upload | Telegram 聊天,单文件最多 2 MiB |
下一步
- 消息与按钮 — 机器人回复中的"图片"和"文件"块。
- 支付与余额 — 套餐与 premium 功能。
- 从 SamBot 导入 — 从导入包迁移媒体。
- 聊天与操作员 — 用于 sink-upload 的服务聊天。