はじめに

メディアオブジェクトは、1 つの写真、動画、またはアニメーション GIF を表します。メディアオブジェクトは X API 内の多くのエンドポイントで使用されており、ポスト、ダイレクトメッセージ、ユーザープロフィール、広告クリエイティブなどに含めることができます。各メディアオブジェクトは、異なる解像度やフォーマットを持つ複数の表示・再生用バリエーションを含む場合があります。

​

メディアタイプとサイズ制限

API 経由のアップロード時のサイズ制限

• 画像: 5 MB
• GIF: 15 MB
• 動画: 512 MB (media_category=amplify_video を使用する場合)

​

作成

投稿、ダイレクトメッセージ、ユーザーのプロフィール画像、ホストされた広告カードなどのオブジェクトには、1 つ以上のメディアオブジェクトを含めることができます。これらの最上位オブジェクトは総称してエンティティと呼ばれます。対象となるエンティティ作成 API (例: POST /2/tweets) には、一意の media_id を使用して 1 つ以上のメディアオブジェクトを渡すことができます。

メディアオブジェクトを含むエンティティは、次の手順で作成できます。

1. 推奨されるチャンク (分割) アップロード (画像/GIF/動画) または従来のシンプルアップロード (画像のみ) のいずれかを使用して、メディアファイルをアップロードします。
2. 手順 1 で media_id を受け取ります。エンティティが複数の media_id パラメータを受け付けられる場合は、この手順を別のメディアで複数回繰り返すことができます。
3. media_id とその他の必須パラメータを含めて、適切なエンドポイントを呼び出し、エンティティを作成します。たとえば、POST /2/tweets エンドポイントを使用して、投稿に media_id を添付します。

​

取得

データディクショナリーの Media Object を参照してください。