🏠 Главная › user guide › media gif search

{/ Эта страница автоматически передается из файла навыков SKILL.md с помощью сайта/scripts/generate-skill-docs.py. Редактируйте исходный SKILL.md, а не эту страницу. /}

Поиск GIF

Поиск и скачивание GIF с Tenor через curl + jq.

Метаданные навыки
Источник Встроенный (установлен по умолчанию)
Путь навыки/медиа/поиск GIF
Версия 1.1.0
Автор Агент Гермес
Лицензия Массачусетский технологический институт
Платформы Linux, MacOS, Windows
Теги GIF, Медиа, Поиск, Тенор, API

Справочник: полный SKILL.md:::информация

Ниже приведено полное описание навыка, который загружает Hermes при активации этого навыка. Это то, что агент видит в качестве инструкций, когда навыки активны.

Поиск GIF (Tenor API)

Поиск и скачивание GIF напрямую через API Tenor с помощью Curl. Никаких дополнительных инструментов не требуется.

Когда использовать

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

Настройка

Установите API-ключ Tenor в переменную среду (добавьте в ~/.hermes/.env):

TENOR_API_KEY=ваш_ключ_здесь

Получите бесплатный API-ключ на https://developers.google.com/tenor/guides/quickstart — ключ API Tenor в Google Cloud Console доступен и имеет щедрые лимиты по запросу.

Предварительные требования

Поиск GIF

# Поиск и получение URL 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'

# Получить уменьшенные/предварительные версии
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

# Поиск и скачивание лучшего результата
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

Получение полных метаданных

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

API параметров

Параметр Описание
к Поисковый запрос (пробелы кодировать как +)
лимит Максимум результатов (1–50, по умолчанию 20)
ключ API-ключ (из переменного окружения $TENOR_API_KEY)
медиа_фильтр Фильтр форматов: gif, tinygif, mp4, tinymp4, webm
контентфильтр Фильтр безопасности: «выключено», «низкий», «средний», «высокий»
локаль Язык: en_US, es, fr и т.д.

Доступные форматы мультимедиа

Каждый результат имеет несколько форматов внутри .media_formats:

Формат Сценарий использования
гиф Полное качество GIF
минигиф Маленький предварительный просмотр GIF
mp4 Видеоверсия (меньший размер файла)
tinymp4 Небольшое видео для предпросмотра
вебм Видео ВебМ
наногиф Крошечная миниатюра

Примечания