Skip to main content

Présentation

Un objet média représente une seule photo, vidéo ou GIF animé. Les objets média sont utilisés par de nombreux endpoints au sein de l’API Twitter, et peuvent être inclus dans des Tweets, des Messages privés, des profils d’utilisateur, des créations publicitaires et d’autres contextes. 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 l’envoi via l’API
  • Image 5 MB
  • GIF 15 MB
  • Vidéo 512 MB (lors de l’utilisation de media_category=amplify)

Création

Des objets tels que les Tweets, les Messages privés, les photos de profil utilisateur, les cartes Ads 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é concernée (par exemple POST statuses/update) 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. Téléversez le(s) fichier(s) média en utilisant soit le téléversement par segments 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 différents médias si l’entité autorise le passage de plusieurs paramètres media_id.
  3. Créez l’entité en appelant le point de terminaison approprié, en incluant le media_id et les autres paramètres requis. Par exemple, joignez un media_id à un Tweet en utilisant le point de terminaison POST statuses/update.

Récupération

Consultez l’objet Media dans le dictionnaire de données des Tweets.

Guides

Bonnes pratiques pour les médias

Téléversement fractionné de médias

Référence de l’API

POST media/upload (INIT)

POST media/upload (APPEND)

GET media/upload (STATUS)

POST media/upload (FINALIZE)

POST media/upload

POST media/metadata/create

POST media/subtitles/delete

POST media/subtitles/create