Objetos de respuesta y errores

En esta página, se proporciona información sobre los diferentes objetos de respuesta y error de JSON que usa la API de Tenor.

Objeto de respuesta

En la siguiente tabla, se proporcionan detalles sobre las propiedades de los objetos de respuesta:

Propiedades
created

float

Una marca de tiempo de Unix que representa cuándo se creó esta publicación.
hasaudio

boolean

Muestra true si esta publicación contiene audio.
id

string

Identificador de resultados de Tenor
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

Un diccionario con un formato de contenido como clave y un objeto multimedia como valor
tags

string[]

Un array de etiquetas para la publicación
title

string

El título de la publicación
content_description

string

Es una descripción textual del contenido.

Te recomendamos que uses content_description para las funciones de accesibilidad de los usuarios.
itemurl

string

La URL completa para ver la publicación en tenor.com.
hascaption

boolean

Muestra true si esta publicación contiene subtítulos.
flags

string

Lista separada por comas para indicar si el contenido es una calcomanía o imagen estática, si tiene audio o si es una combinación de ambos. Si sticker y static no están presentes, el contenido es un GIF. Un campo flags en blanco significa un GIF sin audio.
bg_color

string

El color de píxel de fondo más común del contenido
url

string

Una URL corta para ver la publicación en tenor.com.

Objeto de categoría

En la siguiente tabla, se proporcionan detalles sobre las propiedades de los objetos de categoría:

Propiedades
searchterm

string

Es el término de búsqueda que corresponde a la categoría. El término de búsqueda se traduce para que coincida con el locale de la solicitud correspondiente.
path

string

La URL de búsqueda para solicitar si el usuario selecciona la categoría
image

string

Una URL a la fuente multimedia del GIF de ejemplo de la categoría
name

string

Nombre de la categoría que se superpone sobre la imagen El nombre se traduce para que coincida con el locale de la solicitud correspondiente.

Objeto multimedia

En la siguiente tabla, se proporcionan detalles sobre las propiedades de los objetos multimedia:

Propiedades
url

string

Una URL a la fuente de contenido multimedia
dims

int[]

Ancho y alto del contenido multimedia en píxeles
duration

float

Representa el tiempo en segundos para un bucle del contenido. Si el contenido es estático, la duración se establece en 0.
size

int

Tamaño del archivo en bytes

Formatos de contenido

La API de Tenor ofrece los siguientes cinco formatos base en una variedad de tamaños:

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

Los formatos MP4 y WebM reproducen su clip solo una vez, a excepción de loopedmp4, que reproduce el clip varias veces. El formato GIF reproduce su clip en un bucle continuo. Los formatos transparentes se usan para el contenido de calcomanías y no están disponibles en los resultados de la búsqueda de GIF.

Tipos de formato

En la siguiente tabla, se proporcionan detalles sobre los tipos de formatos de medios disponibles para Tenor:

Tipos de formato
preview
  • Resolución y tamaño: El formato GIF de un solo fotograma es de alta calidad; más pequeño que el formato GIF.
  • Dimensiones: Dimensiones originales de carga (sin límites)
  • Notas de uso: Convierte este elemento en el primer fotograma del contenido. Está diseñado para usarse como vista previa en miniatura.

Este formato es compatible con GIF y calcomanías.
gif
  • Resolución y tamaño: El formato GIF de alta calidad es el más grande disponible.
  • Dimensiones: Dimensiones originales de carga (sin límites)
  • Notas de uso: Puedes usar este tamaño para archivos GIF en computadoras de escritorio.

Este formato es compatible con GIF y calcomanías.
mediumgif
  • Resolución y tamaño: Es una pequeña reducción del tamaño del formato GIF.
  • Dimensiones: Dimensiones de carga originales (sin límites), pero mayor tasa de compresión
  • Notas de uso: Usa este tamaño para obtener vistas previas de GIF en computadoras.

Este formato es compatible con GIF y calcomanías.
tinygif
  • Resolución y tamaño: Se reduce el tamaño del formato GIF.
  • Dimensiones: hasta 220 píxeles de ancho. Altura a escala para conservar la relación de aspecto.
  • Notas de uso: Puedes usar este tamaño para obtener vistas previas de GIF y compartir en dispositivos móviles.

Este formato es compatible con GIF y calcomanías.
nanogif
  • Resolución y tamaño: El tamaño más pequeño del formato GIF
  • Dimensiones: hasta 90 píxeles de alto. Ancho a escala para conservar la relación de aspecto.
  • Notas de uso: Usa este tamaño para obtener vistas previas de GIF en dispositivos móviles.

Este formato es compatible con GIF y calcomanías.
mp4
  • Resolución y tamaño: El formato de video de mayor calidad (el mayor de los formatos de video, pero menor que el GIF)
  • Dimensiones: Son similares a los GIF, pero se ajustan para ajustarse a las especificaciones del contenedor de video, que suelen ser incrementos de 8 píxeles.
  • Notas de uso: Utiliza este tamaño para las vistas previas y el uso compartido de MP4 en computadoras de escritorio.

Este formato es compatible con GIF y calcomanías.
loopedmp4
  • Resolución y tamaño: Es el formato de video de mayor calidad y mayor tamaño que el MP4.
  • Dimensiones: Son similares a los GIF, pero se ajustan para ajustarse a las especificaciones del contenedor de video, que suelen ser incrementos de 8 píxeles.
  • Notas de uso: Usa este tamaño para los elementos compartidos MP4 cuando quieras que el clip de video se ejecute varias veces en lugar de solo una vez.

