SuperAPI AI 工具集

gif-search

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:使用 curl 调用 Tenor API 搜索和下载 GIF,无需额外工具,适合查找反应类 GIF、制作视觉内容或在聊天中发送动图。

配置:在环境变量文件(${HERMES_HOME:-~/.hermes}/.env)中设置 TENOR_API_KEY=your_key_here。可在 Tenor 快速入门页面获取免费 API key,该 key 免费且速率限制较宽松。前置要求为 curl 与 jq(macOS/Linux 通常自带)以及 TENOR_API_KEY 环境变量。

搜索:调用 https://tenor.googleapis.com/v2/search,示例:curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'。获取较小预览版可改用 .media_formats.tinygif.url。

下载:先取搜索结果 URL,再下载,示例: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。

元数据:可用 jq 提取 title、gif url、tinygif 预览与 dimensions。

参数:q(查询,空格需 URL 编码为 +)、limit(1-50,默认 20)、key、media_filter(gif、tinygif、mp4、tinymp4、webm)、contentfilter(off、low、medium、high)、locale。媒体格式包括 gif(全质量)、tinygif(小预览)、mp4、tinymp4、webm、nanogif(小缩略图)。

限制与注意:查询需 URL 编码,空格用 +,特殊字符用 %XX;聊天发送建议用 tinygif 更轻量;GIF URL 可直接用于 markdown。费用、配额等细节暂未提供。