Medienbibliothek

Damit der Bot Bilder und Dateien verschicken kann, müssen diese irgendwo gespeichert werden. GetMyBot verfügt über eine eigene Medienbibliothek: Sie laden eine Datei einmal hoch, und die Plattform fügt sie selbst in Nachrichten ein. Die Bibliothek dedupliziert identische Dateien und gehört zu den Premium-Funktionen; für den Basisfall gibt es einen kostenlosen Upload über den Telegram-Chat.

Eigener Speicher

Eine hochgeladene Datei wird im Plattformspeicher gespeichert und erhält eine Medien-ID. Im Nachrichtenblock „Foto" oder „Datei" kann auf diese ID verwiesen werden — beim Senden fügt die Plattform die entsprechende Datei selbst ein. Upload: POST /api/bots/{id}/media, Lesen für Vorschau: GET /api/bots/{id}/media/{mediaID}.

Deduplizierung nach Inhalt

Jede Datei wird anhand ihres sha256-Hashes des Inhalts identifiziert. Wenn Sie dieselbe Datei erneut hochladen, erstellt die Plattform kein Duplikat, sondern gibt einen Link zum bereits gespeicherten Objekt zurück. So belegen identische Bilder keinen Platz doppelt, und die ID bleibt stabil.

Premium-Zugang

Die Medienbibliothek ist eine Premium-Funktion (image_storage). Sie ist im kostenpflichtigen Tarif verfügbar, der sie einschließt; ohne aktives Abonnement gibt der Upload in die Bibliothek den Fehler 402 (Zahlung erforderlich) zurück. Die Vorschau bereits gespeicherter Dateien funktioniert ohne Einschränkungen.

Die Größe einer einzelnen Datei beim Upload in die Bibliothek ist auf 2 MiB begrenzt.

Upload über Telegram-Chat (ohne Premium)

Wenn die Premium-Bibliothek nicht verfügbar ist, gibt es einen kostenlosen Weg: Sink-Upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. Die Datei wird über den angegebenen Telegram-Chat gesendet, und als Antwort wird eine file_id von Telegram zurückgegeben, die in Bot-Nachrichten verwendet werden kann. Diese Methode ist für alle ohne Premium-Gate verfügbar; die Größenbeschränkung beträgt ebenfalls 2 MiB.

Was verwenden

  • Sie verwenden dieselben Bilder regelmäßig und möchten Deduplizierung und Vorschau — Medienbibliothek (Premium).
  • Sie benötigen schnell eine file_id ohne Abonnement — Sink-Upload über einen Service-Chat.

Nächste Schritte