Objetos e erros de resposta

Nesta página, você verá informações sobre os diferentes objetos de resposta e de erro JSON usados pela API Tenor.

Objeto de resposta

A tabela a seguir fornece detalhes sobre as propriedades de objetos de resposta:

Propriedades
created

float

Um timestamp Unix que representa quando esta postagem foi criada.
hasaudio

boolean

Retornará true se esta postagem contiver áudio.
id

string

Identificador de resultado do Tenor
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

Um dicionário com um formato de conteúdo como a chave e um objeto de mídia como o valor.
tags

string[]

Uma matriz de tags para a postagem
title

string

O título da postagem
content_description

string

Uma descrição textual do conteúdo.

Recomendamos que você use content_description para recursos de acessibilidade do usuário.
itemurl

string

O URL completo para ver a postagem em tenor.com.
hascaption

boolean

Retornará true se esta postagem contiver legendas.
flags

string

Lista separada por vírgulas para indicar se o conteúdo é um adesivo ou uma imagem estática, tem áudio ou é uma combinação deles. Se sticker e static não estiverem presentes, o conteúdo é um GIF. Um campo flags em branco significa um GIF sem áudio.
bg_color

string

A cor de pixel mais comum do conteúdo
url

string

Um URL curto para ver a postagem em tenor.com.

Objeto de categoria

A tabela a seguir fornece detalhes sobre as propriedades de objetos de categoria:

Propriedades
searchterm

string

O termo de pesquisa que corresponde à categoria. O termo de pesquisa é traduzido para corresponder ao locale da solicitação correspondente.
path

string

O URL de pesquisa a ser solicitado se o usuário selecionar a categoria
image

string

Um URL para a origem de mídia do GIF de exemplo da categoria
name

string

Nome da categoria a ser sobreposta na imagem. O nome é traduzido para corresponder ao locale da solicitação correspondente.

Objeto de mídia

A tabela a seguir fornece detalhes sobre as propriedades de objetos de mídia:

Propriedades
url

string

Um URL para a fonte de mídia
dims

int[]

Largura e altura da mídia em pixels
duration

float

Representa o tempo em segundos para um loop do conteúdo. Se o conteúdo for estático, a duração será definida como 0.
size

int

Tamanho do arquivo em bytes

Formatos de conteúdo

A API Tenor oferece os cinco formatos básicos a seguir em vários tamanhos:

  • GIF
  • MP4
  • WebM
  • WebP transparente
  • GIF transparente

Os formatos MP4 e WebM reproduzem o clipe apenas uma vez, com exceção do loopedmp4, que reproduz o clipe algumas vezes. O formato GIF reproduz o clipe em um loop contínuo. Os formatos transparentes são para conteúdo de adesivos e não estão disponíveis nos resultados da pesquisa de GIFs.

Tipos de formato

A tabela a seguir fornece detalhes sobre os tipos de formato de mídia disponíveis para o Tenor:

Tipos de formato
preview
  • Resolução e tamanho: formato GIF de alta qualidade para quadro único; menor que o formato GIF
  • Dimensões: dimensões originais do upload (sem limites)
  • Observações sobre o uso: coloque-o no primeiro frame do conteúdo. Ele se destina ao uso como uma visualização de miniatura.

Este formato é compatível com GIFs e adesivos.
gif
  • Resolução e tamanho: formato GIF de alta qualidade. O maior tamanho de arquivo disponível
  • Dimensões: dimensões originais do upload (sem limites)
  • Observações sobre o uso: use este tamanho para compartilhamentos de GIF em computadores.

Este formato é compatível com GIFs e adesivos.
mediumgif
  • Resolução e tamanho: pequena redução no tamanho do formato GIF
  • Dimensões: dimensões originais do upload (sem limites), mas uma taxa de compactação muito maior
  • Observações sobre o uso: use este tamanho para visualizações de GIFs em computadores.

Este formato é compatível com GIFs e adesivos.
tinygif
  • Resolução e tamanho: tamanho reduzido do formato GIF
  • Dimensões:até 220 pixels de largura. Altura dimensionada para preservar a proporção.
  • Observações sobre o uso: use esse tamanho para visualizações e compartilhamentos de GIFs em dispositivos móveis.

Este formato é compatível com GIFs e adesivos.
nanogif
  • Resolução e tamanho: o menor tamanho do formato GIF
  • Dimensões:até 90 pixels de altura. Largura dimensionada para preservar a proporção.
  • Observações sobre o uso: use esse tamanho para visualizações de GIFs em dispositivos móveis.

Este formato é compatível com GIFs e adesivos.
mp4
  • Resolução e tamanho: o formato de vídeo de maior qualidade. Ele é o maior dos formatos de vídeo, mas é menor que o GIF
  • Dimensões: semelhante ao GIF, mas preenchido para atender às especificações do contêiner de vídeo, que geralmente são incrementos de 8 pixels.
  • Observações sobre o uso: use este tamanho para visualizações e compartilhamentos de MP4 no computador.

Este formato é compatível com GIFs e adesivos.
loopedmp4
  • Resolução e tamanho:formato de vídeo com a maior qualidade e maior que MP4
  • Dimensões: semelhante ao GIF, mas preenchido para atender às especificações do contêiner de vídeo, que geralmente são incrementos de 8 pixels.
  • Observações sobre o uso: use esse tamanho para compartilhamentos de MP4 quando você quiser que o clipe de vídeo seja executado algumas vezes, em vez de apenas uma.

