Lista separada por vírgulas para indicar se o conteúdo é um adesivo ou uma imagem estática, tem áudio ou é qualquer combinação desses elementos. Se sticker e static não estiverem presentes, o conteúdo será um GIF. Um campo flags em branco significa um GIF sem áudio.
bg_color
string
A cor de pixel de segundo plano mais comum do conteúdo
A tabela a seguir fornece detalhes sobre as propriedades dos 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 fonte de mídia do GIF de exemplo da categoria.
name
string
Nome da categoria a ser sobreposta à 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 dos 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 de 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 do 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, exceto o
loopedmp4, que o reproduz 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 com um único frame; menor que o formato GIF
Dimensões:dimensões originais do upload (sem limites)
Observações sobre o uso:faça com que esse seja o primeiro frame do conteúdo. Ela é destinada ao uso
como uma prévia em miniatura.
Esse formato é compatível com GIFs e adesivos.
gif
Resolução e tamanho:formato GIF de alta qualidade; maior tamanho de arquivo disponível
Dimensões:dimensões originais do upload (sem limites)
Observações de uso:use esse tamanho para compartilhamentos de GIF em computadores.
Esse 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 taxa de compactação muito maior
Observações de uso:use esse tamanho para prévias de GIFs em computadores.
Esse formato é compatível com GIFs e adesivos.
tinygif
Resolução e tamanho:tamanho reduzido do formato GIF
Dimensões:até 220 pixels de largura. A altura foi ajustada para preservar a proporção.
Observações de uso:use esse tamanho para prévias e compartilhamentos de GIFs em dispositivos móveis.
Esse formato é compatível com GIFs e adesivos.
nanogif
Resolução e tamanho:menor tamanho do formato GIF
Dimensões:até 90 pixels de altura. A largura foi ajustada para preservar a proporção.
Observações de uso:use esse tamanho para prévias de GIFs em dispositivos móveis.
Esse formato é compatível com GIFs e adesivos.
mp4
Resolução e tamanho:formato de vídeo de mais alta qualidade; o maior dos formatos de vídeo, mas menor que o GIF.
Dimensões:semelhante ao GIF, mas com padding para se ajustar às especificações do contêiner de vídeo, que geralmente são incrementos de 8 pixels.
Observações de uso:use esse tamanho para prévias e compartilhamentos de MP4 em computadores.
Esse formato é compatível com GIFs e adesivos.
loopedmp4
Resolução e tamanho:formato de vídeo da mais alta qualidade, maior que o MP4.
Dimensões:semelhante ao GIF, mas com padding para se ajustar às especificações do contêiner de vídeo, que geralmente são incrementos de 8 pixels.
Observações de uso:use esse tamanho para compartilhamentos em MP4 quando quiser que o videoclipe seja executado algumas vezes em vez de apenas uma.
Esse 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 de uso:use esse tamanho para prévias e compartilhamentos de MP4 em dispositivos móveis.
Esse formato é compatível com GIFs e adesivos.
nanomp4
Resolução e tamanho: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 de uso:use esse tamanho para prévias em MP4 em dispositivos móveis.
Esse formato é compatível com GIFs e adesivos.
webm
Resolução e tamanho:formato de vídeo de qualidade inferior e menor que MP4.
Dimensões:semelhante ao GIF, mas com padding para se ajustar às especificações do contêiner de vídeo, que geralmente são incrementos de 8 pixels.
Observações de uso:use esse tamanho para prévias e compartilhamentos do WebM em computadores.
Esse 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 de uso:use esse tamanho para compartilhamentos de GIF em dispositivos móveis.
Esse formato é compatível com GIFs e adesivos.
nanowebm
Resolução e tamanho: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 de uso:use esse tamanho para prévias de GIFs em dispositivos móveis.
Esse formato é compatível com GIFs e adesivos.
webp_transparent
Resolução e tamanho:formato de adesivo WebP de alta qualidade; maior tamanho de arquivo disponível
Dimensões:dimensões originais do upload (sem limites)
Observações de uso:use esse tamanho para compartilhamentos de adesivos para usuários de alta largura de banda.
Esse 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 de uso:use esse tamanho para prévias de adesivos para usuários com alta largura de banda e
compartilhamentos para usuários com baixa largura de banda.
Esse formato é compatível com adesivos.
nanowebp_transparent
Resolução e tamanho:menor tamanho do formato de adesivo WebP; tamanho máximo de 100 KB
Dimensões:até 90 x 90 pixels, com a largura ajustada para preservar a proporção.
Observações de uso:use esse tamanho para prévias de adesivos para usuários com baixa largura de banda.
Esse formato é compatível com adesivos.
gif_transparent
Resolução e tamanho:formato de adesivo GIF de alta qualidade; maior tamanho de arquivo disponível
Dimensões:dimensões originais do upload (sem limites)
Observações de uso:use esse tamanho para compartilhamentos de adesivos para usuários de alta largura de banda.
Esse 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 ajustada para preservar a proporção.
Observações de uso:use esse tamanho para prévias de adesivos para usuários com alta largura de banda e
compartilhamentos para usuários com baixa largura de banda.
Esse formato é compatível com adesivos.
nanogif_transparent
Resolução e tamanho:menor tamanho do formato de adesivo GIF; tamanho máximo de 100 KB
Dimensões:até 90 x 90 pixels, com a largura ajustada para preservar a proporção.
Observações de uso:use esse tamanho para prévias de adesivos para usuários com baixa largura de banda.
Esse formato é compatível com adesivos.
Práticas recomendadas
Em dispositivos móveis, use os arquivos nano ou minúsculos para visualizações e os arquivos minúsculos para
compartilhamentos.
Defina o parâmetro media_filter como os formatos que você pretende usar. Isso pode reduzir o tamanho da resposta da API em 70%.
Tamanhos de formato
O tamanho do arquivo de cada formato de conteúdo depende das dimensões e da duração do GIF específico
selecionado. Portanto, considere as médias e medianas fornecidas na tabela a seguir como diretrizes gerais, não valores exatos.
Formato do arquivo
Tamanho médio do arquivo (KB)
Tamanho mediano 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 do Tenor retorna erros com os códigos de resposta HTTP 4xx ou 5xx e no formato padrão de erro da API do Google. Para detalhes, consulte
Erros.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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"]]
