Recherche de GIFs (API Tenor)
Recherchez et téléchargez des GIFs directement via l'API Tenor en utilisant curl. Aucun outil supplémentaire n'est nécessaire.
Quand l'utiliser
Utile pour trouver des GIFs de réaction, créer du contenu visuel et envoyer des GIFs dans des conversations.
Configuration
Définissez votre clé API Tenor dans votre environnement (ajoutez dans ${HERMES_HOME:-~/.hermes}/.env) :
TENOR_API_KEY=votre_cle_ici
Obtenez une clé API gratuite sur https://developers.google.com/tenor/guides/quickstart — la clé API Tenor de Google Cloud Console est gratuite et offre des limites de débit généreuses.
Prérequis
curletjq(tous deux standard sur macOS/Linux)- Variable d'environnement
TENOR_API_KEY
Rechercher des GIFs
# Rechercher et obtenir les URL des GIFs
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'
# Obtenir les versions plus petites/aperçu
curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'
Télécharger un GIF
# Rechercher et télécharger le meilleur résultat
URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=celebration&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url')
curl -sL "$URL" -o celebration.gif
Obtenir les métadonnées complètes
curl -s "https://tenor.googleapis.com/v2/search?q=cat&limit=3&key=${TENOR_API_KEY}" | jq '.results[] | {title: .title, url: .media_formats.gif.url, preview: .media_formats.tinygif.url, dimensions: .media_formats.gif.dims}'
Paramètres de l'API
| Paramètre | Description |
|---|---|
q | Requête de recherche (encoder les espaces en +) |
limit | Nombre maximum de résultats (1-50, défaut 20) |
key | Clé API (depuis la variable d'environnement $TENOR_API_KEY) |
media_filter | Filtrer les formats : gif, tinygif, mp4, tinymp4, webm |
contentfilter | Sécurité : off, low, medium, high |
locale | Langue : en_US, es, fr, etc. |
Formats de médias disponibles
Chaque résultat possède plusieurs formats sous .media_formats :
| Format | Cas d'utilisation |
|---|---|
gif | GIF de qualité complète |
tinygif | Petit GIF d'aperçu |
mp4 | Version vidéo (taille de fichier réduite) |
tinymp4 | Petite vidéo d'aperçu |
webm | Vidéo WebM |
nanogif | Très petite vignette |
Remarques
- Encodez la requête dans l'URL : espaces en
+, caractères spéciaux en%XX - Pour envoyer dans un chat, les URL
tinygifsont plus légères - Les URL des GIFs peuvent être utilisées directement en markdown :
