Объекты ответа и ошибки

На этой странице представлена информация о различных объектах ответов и ошибок JSON, используемых API Tenor.

Объект ответа

В следующей таблице приведены подробные сведения о свойствах объектов ответа:

Характеристики
created

float

Метка времени Unix, указывающая, когда была создана эта запись.

hasaudio

boolean

Возвращает true если эта запись содержит аудио.

id

string

Идентификатор результата тенора

media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

Словарь, в котором ключом является формат контента , а значением — медиа-объект .

tags

string[]

Массив тегов для поста

title

string

Название поста

content_description

string

Текстовое описание содержания.

Мы рекомендуем использовать content_description для функций доступности для пользователей.

itemurl

string

Полный URL для просмотра поста на tenor.com .

hascaption

boolean

Возвращает true если эта запись содержит подписи.

flags

string

Список, разделённый запятыми, указывает, является ли содержимое наклейкой или статическим изображением, содержит ли оно звук или представляет собой любую их комбинацию. Если sticker и static отсутствуют, то это GIF-файл. Пустое поле flags означает, что GIF-файл без звука.

bg_color

string

Наиболее распространенный цвет фонового пикселя контента

url

string

Короткий URL для просмотра поста на tenor.com .

Категория объекта

В следующей таблице приведены подробные сведения о свойствах объектов категории:

Характеристики
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. Подробнее см. в разделе «Ошибки» .