GIF-Suche (Tenor-API)
Suche und lade GIFs direkt über die Tenor-API mit curl herunter. Keine zusätzlichen Werkzeuge erforderlich.
Verwendung
Nützlich, um Reaktions-GIFs zu finden, visuelle Inhalte zu erstellen oder GIFs in Chats zu versenden.
Einrichtung
Lege deinen Tenor-API-Schlüssel in deiner Umgebung fest (füge ihn zu ${HERMES_HOME:-~/.hermes}/.env hinzu):
TENOR_API_KEY=dein_schlüssel_hier
Einen kostenlosen API-Schlüssel erhältst du unter https://developers.google.com/tenor/guides/quickstart – der Tenor-API-Schlüssel der Google Cloud Console ist kostenlos und hat großzügige Ratenbegrenzungen.
Voraussetzungen
curlundjq(beide Standard auf macOS/Linux)- Umgebungsvariable
TENOR_API_KEY
GIFs suchen
# Suche und erhalte GIF-URLs
curl -s "https://tenor.googleapis.com/v2/search?q=daumen+hoch&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'
# Kleinere Vorschaubilder erhalten
curl -s "https://tenor.googleapis.com/v2/search?q=super+arbeit&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'
Ein GIF herunterladen
# Suche und lade das beste Ergebnis herunter
URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=feiern&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url')
curl -sL "$URL" -o feiern.gif
Vollständige Metadaten abrufen
curl -s "https://tenor.googleapis.com/v2/search?q=katze&limit=3&key=${TENOR_API_KEY}" | jq '.results[] | {titel: .title, url: .media_formats.gif.url, vorschau: .media_formats.tinygif.url, dimensionen: .media_formats.gif.dims}'
API-Parameter
| Parameter | Beschreibung |
|---|---|
q | Suchbegriff (Leerzeichen als + URL-kodieren) |
limit | Maximale Ergebnisse (1–50, Standard 20) |
key | API-Schlüssel (aus der Umgebungsvariablen $TENOR_API_KEY) |
media_filter | Formate filtern: gif, tinygif, mp4, tinymp4, webm |
contentfilter | Sicherheitsfilter: off, low, medium, high |
locale | Sprache: en_US, es, fr usw. |
Verfügbare Medienformate
Jedes Ergebnis enthält mehrere Formate unter .media_formats:
| Format | Anwendungsfall |
|---|---|
gif | Vollständiges GIF in hoher Qualität |
tinygif | Kleines Vorschaubild |
mp4 | Videoversion (kleinere Dateigröße) |
tinymp4 | Kleines Vorschauvideo |
webm | WebM-Video |
nanogif | Winziger Thumbnail |
Hinweise
- URL-kodiere die Suchanfrage: Leerzeichen als
+, Sonderzeichen als%XX - Für den Versand in Chats sind
tinygif-URLs leichtgewichtig - GIF-URLs können direkt in Markdown verwendet werden:
