Objets de réponse et erreurs

Cette page fournit des informations sur les différents objets de réponse et d'erreur JSON utilisés par l'API Tenor.

Objet réponse

Le tableau suivant fournit des informations sur les propriétés des objets de réponse :

Propriétés
created

float

Horodatage Unix indiquant la date de création de ce post.
hasaudio

boolean

Renvoie true si ce post contient du contenu audio.
id

string

Identifiant du résultat Tenor
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

Dictionnaire avec un format de contenu comme clé et un objet multimédia comme valeur.
tags

string[]

Tableau de tags pour le post
title

string

Titre du post
content_description

string

Description textuelle du contenu.

Nous vous recommandons d'utiliser content_description pour les fonctionnalités d'accessibilité des utilisateurs.
itemurl

string

URL complète permettant d'afficher le post sur tenor.com.
hascaption

boolean

Renvoie true si ce post contient des sous-titres.
flags

string

Liste séparée par des virgules indiquant si le contenu est un autocollant ou une image statique, s'il comporte de l'audio ou toute combinaison de ces éléments. Si sticker et static ne sont pas présents, le contenu est un GIF. Un champ flags vide signifie que le GIF est sans audio.
bg_color

string

Couleur d'arrière-plan la plus courante du contenu
url

string

URL courte permettant de consulter le post sur tenor.com.

Objet "Category" (Catégorie)

Le tableau suivant fournit des informations sur les propriétés des objets de catégorie :

Propriétés
searchterm

string

Terme de recherche correspondant à la catégorie. Le terme de recherche est traduit pour correspondre au locale de la demande correspondante.
path

string

URL de recherche à demander si l'utilisateur sélectionne la catégorie
image

string

URL de la source multimédia du GIF d'exemple de la catégorie
name

string

Nom de la catégorie à superposer à l'image. Le nom est traduit pour correspondre au locale de la demande correspondante.

Objet média

Le tableau suivant fournit des informations sur les propriétés des objets multimédias :

Propriétés
url

string

URL de la source multimédia
dims

int[]

Largeur et hauteur du contenu multimédia en pixels
duration

float

Représente la durée en secondes d'une boucle de contenu. Si le contenu est statique, la durée est définie sur 0.
size

int

Taille du fichier en octets

Formats de contenu

L'API Tenor propose les cinq formats de base suivants dans différentes tailles :

  • GIF
  • MP4
  • WebM
  • WebP transparent
  • GIF transparent

Les formats MP4 et WebM ne lisent l'extrait qu'une seule fois, à l'exception de loopedmp4, qui le lit plusieurs fois. Le format GIF lit son extrait en boucle continue. Les formats transparents sont destinés aux autocollants et ne sont pas disponibles dans les résultats de recherche de GIF.

Types de formats

Le tableau suivant fournit des informations sur les types de formats multimédias disponibles pour Tenor :

Types de formats
preview
  • Résolution et taille : format GIF haute qualité à une seule image, plus petit que le format GIF
  • Dimensions : dimensions d'origine de l'importation (aucune limite)
  • Remarques sur l'utilisation : faites en sorte que ce soit le premier frame du contenu. Elle est destinée à être utilisée comme aperçu de miniature.

Ce format est compatible avec les GIF et les autocollants.
gif
  • Résolution et taille : format GIF de haute qualité, taille de fichier la plus grande possible
  • Dimensions : dimensions d'origine de l'importation (aucune limite)
  • Remarques sur l'utilisation : Utilisez cette taille pour les GIF partagés sur ordinateur.

Ce format est compatible avec les GIF et les autocollants.
mediumgif
  • Résolution et taille : légère réduction de la taille du format GIF
  • Dimensions : dimensions d'origine de l'importation (aucune limite), mais taux de compression beaucoup plus élevé
  • Remarques sur l'utilisation : utilisez cette taille pour les aperçus de GIF sur ordinateur.

Ce format est compatible avec les GIF et les autocollants.
tinygif
  • Résolution et taille : taille réduite du format GIF
  • Dimensions : jusqu'à 220 pixels de large. La hauteur est mise à l'échelle pour conserver les proportions.
  • Remarques sur l'utilisation : Utilisez cette taille pour les aperçus et les partages de GIF sur mobile.

Ce format est compatible avec les GIF et les autocollants.
nanogif
  • Résolution et taille : taille la plus petite du format GIF
  • Dimensions : jusqu'à 90 pixels de hauteur. La largeur est mise à l'échelle pour conserver les proportions.
  • Remarques sur l'utilisation : utilisez cette taille pour les aperçus de GIF sur mobile.

Ce format est compatible avec les GIF et les autocollants.
mp4
  • Résolution et taille : format vidéo de la plus haute qualité ; le plus grand des formats vidéo, mais plus petit que le GIF
  • Dimensions : semblables à celles des GIF, mais avec une marge intérieure pour s'adapter aux spécifications du conteneur vidéo, qui sont généralement des incréments de 8 pixels.
  • Remarques sur l'utilisation : utilisez cette taille pour les aperçus et les partages MP4 sur ordinateur.

Ce format est compatible avec les GIF et les autocollants.
loopedmp4
  • Résolution et taille : format vidéo de la plus haute qualité, plus volumineux que le format MP4
  • Dimensions : semblables à celles des GIF, mais avec une marge intérieure pour s'adapter aux spécifications du conteneur vidéo, qui sont généralement des incréments de 8 pixels.
  • Remarques sur l'utilisation : Utilisez cette taille pour les partages MP4 lorsque vous souhaitez que l'extrait vidéo soit lu plusieurs fois plutôt qu'une seule.

