Búsqueda de GIFs (API de Tenor)
Busca y descarga GIFs directamente a través de la API de Tenor usando curl. No se necesitan herramientas adicionales.
Cuándo usarlo
Útil para encontrar GIFs de reacción, crear contenido visual y enviar GIFs en chats.
Configuración
Establece tu clave de API de Tenor en tu entorno (agrega a ${HERMES_HOME:-~/.hermes}/.env):
TENOR_API_KEY=tu_clave_aqui
Obtén una clave de API gratuita en https://developers.google.com/tenor/guides/quickstart: la clave de API de Tenor de Google Cloud Console es gratuita y tiene límites generosos.
Requisitos previos
curlyjq(ambos estándar en macOS/Linux)- Variable de entorno
TENOR_API_KEY
Buscar GIFs
# Buscar y obtener URLs de GIF
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'
# Obtener versiones más pequeñas/vista previa
curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'
Descargar un GIF
# Buscar y descargar el primer resultado
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
Obtener metadatos completos
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}'
Parámetros de la API
| Parámetro | Descripción |
|---|---|
q | Consulta de búsqueda (codificar espacios como +) |
limit | Máximo de resultados (1-50, por defecto 20) |
key | Clave de API (de la variable de entorno $TENOR_API_KEY) |
media_filter | Filtrar formatos: gif, tinygif, mp4, tinymp4, webm |
contentfilter | Seguridad: off, low, medium, high |
locale | Idioma: en_US, es, fr, etc. |
Formatos multimedia disponibles
Cada resultado tiene múltiples formatos bajo .media_formats:
| Formato | Caso de uso |
|---|---|
gif | GIF de calidad completa |
tinygif | GIF pequeño de vista previa |
mp4 | Versión de video (tamaño de archivo más pequeño) |
tinymp4 | Video pequeño de vista previa |
webm | Video WebM |
nanogif | Miniatura muy pequeña |
Notas
- Codifica la consulta en URL: espacios como
+, caracteres especiales como%XX - Para enviar en chats, las URLs de
tinygifson más livianas - Las URLs de GIF se pueden usar directamente en markdown:
