GIF 搜索
使用 curl 從 Tenor 搜索並下載 GIF。除了 curl 和 jq 之外無需其他依賴項。適用於查找反應類 GIF、創建視覺內容以及在聊天中發送 GIF。
技能元數據
| 來源 | 捆綁（默認安裝） |
| 路徑 | skills/media/gif-search |
| 版本 | 1.1.0 |
| 作者 | Hermes Agent |
| 許可證 | MIT |
| 標籤 | GIF, Media, Search, Tenor, API |
參考：完整 SKILL.md
信息
以下是 Hermes 在觸發此技能時加載的完整技能定義。這是技能激活時代理所看到的指令。
GIF 搜索（Tenor API）
使用 curl 通過 Tenor API 直接搜索和下載 GIF。無需額外工具。
設置
在環境中設置你的 Tenor API 密鑰（添加到 ~/.hermes/.env）：
TENOR_API_KEY=your_key_here
在 https://developers.google.com/tenor/guides/quickstart 獲取免費 API 密鑰 — Google Cloud Console Tenor API 密鑰是免費的，且具有寬鬆的速率限制。
前置條件
curl和jq（macOS/Linux 上均標配）TENOR_API_KEY環境變量
搜索 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
獲取完整元數據
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 參數
| 參數 | 描述 |
|---|---|
q | 搜索查詢（將空格 URL 編碼為 +） |
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 等 |
可用媒體格式
每個結果在 .media_formats 下都有多種格式：
| 格式 | 用例 |
|---|---|
gif | 全質量 GIF |
tinygif | 小預覽 GIF |
mp4 | 視頻版本（文件大小更小） |
tinymp4 | 小預覽視頻 |
webm | WebM 視頻 |
nanogif | 微型縮略圖 |
注意事項
- 對查詢進行 URL 編碼：空格編碼為
+，特殊字符編碼為%XX - 若在聊天中發送，
tinygifURL 更輕量 - GIF URL 可直接在 markdown 中使用：
