Pesquisa de GIF (API Tenor)
Pesquise e baixe GIFs diretamente via API do Tenor usando curl. Nenhuma ferramenta extra necessária.
Quando usar
Útil para encontrar GIFs de reação, criar conteúdo visual e enviar GIFs em conversas.
Configuração
Defina sua chave de API do Tenor nas variáveis de ambiente (adicione a ${HERMES_HOME:-~/.hermes}/.env):
TENOR_API_KEY=sua_chave_aqui
Obtenha uma chave de API gratuita em https://developers.google.com/tenor/guides/quickstart — a chave de API do Tenor no Google Cloud Console é gratuita e tem limites generosos de requisição.
Pré-requisitos
curlejq(ambos padrão no macOS/Linux)- Variável de ambiente
TENOR_API_KEY
Pesquisar GIFs
# Pesquisar e obter URLs de GIF
curl -s "https://tenor.googleapis.com/v2/search?q=joinha&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'
# Obter versões menores/pré-visualização
curl -s "https://tenor.googleapis.com/v2/search?q=bom+trabalho&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'
Baixar um GIF
# Pesquisar e baixar o melhor resultado
URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=celebração&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url')
curl -sL "$URL" -o celebracao.gif
Obter Metadados Completos
curl -s "https://tenor.googleapis.com/v2/search?q=gato&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}'
Parâmetros da API
| Parâmetro | Descrição |
|---|---|
q | Consulta de pesquisa (codificar espaços como +) |
limit | Máximo de resultados (1-50, padrão 20) |
key | Chave de API (da variável $TENOR_API_KEY) |
media_filter | Filtrar formatos: gif, tinygif, mp4, tinymp4, webm |
contentfilter | Segurança: off, low, medium, high |
locale | Idioma: en_US, es, fr, etc. |
Formatos de Mídia Disponíveis
Cada resultado possui múltiplos formatos em .media_formats:
| Formato | Caso de uso |
|---|---|
gif | GIF em qualidade total |
tinygif | GIF pequeno de pré-visualização |
mp4 | Versão em vídeo (tamanho de arquivo menor) |
tinymp4 | Vídeo pequeno de pré-visualização |
webm | Vídeo WebM |
nanogif | Miniatura muito pequena |
Notas
- Codifique a consulta na URL: espaços como
+, caracteres especiais como%XX - Para enviar em conversas, URLs
tinygifsão mais leves - URLs de GIF podem ser usados diretamente em markdown:
