Objetos de respuesta y errores

En esta página, se proporciona información sobre los diferentes objetos de error y respuesta JSON que utiliza 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

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

boolean

Devuelve true si esta publicación contiene audio.
id

string

Identificador del resultado de Tenor
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

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

string[]

Es un array de etiquetas para la entrada.
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 del usuario.
itemurl

string

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

boolean

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

string

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

string

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

string

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

Objeto Category

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

Es la URL de búsqueda que se solicitará si el usuario selecciona la categoría.
image

string

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

string

Es el nombre de la categoría que se superpondrá en la imagen. El nombre se traduce para que coincida con el locale de la solicitud correspondiente.

Objeto de medios

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

Propiedades
url

string

URL de la fuente de contenido multimedia
dims

int[]

Ancho y altura del contenido multimedia en píxeles
duration

float

Representa el tiempo en segundos de 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 básicos en una variedad de tamaños:

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

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

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: Formato GIF de un solo fotograma de alta calidad; más pequeño que el formato GIF
  • Dimensiones: Dimensiones de carga originales (sin límites)
  • Notas de uso: Haz que este sea el primer fotograma del contenido. Está diseñada para usarse como vista previa de la miniatura.

Este formato es compatible con GIFs y calcomanías.
gif
  • Resolución y tamaño: Formato GIF de alta calidad; el tamaño de archivo más grande disponible
  • Dimensiones: Dimensiones de carga originales (sin límites)
  • Notas de uso: Usa este tamaño para compartir GIFs en computadoras.

Este formato es compatible con GIFs y calcomanías.
mediumgif
  • Resolución y tamaño: Se redujo ligeramente el tamaño del formato GIF.
  • Dimensiones: Dimensiones de carga originales (sin límites), pero con una tasa de compresión mucho más alta
  • Notas de uso: Usa este tamaño para las vistas previas de GIF en computadoras.

Este formato es compatible con GIFs y calcomanías.
tinygif
  • Resolución y tamaño: Se redujo el tamaño del formato GIF.
  • Dimensiones: Hasta 220 píxeles de ancho. Altura ajustada para conservar la relación de aspecto.
  • Notas de uso: Usa este tamaño para las vistas previas y el uso compartido de GIFs en dispositivos móviles.

Este formato es compatible con GIFs 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 El ancho se ajusta para conservar la relación de aspecto.
  • Notas de uso: Usa este tamaño para las vistas previas de GIF en dispositivos móviles.

Este formato es compatible con GIFs y calcomanías.
mp4
  • Resolución y tamaño: Es el formato de video de mayor calidad y el más grande de los formatos de video, pero más pequeño que el GIF.
  • Dimensiones: Similar a los GIFs, pero con relleno 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 las vistas previas y el contenido compartido en MP4 en computadoras.

Este formato es compatible con GIFs y calcomanías.
loopedmp4
  • Resolución y tamaño: Es el formato de video de mayor calidad y tiene un tamaño mayor que el MP4.
  • Dimensiones: Similar a los GIFs, pero con relleno 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 videos compartidos en formato MP4 cuando quieras que el clip de video se ejecute varias veces en lugar de solo una.

Este formato es compatible con GIFs y calcomanías.
tinymp4
  • Resolución y tamaño: Tamaño reducido del formato MP4
  • Dimensiones: Ancho y altura variables, con un cuadro delimitador máximo de 320 × 320 píxeles
  • Notas de uso: Usa este tamaño para las vistas previas y el contenido compartido en formato MP4 en dispositivos móviles.

Este formato es compatible con GIFs 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 delimitador máximo de 150 x 150 píxeles
  • Notas de uso: Usa este tamaño para las vistas previas en MP4 en dispositivos móviles.

Este formato es compatible con GIFs y calcomanías.
webm
  • Resolución y tamaño: Formato de video de menor calidad y tamaño que el MP4
  • Dimensiones: Similar a los GIFs, pero con relleno 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 las vistas previas y el contenido compartido de WebM en computadoras.

Este formato es compatible con GIFs y calcomanías.
tinywebm
  • Resolución y tamaño: Tamaño reducido del formato WebM
  • Dimensiones: Ancho y alto variables, con un cuadro delimitador máximo de 320 × 320 píxeles
  • Notas de uso: Usa este tamaño para compartir GIFs en dispositivos móviles.

Este formato es compatible con GIFs 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 delimitador máximo de 150 x 150 píxeles
  • Notas de uso: Usa este tamaño para las vistas previas de GIF en dispositivos móviles.

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

Este formato es compatible con las calcomanías.
tinywebp_transparent
  • Resolución y tamaño: Tamaño reducido del formato de calcomanía WebP; tamaño máximo de 500 KB
  • Dimensiones: Hasta 220 × 220 píxeles, con la altura ajustada para conservar la relación de aspecto.
  • Notas de uso: Usa este tamaño para las vistas previas de calcomanías para los usuarios con un ancho de banda alto y para los recursos compartidos para los usuarios con un 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 proporción de aspecto.
  • Notas de uso: Usa este tamaño para las vistas previas de calcomanías para los usuarios con poco ancho de banda.

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

Este formato es compatible con las calcomanías.
tinygif_transparent
  • Resolución y tamaño: Tamaño reducido del formato de calcomanía en GIF; tamaño máximo de 500 KB
  • Dimensiones: Hasta 220 × 220 píxeles, con la altura ajustada para conservar la relación de aspecto.
  • Notas de uso: Usa este tamaño para las vistas previas de calcomanías para los usuarios con un ancho de banda alto y para los recursos compartidos para los usuarios con un ancho de banda bajo.

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

Este formato es compatible con las calcomanías.

Prácticas recomendadas

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

Tamaños de formato

El tamaño de archivo de cada formato de contenido depende de las dimensiones y la duración del GIF específico seleccionado. Por lo tanto, considera las medias y las medianas que se proporcionan en la siguiente tabla como lineamientos generales y no como valores exactos.

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

Código de estado HTTP
200 o 202 Aceptar

Errores

La API de Tenor devuelve 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 información, consulta Errores.