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. Remarque : Seuls les formats vidéo sont compatibles avec l'audio. Le format de fichier image GIF ne peut pas contenir d'informations 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.