Introduction

Un objet média représente une photo, une vidéo ou un GIF animé. Les objets média sont utilisés par de nombreux endpoints au sein de la X API et peuvent être inclus dans des Posts, des Messages privés, des profils utilisateur, des créations publicitaires, etc. Chaque objet média peut avoir plusieurs variantes d’affichage ou de lecture, avec des résolutions ou des formats différents.

​

Types de médias et limites de taille

Limites de taille pour le téléversement via l’API

• Image : 5 MB
• GIF : 15 MB
• Vidéo : 512 MB (lors de l’utilisation de media_category=amplify_video)

​

Création

Des objets tels que des Posts, des Messages privés, des photos de profil utilisateur, des cartes publicitaires hébergées, etc. peuvent contenir un ou plusieurs objets média. Ces objets de premier niveau sont collectivement appelés entités. L’API de création d’entité appropriée (p. ex. POST /2/tweets) peut recevoir un ou plusieurs objets média à l’aide d’un media_id unique.

Une entité qui contient un ou plusieurs objets média peut être créée en suivant ces étapes :

1. Chargez le ou les fichiers média en utilisant soit le téléversement segmenté recommandé (images/GIF/vidéo), soit l’ancien téléversement simple (images uniquement).
2. Recevez un media_id à l’étape 1. Cette étape peut être répétée plusieurs fois avec des médias différents si l’entité autorise plusieurs paramètres media_id.
3. Créez l’entité en appelant l’endpoint approprié, en incluant le media_id et les autres paramètres requis. Par exemple, joignez un media_id à un Post en utilisant l’endpoint POST /2/tweets.

​

Récupération

Veuillez consulter l’objet Media dans le dictionnaire de données.