Este formato es compatible con GIF y calcomanías.
tinymp4
  • Resolución y tamaño: Se reduce el tamaño del formato MP4.
  • Dimensiones: Ancho y alto variables, con un cuadro de límite máximo de 320 x 320 píxeles
  • Notas de uso: Utiliza este tamaño para las vistas previas y el uso compartido de MP4 en dispositivos móviles.

Este formato es compatible con GIF y calcomanías.
nanomp4
  • Resolución y tamaño: El tamaño más pequeño del formato MP4
  • Dimensiones: Ancho y alto variables, con un cuadro de límite máximo de 150 x 150 píxeles
  • Notas de uso: Utiliza este tamaño para las vistas previas de MP4 en dispositivos móviles.

Este formato es compatible con GIF y calcomanías.
webm
  • Resolución y tamaño: El formato de video es de menor calidad y tiene un tamaño inferior a MP4.
  • Dimensiones: Son similares a los GIF, pero se ajustan para ajustarse a las especificaciones del contenedor de video, que suelen ser incrementos de 8 píxeles.
  • Notas de uso: Usa este tamaño para obtener vistas previas y compartir de WebM en computadoras de escritorio.

Este formato es compatible con GIF y calcomanías.
tinywebm
  • Resolución y tamaño: Se reduce el tamaño del formato WebM.
  • Dimensiones: Ancho y alto variables, con un cuadro de límite máximo de 320 x 320 píxeles.
  • Notas de uso: Puedes usar este tamaño para archivos compartidos GIF en dispositivos móviles.

Este formato es compatible con GIF y calcomanías.
nanowebm
  • Resolución y tamaño: El tamaño más pequeño del formato WebM
  • Dimensiones: Ancho y alto variables, con un cuadro de límite máximo de 150 x 150 píxeles.
  • Notas de uso: Usa este tamaño para obtener vistas previas de GIF en dispositivos móviles.

Este formato es compatible con GIF y calcomanías.
webp_transparent
  • Resolución y tamaño: Formato de calcomanías WebP de alta calidad; tamaño de archivo más grande disponible
  • Dimensiones: Dimensiones originales de carga (sin límites)
  • Notas de uso: Usa este tamaño para el uso compartido de calcomanías para usuarios de ancho de banda alto.

Este formato es compatible con las calcomanías.
tinywebp_transparent
  • Resolución y tamaño: Se reduce el tamaño del formato de calcomanía WebP; tamaño máximo de 500 KB
  • Dimensiones: Hasta 220 x 220 píxeles, con altura de escala para conservar la relación de aspecto.
  • Notas de uso: Usa este tamaño para obtener vistas previas de calcomanías para usuarios de ancho de banda alto y recursos compartidos para usuarios de ancho de banda bajo.

Este formato es compatible con las calcomanías.
nanowebp_transparent
  • Resolución y tamaño: El tamaño más pequeño del formato de calcomanía WebP; tamaño máximo de 100 KB
  • Dimensiones: Hasta 90 x 90 píxeles con el ancho ajustado para conservar la relación de aspecto.
  • Notas de uso: Utiliza este tamaño para las vistas previas de calcomanías para usuarios de ancho de banda bajo.

Este formato es compatible con las calcomanías.
gif_transparent
  • Resolución y tamaño: El formato de calcomanía de GIF de alta calidad es el tamaño de archivo más grande disponible
  • Dimensiones: Dimensiones originales de carga (sin límites)
  • Notas de uso: Usa este tamaño para el uso compartido de calcomanías para usuarios de ancho de banda alto.

Este formato es compatible con las calcomanías.
tinygif_transparent
  • Resolución y tamaño: Se reduce el tamaño del formato de calcomanía de GIF. El tamaño máximo es de 500 KB.
  • Dimensiones: Hasta 220 x 220 píxeles con la altura ajustada para conservar la relación de aspecto.
  • Notas de uso: Usa este tamaño para obtener vistas previas de calcomanías para usuarios de ancho de banda alto y recursos compartidos para usuarios de ancho de banda bajo.

Este formato es compatible con las calcomanías.
nanogif_transparent
  • Resolución y tamaño: El tamaño más pequeño del formato de calcomanía GIF; tamaño máximo de 100 KB
  • Dimensiones: Hasta 90 x 90 píxeles con el ancho ajustado para conservar la relación de aspecto.
  • Notas de uso: Utiliza este tamaño para las vistas previas de calcomanías para usuarios de ancho de banda bajo.

Este formato es compatible con las calcomanías.

Prácticas recomendadas

  • Para dispositivos móviles, usa los archivos de tamaño nano o pequeño para las vistas previas y los archivos de tamaño pequeño para los elementos compartidos.
  • Establece el parámetro media_filter en los formatos que quieres usar. Esto puede reducir el tamaño de la respuesta de la API en un 70%.

Tamaños de formato

El tamaño del archivo para cada formato de contenido depende de las dimensiones y la longitud del GIF específico seleccionado. Por lo tanto, considera los medios y las medianas proporcionados en la siguiente tabla como lineamientos generales en lugar de valores estrictos.

Formato de archivo Tamaño medio del archivo (KB) Mediana de tamaños de archivos (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 respuesta

En la siguiente tabla, se proporcionan los códigos de respuesta de estado HTTP que se usan para indicar una solicitud correcta:

Código de estado HTTP
200 o 202 Aceptable o aceptado

Errores

La API de Tenor muestra errores con los códigos de respuesta HTTP 4xx o 5xx y en el formato de error estándar de la API de Google. Para obtener más detalles, consulta Errores.