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 Publications, des Messages directs, des profils utilisateur, des créatifs publicitaires et ailleurs. Chaque objet média peut avoir plusieurs variantes d’affichage ou de lecture, avec différentes résolutions ou différents formats.

​

Types de médias et restrictions de taille

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

• Image : 5 MB
• GIF : 15 MB
• Vidéo : 512 MB (lorsque vous utilisez media_category=amplify_video)

​

Création

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

Une entité qui contient un ou plusieurs objets multimédias peut être créée en procédant comme suit :

1. Téléversez le ou les fichiers multimédias en utilisant soit le téléversement segmenté recommandé (images/GIF/vidéo), soit l’ancien téléversement simple (images uniquement).
2. Récupérez un media_id à l’issue de l’étape 1. Cette étape peut être répétée plusieurs fois avec des médias différents si l’entité autorise le passage de 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 à une Publication à l’aide de l’endpoint POST /2/tweets.

​

Récupération

Reportez-vous à l’objet Media dans le dictionnaire de données.