Este formato é compatível com GIFs e adesivos.
tinymp4
  • Resolução e tamanho: tamanho reduzido do formato MP4
  • Dimensões: largura e altura variáveis, com uma caixa delimitadora máxima de 320 x 320 pixels
  • Observações sobre o uso: use esse tamanho para visualizações e compartilhamentos de MP4 em dispositivos móveis.

Este formato é compatível com GIFs e adesivos.
nanomp4
  • Resolução e tamanho: o menor tamanho do formato MP4
  • Dimensões: largura e altura variáveis, com uma caixa delimitadora máxima de 150 x 150 pixels
  • Observações sobre o uso: use esse tamanho para visualizações em MP4 em dispositivos móveis.

Este formato é compatível com GIFs e adesivos.
webm
  • Resolução e tamanho:formato de vídeo com qualidade inferior, menor que MP4
  • Dimensões: semelhante ao GIF, mas preenchido para atender às especificações do contêiner de vídeo, que geralmente são incrementos de 8 pixels.
  • Observações sobre o uso: use este tamanho para visualizações e compartilhamentos do WebM em computadores.

Este formato é compatível com GIFs e adesivos.
tinywebm
  • Resolução e tamanho: tamanho reduzido do formato WebM
  • Dimensões: largura e altura variáveis, com uma caixa delimitadora máxima de 320 x 320 pixels
  • Observações sobre o uso: use esse tamanho para compartilhamentos de GIFs em dispositivos móveis.

Este formato é compatível com GIFs e adesivos.
nanowebm
  • Resolução e tamanho: o menor tamanho do formato WebM
  • Dimensões: largura e altura variáveis, com uma caixa delimitadora máxima de 150 x 150 pixels
  • Observações sobre o uso: use esse tamanho para visualizações de GIFs em dispositivos móveis.

Este formato é compatível com GIFs e adesivos.
webp_transparent
  • Resolução e tamanho: formato de adesivo WebP de alta qualidade. O maior tamanho de arquivo está disponível
  • Dimensões: dimensões originais do upload (sem limites)
  • Observações sobre o uso: use esse tamanho para compartilhar adesivos para usuários com largura de banda alta.

Este formato é compatível com adesivos.
tinywebp_transparent
  • Resolução e tamanho: tamanho reduzido do formato de adesivo WebP; tamanho máximo de 500 KB
  • Dimensões:até 220 x 220 pixels, altura dimensionada para preservar a proporção.
  • Observações sobre o uso: use esse tamanho para visualizações de adesivos para usuários de alta largura de banda e compartilhamentos para usuários de baixa largura de banda.

Este formato é compatível com adesivos.
nanowebp_transparent
  • Resolução e tamanho: o menor tamanho do formato de adesivo WebP; tamanho máximo de 100 KB
  • Dimensões:até 90 x 90 pixels, com a largura dimensionada para preservar a proporção.
  • Observações sobre o uso: use esse tamanho para visualizações de adesivos para usuários com largura de banda baixa.

Este formato é compatível com adesivos.
gif_transparent
  • Resolução e tamanho: formato de adesivo GIF de alta qualidade. O maior tamanho de arquivo está disponível
  • Dimensões: dimensões originais do upload (sem limites)
  • Observações sobre o uso: use esse tamanho para compartilhar adesivos para usuários com largura de banda alta.

Este formato é compatível com adesivos.
tinygif_transparent
  • Resolução e tamanho: tamanho reduzido do formato de adesivo GIF; tamanho máximo de 500 KB
  • Dimensões:até 220 x 220 pixels, com a altura dimensionada para preservar a proporção.
  • Observações sobre o uso: use esse tamanho para visualizações de adesivos para usuários de alta largura de banda e compartilhamentos para usuários de baixa largura de banda.

Este formato é compatível com adesivos.
nanogif_transparent
  • Resolução e tamanho: o menor tamanho do formato de adesivo GIF; tamanho máximo de 100 KB
  • Dimensões:até 90 x 90 pixels, com a largura dimensionada para preservar a proporção.
  • Observações sobre o uso: use esse tamanho para visualizações de adesivos para usuários com largura de banda baixa.

Este formato é compatível com adesivos.

Práticas recomendadas

  • Para dispositivos móveis, use os arquivos nano ou tiny para visualizações e os arquivos de tamanho pequeno para compartilhamentos.
  • Defina o parâmetro media_filter para os formatos que você pretende usar. Isso pode reduzir o tamanho da resposta da API em 70%.

Tamanhos de formato

O tamanho do arquivo para cada formato de conteúdo depende das dimensões e da duração do GIF específico selecionado. Portanto, considere as médias e as médias fornecidas na tabela a seguir como diretrizes gerais em vez de valores rígidos.

Formato do arquivo Tamanho médio do arquivo (KB) Tamanho médio do arquivo (KB)
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

Códigos de resposta

A tabela a seguir fornece os códigos de resposta de status HTTP usados para indicar uma solicitação bem-sucedida:

Código de status HTTP
200 ou 202 OK ou aceito

Erros

A API Tenor retorna erros com os códigos de resposta HTTP 4xx ou 5xx e no formato de erro padrão da API do Google. Para detalhes, consulte Erros.