Zalecamy używanie content_description w przypadku funkcji ułatwień dostępu dla użytkowników.
itemurl
string
Pełny adres URL, pod którym można wyświetlić posta na stronie tenor.com.
hascaption
boolean
Zwraca wartość true, jeśli ten post zawiera napisy.
flags
string
Lista rozdzielona przecinkami, która określa, czy treść jest naklejką, obrazem statycznym, zawiera dźwięk lub jest dowolną kombinacją tych elementów. Jeśli tagi sticker i static nie są obecne, treść jest GIF-em. Puste pole flags oznacza GIF-a bez dźwięku.
bg_color
string
Najczęstszy kolor piksela tła treści
url
string
Krótki URL, który umożliwia wyświetlenie posta na stronie tenor.com.
Obiekt kategorii
W tabeli poniżej znajdziesz szczegółowe informacje o właściwościach obiektów kategorii:
Właściwości
searchterm
string
Wyszukiwane hasło odpowiadające kategorii. Wyszukiwane hasło jest tłumaczone tak, aby pasowało do locale odpowiedniego żądania.
path
string
Adres URL wyszukiwania, o który należy poprosić, jeśli użytkownik wybierze kategorię
image
string
Adres URL źródła multimediów przykładowego GIF-a w kategorii.
name
string
Nazwa kategorii, która ma być wyświetlana na obrazie. Nazwa jest tłumaczona tak, aby pasowała do locale odpowiedniego żądania.
Obiekt multimedialny
W tabeli poniżej znajdziesz szczegółowe informacje o właściwościach obiektów multimedialnych:
Właściwości
url
string
Adres URL źródła multimediów
dims
int[]
Szerokość i wysokość multimediów w pikselach
duration
float
Reprezentuje czas w sekundach potrzebny na odtworzenie treści w pętli. Jeśli treść jest statyczna, czas trwania jest ustawiony na 0.
size
int
Rozmiar pliku w bajtach
Formaty treści
Interfejs API Tenora oferuje te 5 podstawowych formatów w różnych rozmiarach:
GIF
MP4
WebM
Przezroczysty WebP
Przezroczysty GIF
Formaty MP4 i WebM odtwarzają klip tylko raz, z wyjątkiem formatu loopedmp4, który odtwarza klip kilka razy. Format GIF odtwarza klip w nieskończonej pętli. Formaty przezroczyste są przeznaczone dla naklejek i nie są dostępne w wynikach wyszukiwania GIF-ów.
Typy formatów
W tabeli poniżej znajdziesz szczegółowe informacje o dostępnych typach formatów multimediów w przypadku Tenora:
Typy formatów
preview
Rozdzielczość i rozmiar: wysokiej jakości format GIF z jedną klatką; mniejszy niż format GIF.
Uwagi dotyczące użycia: używaj tego rozmiaru do udostępniania GIF-ów na komputerze.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
mediumgif
Rozdzielczość i rozmiar: niewielkie zmniejszenie rozmiaru formatu GIF.
Wymiary: oryginalne wymiary przesyłanego pliku (bez ograniczeń), ale znacznie wyższy współczynnik kompresji
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów GIF-ów na komputerach.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
tinygif
Rozdzielczość i rozmiar: zmniejszony rozmiar formatu GIF
Wymiary: do 220 pikseli szerokości. Wysokość została przeskalowana, aby zachować współczynnik proporcji.
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów i udostępniania GIF-ów na urządzeniach mobilnych.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
nanogif
Rozdzielczość i rozmiar: najmniejszy rozmiar formatu GIF.
Wymiary: do 90 pikseli wysokości. Szerokość została przeskalowana, aby zachować współczynnik proporcji.
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów GIF-ów na urządzeniach mobilnych.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
mp4
Rozdzielczość i rozmiar: format wideo o najwyższej jakości; największy z formatów wideo, ale mniejszy niż GIF.
Wymiary: podobne do GIF-a, ale z dodatkowym wypełnieniem, aby dopasować się do specyfikacji kontenera wideo, które zwykle są wielokrotnością 8 pikseli.
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów MP4 i udostępniania na komputerze.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
loopedmp4
Rozdzielczość i rozmiar: format wideo o najwyższej jakości, większy niż MP4.
Wymiary: podobne do GIF-a, ale z dodatkowym wypełnieniem, aby dopasować się do specyfikacji kontenera wideo, które zwykle są wielokrotnością 8 pikseli.
Uwagi dotyczące użycia: użyj tego rozmiaru w przypadku udostępniania plików MP4, gdy chcesz, aby klip wideo był odtwarzany kilka razy, a nie tylko raz.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
tinymp4
Rozdzielczość i rozmiar: zmniejszony rozmiar formatu MP4.
Wymiary: zmienna szerokość i wysokość, maksymalna ramka ograniczająca 320 x 320 pikseli
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów i udostępniania plików MP4 na urządzeniach mobilnych.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
nanomp4
Rozdzielczość i rozmiar: najmniejszy rozmiar formatu MP4
Wymiary: zmienna szerokość i wysokość, maksymalna ramka ograniczająca 150 x 150 pikseli
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów MP4 na urządzeniach mobilnych.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
webm
Rozdzielczość i rozmiar: format wideo o niższej jakości, mniejszy niż MP4.
Wymiary: podobne do GIF-a, ale z dodatkowym wypełnieniem, aby dopasować się do specyfikacji kontenera wideo, które zwykle są wielokrotnością 8 pikseli.
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów i udostępniania plików WebM na komputerach.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
tinywebm
Rozdzielczość i rozmiar: zmniejszony rozmiar formatu WebM
Wymiary: zmienna szerokość i wysokość, maksymalna ramka ograniczająca 320 x 320 pikseli
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku udostępniania GIF-ów na urządzeniach mobilnych.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
nanowebm
Rozdzielczość i rozmiar: najmniejszy rozmiar formatu WebM
Wymiary: zmienna szerokość i wysokość, maksymalna ramka ograniczająca 150 x 150 pikseli
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów GIF-ów na urządzeniach mobilnych.
Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
webp_transparent
Rozdzielczość i rozmiar: wysokiej jakości format naklejki WebP; największy dostępny rozmiar pliku.
Wymiary: do 220 x 220 pikseli, wysokość skalowana w celu zachowania współczynnika proporcji.
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów naklejek dla użytkowników o dużej przepustowości i udostępniania dla użytkowników o małej przepustowości.
Wymiary: maksymalnie 220 x 220 pikseli, przy czym wysokość jest skalowana w celu zachowania współczynnika proporcji.
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów naklejek dla użytkowników o dużej przepustowości i udostępniania dla użytkowników o małej przepustowości.
Wymiary: do 90 x 90 pikseli, przy czym szerokość jest skalowana w celu zachowania współczynnika proporcji.
Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów naklejek dla użytkowników z wolnym połączeniem internetowym.
Ten format jest obsługiwany w przypadku naklejek.
Sprawdzone metody
W przypadku urządzeń mobilnych używaj plików w rozmiarze nano lub tiny do podglądu, a plików w rozmiarze tiny do udostępniania.
Ustaw parametr media_filter na formaty, których chcesz używać. Może to zmniejszyć rozmiar odpowiedzi z interfejsu API o 70%.
Formatowanie rozmiarów
Rozmiar pliku każdego formatu treści zależy od wymiarów i długości wybranego pliku GIF. Dlatego wartości średnie i mediany podane w tabeli poniżej traktuj jako ogólne wskazówki, a nie dokładne wartości.
Format pliku
Średni rozmiar pliku (KB)
Mediana rozmiaru pliku (KB)
gif
3356
956
mediumgif
2548
574
tinygif
521
101
nanogif
175
56
mp4
207
91
loopedmp4
515
228
tinymp4
84
81
nanomp4
37
28
webm
76
61
tinywebm
57
45
nanowebm
35
25
webp_transparent
530
95
tinywebp_transparent
249
60
nanowebp_transparent
107
25
gif_transparent
643
35
tinygif_transparent
349
20
nanogif_transparent
116
10
Kody odpowiedzi
W tej tabeli znajdziesz kody stanu odpowiedzi HTTP, które wskazują, że żądanie zostało zrealizowane:
Kod stanu HTTP
200 lub 202
OK lub zaakceptowano
Błędy
Interfejs API Tenora zwraca błędy z kodami odpowiedzi HTTP 4xx lub 5xx oraz w standardowym formacie błędów interfejsu API Google. Więcej informacji znajdziesz w sekcji Błędy.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-25 UTC."],[],["The Tenor API uses JSON response objects, including Response, Category, and Media objects. Response objects contain properties like `id`, `created`, `media_formats`, and `tags`. Category objects have `searchterm`, `path`, `image`, and `name`. Media objects hold `url`, `dims`, `duration`, and `size` data. The API supports GIF, MP4, WebM, and transparent WebP/GIF formats, offering various sizes (e.g., nano, tiny, medium). Format sizes and best practices are detailed, and success is indicated by HTTP status codes 200 or 202, with errors using 4xx or 5xx codes.\n"]]
