GIF 검색 (Tenor API)
curl을 사용하여 Tenor API를 통해 GIF를 직접 검색하고 다운로드합니다. 추가 도구가 필요 없습니다.
사용 시기
반응 GIF를 찾거나, 시각 콘텐츠를 만들거나, 채팅에서 GIF를 보낼 때 유용합니다.
설정
환경 변수에 Tenor API 키를 설정하세요 (${HERMES_HOME:-~/.hermes}/.env에 추가):
TENOR_API_KEY=your_key_here
Google Cloud Console Tenor API 키는 https://developers.google.com/tenor/guides/quickstart 에서 무료로 받을 수 있습니다. 무료이며 generous한 요청 한도를 제공합니다.
필수 조건
curl과jq(macOS/Linux에 기본 포함)TENOR_API_KEY환경 변수
GIF 검색하기
# 검색 결과에서 GIF URL 가져오기
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 파라미터
| 파라미터 | 설명 |
|---|---|
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은 마크다운에서 직접 사용 가능:
