媒體庫

機器人要傳送圖片和檔案，需要有地方儲存。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。

延伸閱讀