Ce format est compatible avec les GIF et les autocollants.
tinymp4
  • Résolution et taille : taille réduite du format MP4
  • Dimensions : largeur et hauteur variables, avec un cadre de délimitation maximal de 320 x 320 pixels
  • Remarques sur l'utilisation : utilisez cette taille pour les aperçus et les partages MP4 sur mobile.

Ce format est compatible avec les GIF et les autocollants.
nanomp4
  • Résolution et taille : taille la plus petite du format MP4
  • Dimensions : largeur et hauteur variables, avec un cadre de délimitation maximal de 150 x 150 pixels
  • Remarques sur l'utilisation : utilisez cette taille pour les aperçus MP4 sur mobile.

Ce format est compatible avec les GIF et les autocollants.
webm
  • Résolution et taille : format vidéo de qualité inférieure, plus petit que le format MP4
  • Dimensions : semblables à celles des GIF, mais avec une marge intérieure pour s'adapter aux spécifications du conteneur vidéo, qui sont généralement des incréments de 8 pixels.
  • Remarques sur l'utilisation : utilisez cette taille pour les aperçus et les partages WebM sur ordinateur.

Ce format est compatible avec les GIF et les autocollants.
tinywebm
  • Résolution et taille : taille réduite du format WebM
  • Dimensions : largeur et hauteur variables, avec un cadre de délimitation maximal de 320 x 320 pixels
  • Remarques sur l'utilisation : utilisez cette taille pour les GIF partagés sur mobile.

Ce format est compatible avec les GIF et les autocollants.
nanowebm
  • Résolution et taille : taille la plus petite du format WebM
  • Dimensions : largeur et hauteur variables, avec un cadre de délimitation maximal de 150 x 150 pixels
  • Remarques sur l'utilisation : utilisez cette taille pour les aperçus de GIF sur mobile.

Ce format est compatible avec les GIF et les autocollants.
webp_transparent
  • Résolution et taille : format WebP de haute qualité, taille de fichier maximale disponible
  • Dimensions : dimensions d'origine de l'importation (aucune limite)
  • Remarques sur l'utilisation : utilisez cette taille pour les partages d'autocollants pour les utilisateurs disposant d'une bande passante élevée.

Ce format est compatible avec les autocollants.
tinywebp_transparent
  • Résolution et taille : taille réduite du format WebP pour les autocollants, taille maximale de 500 Ko
  • Dimensions : jusqu'à 220 x 220 pixels, hauteur redimensionnée pour conserver les proportions.
  • Remarques sur l'utilisation : utilisez cette taille pour les aperçus d'autocollants destinés aux utilisateurs disposant d'une bande passante élevée et pour les partages destinés aux utilisateurs disposant d'une bande passante faible.

Ce format est compatible avec les autocollants.
nanowebp_transparent
  • Résolution et taille : taille la plus petite du format WebP pour les autocollants, taille maximale de 100 Ko
  • Dimensions : jusqu'à 90 x 90 pixels, avec une largeur redimensionnée pour conserver les proportions.
  • Remarques sur l'utilisation : Utilisez cette taille pour les aperçus d'autocollants destinés aux utilisateurs disposant d'une bande passante faible.

Ce format est compatible avec les autocollants.
gif_transparent
  • Résolution et taille : format d'autocollant GIF de haute qualité, taille de fichier la plus grande possible
  • Dimensions : dimensions d'origine de l'importation (aucune limite)
  • Remarques sur l'utilisation : utilisez cette taille pour les partages d'autocollants pour les utilisateurs disposant d'une bande passante élevée.

Ce format est compatible avec les autocollants.
tinygif_transparent
  • Résolution et taille : taille réduite du format GIF ; taille maximale de 500 Ko
  • Dimensions : jusqu'à 220 x 220 pixels, avec une hauteur redimensionnée pour conserver les proportions.
  • Remarques sur l'utilisation : utilisez cette taille pour les aperçus d'autocollants destinés aux utilisateurs disposant d'une bande passante élevée et pour les partages destinés aux utilisateurs disposant d'une bande passante faible.

Ce format est compatible avec les autocollants.
nanogif_transparent
  • Résolution et taille : taille minimale du format GIF pour les autocollants ; taille maximale de 100 Ko
  • Dimensions : jusqu'à 90 x 90 pixels, avec une largeur redimensionnée pour conserver les proportions.
  • Remarques sur l'utilisation : Utilisez cette taille pour les aperçus d'autocollants destinés aux utilisateurs disposant d'une bande passante faible.

Ce format est compatible avec les autocollants.

Bonnes pratiques

  • Pour les mobiles, utilisez les fichiers de taille "nano" ou "très petite" pour les aperçus, et les fichiers de taille "très petite" pour les partages.
  • Définissez le paramètre media_filter sur les formats que vous comptez utiliser. Cela peut réduire la taille de la réponse de l'API de 70 %.

Tailles des formats

La taille de fichier de chaque format de contenu dépend des dimensions et de la durée du GIF spécifique sélectionné. Par conséquent, considérez les moyennes et les médianes fournies dans le tableau suivant comme des consignes générales plutôt que comme des valeurs absolues.

Format de fichier Taille moyenne des fichiers (Ko) Taille médiane des fichiers (Ko)
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

Codes de réponse

Le tableau suivant fournit les codes de réponse d'état HTTP utilisés pour indiquer qu'une requête a abouti :

Code d'état HTTP
200 ou 202 OK ou accepté

Erreurs

L'API Tenor renvoie des erreurs avec les codes de réponse HTTP 4xx ou 5xx, et au format d'erreur standard de l'API Google. Pour en savoir plus, consultez Erreurs.