{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}
Tìm kiếm Gif
Tìm kiếm/tải xuống ảnh GIF từ Tenor thông qua Curl + jq.
Siêu dữ liệu kỹ năng
| Nguồn | Đi kèm (được cài đặt theo mặc định) |
| Đường dẫn |
skills/media/gif-search ` | | Phiên bản |
1.1.0 ` | | Tác giả | Đại lý Hermes | | Giấy phép | MIT | | Nền tảng | Linux, macOS, Windows | | Thẻ |
GIF
, `Media
, `Search
, `Tenor
,
API |
Tham khảo: đầy đủ SKILL.md
Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.
Tìm kiếm GIF (API Tenor)
Tìm kiếm và tải xuống ảnh GIF trực tiếp qua API Tenor bằng cách sử dụng Curl. Không cần thêm công cụ nào.
Khi nào nên sử dụng
Hữu ích khi tìm ảnh GIF phản ứng, tạo nội dung trực quan và gửi ảnh GIF trong cuộc trò chuyện.
Thiết lập
Đặt khóa API Tenor trong môi trường của bạn (thêm vào
~/.Hermes/.env
):
TENOR_API_KEY=your_key_here
`
``Nhận khóa API miễn phí tại https://developers.Google.com/tenor/guides/quickstart — khóa API Tenor của Google Cloud Console là miễn phí và có giới hạn tốc độ rộng rãi.
## Điều kiện tiên quyết
-
`curl
` và
`jq
` (cả hai đều là tiêu chuẩn trên macOS/Linux)
- Biến môi trường
`TENOR_API_KEY
## Tìm kiếm ảnh GIF
``` bash
# 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'
`
## Tải xuống ảnh GIF
``` bash
# 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
`
## Nhận siêu dữ liệu đầy đủ
``` bash
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}'
`
## Tham số API
| Tham số | Mô tả |
|----------||-------------|
|
`q
` | Truy vấn tìm kiếm (Không gian mã hóa URL dưới dạng
+
) |
|
`limit
` | Kết quả tối đa (1-50, mặc định 20) |
|
`key
` | Khóa API (từ
$TENOR_API_KEY
` env var) |
|
`media_filter
` | Các định dạng bộ lọc:
`gif
,
`tinygif
,
`mp4
,
`tinymp4
,
`webm
` |
|
`contentfilter
` | An toàn:
`off
,
`low
,
`medium
,
`high
` |
|
`locale
` | Ngôn ngữ:
`en_US
,
`es
,
`fr
, v.v. |
## Định dạng phương tiện có sẵn
Mỗi kết quả có nhiều định dạng theo
.media_formats
:
| Định dạng | Trường hợp sử dụng |
|--------|----------|
|
`gif
` | GIF chất lượng đầy đủ |
|
`tinygif
` | GIF xem trước nhỏ |
|
`mp4
` | Phiên bản video (kích thước tệp nhỏ hơn) |
|
`tinymp4
` | Video xem trước nhỏ |
|
`webm
` | Video WebM |
|
`nanogif
` | Hình thu nhỏ nhỏ |
## Ghi chú
- Mã hóa URL truy vấn: dấu cách là
+
, ký tự đặc biệt là
%XX
`
- Để gửi trong trò chuyện, URL
`tinygif
` có trọng lượng nhẹ hơn
- URL GIF có thể được sử dụng trực tiếp trong đánh dấu:
`