Поиск и загрузка GIF-файлов через API Tenor

Как применить

Это полезно для поиска GIF-файлов с реакциями, создания визуального контента и отправки GIF-файлов в чат.

Каждый результат имеет несколько форматов в .media_formats: gif — для полноценного качества, tinygif — для небольшого предпросмотра, mp4 — как уменьшенная видеоверсия, tinymp4 — как небольшое видеопревью, webm — видео, а nanogif — как крошечная миниатюра.

Закодируйте запрос в URL: пробелы заменяются на +, а специальные символы — на %XX.

Для отправки в чат URL-адреса вида tinygif занимают меньше места.

URL-адреса GIF-файлов можно использовать напрямую в Markdown: ![alt](url)

Завершите настройку, сохранив свой ключ, чтобы команды могли им пользоваться.

Установите свой ключ API Tenor в окружении (добавьте его в ${HERMES_HOME:-~/.hermes}/.env).

TENOR_API_KEY=your_key_here

Выполните поисковый запрос к API, чтобы получить URL-адреса GIF-файлов для результатов.

# Search and get GIF URLs
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'

# Get smaller/preview versions
curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'

Чтобы загрузить файл, найдите нужный GIF-файл и сохраните первый результат в локальный файл.

# Search and download the top result
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

Получите полные метаданные поиска, чтобы увидеть название, URL-адрес, превью и размеры каждого результата.

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}'

Параметры: q — это поисковый запрос (пробелы кодируются как +); limit задаёт максимальное число результатов (от 1 до 50, по умолчанию 20); key — ключ API из переменной окружения $TENOR_API_KEY; media_filter фильтрует форматы (gif, tinygif, mp4, tinymp4, webm); contentfilter задаёт уровень безопасности (off, low, medium, high); locale указывает язык (en_US, es, fr и т. д.).