Список, разделённый запятыми, указывает, является ли содержимое наклейкой или статическим изображением, содержит ли оно звук или представляет собой любую их комбинацию. Если sticker и static отсутствуют, то это GIF-файл. Пустое поле flags означает, что GIF-файл без звука.
bg_color
string
Наиболее распространенный цвет фонового пикселя контента
В следующей таблице приведены подробные сведения о свойствах объектов категории:
Характеристики
searchterm
string
Поисковый запрос, соответствующий категории. Поисковый запрос переводится в соответствии с locale соответствующего запроса.
path
string
URL-адрес поиска, который будет запрошен, если пользователь выберет категорию
image
string
URL-адрес источника медиа для примера GIF-изображения категории
name
string
Название категории для наложения на изображение. Название переводится в соответствии с locale соответствующего запроса.
Медиа-объект
В следующей таблице приведены подробные сведения о свойствах медиа-объектов:
Характеристики
url
string
URL-адрес источника медиа
dims
int[]
Ширина и высота медиа-контента в пикселях
duration
float
Представляет время в секундах для одного цикла воспроизведения контента. Если контент статический, длительность устанавливается равной 0 .
size
int
Размер файла в байтах
Форматы контента
API Tenor предлагает следующие пять базовых форматов различных размеров:
GIF
МП4
ВебМ
Прозрачный WebP
Прозрачный GIF
Форматы MP4 и WebM воспроизводят клип только один раз, за исключением loopedmp4 , в котором клип воспроизводится несколько раз. Формат GIF воспроизводит клип непрерывно. Прозрачные форматы предназначены для контента с наклейками и не отображаются в результатах поиска GIF.
Типы форматов
В следующей таблице приведены подробные данные о доступных типах форматов медиа для Tenor:
Типы форматов
preview
Разрешение и размер: высококачественный однокадровый формат GIF; меньше по размеру, чем формат GIF
Размеры: Исходные размеры загрузки (без ограничений)
Примечания к использованию: Сделайте этот кадр первым. Он предназначен для использования в качестве миниатюры для предварительного просмотра.
Этот формат поддерживается для GIF-файлов и наклеек.
gif
Разрешение и размер: высококачественный формат GIF; самый большой доступный размер файла
Размеры: Исходные размеры загрузки (без ограничений)
Примечания по использованию: Используйте этот размер для публикации GIF-файлов на рабочем столе.
Этот формат поддерживается для GIF-файлов и наклеек.
mediumgif
Разрешение и размер: Небольшое уменьшение размера формата GIF.
Размеры: Исходные размеры загрузки (без ограничений), но гораздо более высокая степень сжатия.
Примечания по использованию: Используйте этот размер для предварительного просмотра GIF-файлов на настольном компьютере.
Этот формат поддерживается для GIF-файлов и наклеек.
tinygif
Разрешение и размер: Уменьшенный размер формата GIF
Размеры: до 220 пикселей в ширину. Высота масштабируется для сохранения соотношения сторон.
Примечания по использованию: Используйте этот размер для предпросмотра GIF-файлов и публикации их на мобильных устройствах.
Этот формат поддерживается для GIF-файлов и наклеек.
nanogif
Разрешение и размер: Наименьший размер формата GIF.
Размеры: высота до 90 пикселей. Ширина масштабируется для сохранения соотношения сторон.
Примечания по использованию: Используйте этот размер для предварительного просмотра GIF-файлов на мобильных устройствах.
Этот формат поддерживается для GIF-файлов и наклеек.
mp4
Разрешение и размер: видеоформат самого высокого качества; самый большой из видеоформатов, но меньше, чем GIF
Размеры: аналогичны GIF, но дополнены в соответствии со спецификациями контейнера видео, которые обычно имеют шаг в 8 пикселей.
Примечания по использованию: Используйте этот размер для предварительного просмотра в формате MP4 и публикации на рабочем столе.
Этот формат поддерживается для GIF-файлов и наклеек.
loopedmp4
Разрешение и размер: видеоформат наивысшего качества; больше по размеру, чем MP4
Размеры: аналогичны GIF, но дополнены в соответствии со спецификациями контейнера видео, которые обычно имеют шаг в 8 пикселей.
Примечания по использованию: Используйте этот размер для файлов MP4, если вы хотите, чтобы видеоклип воспроизводился несколько раз, а не один раз.
Этот формат поддерживается для GIF-файлов и наклеек.
tinymp4
Разрешение и размер: Уменьшенный размер формата MP4
Размеры: переменная ширина и высота, максимальный размер ограничивающего прямоугольника 320x320 пикселей.
Примечания по использованию: используйте этот размер для предпросмотра и публикации файлов MP4 на мобильных устройствах.
Этот формат поддерживается для GIF-файлов и наклеек.
nanomp4
Разрешение и размер: Наименьший размер формата MP4.
Размеры: переменная ширина и высота, максимальный размер ограничивающей рамки 150x150 пикселей.
Примечания по использованию: используйте этот размер для предварительного просмотра MP4 на мобильных устройствах.
Этот формат поддерживается для GIF-файлов и наклеек.
webm
Разрешение и размер: Видеоформат более низкого качества; меньше по размеру, чем MP4
Размеры: аналогичны GIF, но дополнены в соответствии со спецификациями контейнера видео, которые обычно имеют шаг в 8 пикселей.
Примечания по использованию: используйте этот размер для предварительного просмотра WebM и публикации на рабочем столе.
Этот формат поддерживается для GIF-файлов и наклеек.
tinywebm
Разрешение и размер: Уменьшенный размер формата WebM
Размеры: переменная ширина и высота, максимальный размер ограничивающего прямоугольника 320x320 пикселей.
Примечания по использованию: Используйте этот размер для публикации GIF-файлов на мобильных устройствах.
Этот формат поддерживается для GIF-файлов и наклеек.
nanowebm
Разрешение и размер: Наименьший размер формата WebM
Размеры: переменная ширина и высота, максимальный размер ограничивающей рамки 150x150 пикселей.
Примечания по использованию: Используйте этот размер для предварительного просмотра GIF-файлов на мобильных устройствах.
Этот формат поддерживается для GIF-файлов и наклеек.
webp_transparent
Разрешение и размер: высококачественный формат наклейки WebP; самый большой доступный размер файла
Размеры: Исходные размеры загрузки (без ограничений)
Примечания по использованию: Используйте этот размер для обмена наклейками для пользователей с высокой пропускной способностью.
Этот формат поддерживается для наклеек.
tinywebp_transparent
Разрешение и размер: Уменьшенный размер стикера формата WebP; максимальный размер 500 КБ.
Размеры: до 220x220 пикселей, высота масштабируется для сохранения соотношения сторон.
Примечания по использованию: Используйте этот размер для предварительного просмотра наклеек для пользователей с высокой пропускной способностью и для общих файлов для пользователей с низкой пропускной способностью.
Этот формат поддерживается для наклеек.
nanowebp_transparent
Разрешение и размер: минимальный размер наклейки формата WebP; максимальный размер 100 КБ.
Размеры: до 90x90 пикселей, ширина масштабируется для сохранения соотношения сторон.
Примечания по использованию: Используйте этот размер для предварительного просмотра наклеек для пользователей с низкой пропускной способностью.
Этот формат поддерживается для наклеек.
gif_transparent
Разрешение и размер: высококачественный формат наклейки GIF; самый большой доступный размер файла
Размеры: Исходные размеры загрузки (без ограничений)
Примечания по использованию: Используйте этот размер для обмена наклейками для пользователей с высокой пропускной способностью.
Этот формат поддерживается для наклеек.
tinygif_transparent
Разрешение и размер: Уменьшенный размер стикера GIF; максимальный размер 500 КБ.
Размеры: до 220x220 пикселей, высота масштабируется для сохранения соотношения сторон.
Примечания по использованию: Используйте этот размер для предварительного просмотра наклеек для пользователей с высокой пропускной способностью и для общих файлов для пользователей с низкой пропускной способностью.
Этот формат поддерживается для наклеек.
nanogif_transparent
Разрешение и размер: минимальный размер стикера GIF; максимальный размер 100 КБ.
Размеры: до 90x90 пикселей, ширина масштабируется для сохранения соотношения сторон.
Примечания по использованию: Используйте этот размер для предварительного просмотра наклеек для пользователей с низкой пропускной способностью.
Этот формат поддерживается для наклеек.
Лучшие практики
Для мобильных устройств используйте файлы nano- или крошечного размера для предварительного просмотра, а файлы крошечного размера — для общего доступа.
Задайте параметр media_filter в соответствии с форматами, которые вы планируете использовать. Это может сократить размер ответа API на 70%.
Размеры формата
Размер файла для каждого формата контента зависит от параметров и длины выбранного GIF-изображения. Поэтому средние значения и медианы, представленные в следующей таблице, следует рассматривать как общие рекомендации, а не как точные значения.
Формат файла
Средний размер файла (КБ)
Средний размер файла (КБ)
gif
3,356
956
mediumgif
2,548
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
Коды ответов
В следующей таблице приведены коды ответа статуса HTTP, используемые для указания успешного запроса:
HTTP-код статуса
200 или 202
ОК или принято
Ошибки
API Tenor возвращает ошибки с кодами HTTP-ответов 4xx или 5xx в стандартном формате ошибок Google API. Подробнее см. в разделе «Ошибки» .
[null,null,["Последнее обновление: 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"]]
