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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2023-07-11 (UTC)"],[[["This documentation details the JSON response and error objects for the Tenor API, including properties for responses, categories, and media objects."],["It outlines available content formats (GIF, MP4, WebM, WebP, GIF) and types (preview, gif, mediumgif, tinygif, etc.), providing size and usage recommendations."],["The document offers best practices like using nano or tiny files for mobile previews and the `media_filter` parameter for reducing response size."],["It includes information on response codes (200, 202) indicating successful requests and standard Google API error formats for unsuccessful ones."]]],["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"]]
