GetMyBot 知識庫

媒體庫

儲存機器人訊息中的相片和檔案;了解媒體庫上傳及不用付費媒體庫取得 Telegram file_id 的方式。

本頁內容

如果機器人經常傳送同一份課程文件或相片,可將檔案上傳至媒體庫並重複使用。相同檔案即使重複上傳,也只儲存一份。媒體庫需要包含檔案儲存功能(image_storage)的付費方案。

若只需透過 Telegram 傳送,也可以從工作用聊天上傳檔案,取得 Telegram 的 file_id,無須使用付費媒體庫。

自有儲存

上傳的檔案存入平台儲存並獲得媒體識別碼。在訊息的「照片」或「檔案」區塊中可引用此識別碼——傳送時平台會自動插入對應檔案。上傳:POST /api/bots/{id}/media;讀取預覽:GET /api/bots/{id}/media/{mediaID}。

依內容去重

再次上傳相同檔案時,平台以 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。此方式所有使用者均可使用,無 Premium 限制;大小限制同樣為 2 MiB。

選擇建議

  • 定期重複使用相同圖片,需要去重和預覽 — 媒體庫(Premium)。
  • 需要快速取得 file_id 且不想訂閱 — 透過服務對話 sink-upload。

延伸閱讀