Skip to main content

概要

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

メディアの種類とサイズ制限

API 経由でアップロードする場合のサイズ制限
  • 画像 5 MB
  • GIF 15 MB
  • 動画 512 MB(media_category=amplify を使用する場合)

作成

ツイート、ダイレクトメッセージ、ユーザープロフィール画像、ホスト型広告カードなどのオブジェクトには、1 つ以上のメディアオブジェクトを含めることができます。これらのトップレベルオブジェクトは総称してエンティティと呼ばれます。関連するエンティティ作成 API(例: POST statuses/update)には、一意の media_id を指定して 1 つ以上のメディアオブジェクトを渡すことができます。 メディアオブジェクトを含むエンティティは、次の手順で作成できます。
  1. 推奨されるチャンクアップロード(画像/GIF/動画)または従来のシンプルアップロード(画像のみ)のいずれかを使用して、メディアファイルをアップロードします。
  2. 手順 1 で media_id を受け取ります。エンティティが複数の media_id パラメーターの受け渡しを許可している場合は、この手順を別のメディアで複数回繰り返すことができます。
  3. media_id とその他の必須パラメーターを含めて適切なエンドポイントを呼び出し、エンティティを作成します。たとえば、POST statuses/update エンドポイントを使用してツイートに media_id を添付します。

取得

ツイート データディクショナリー内の Media オブジェクトを参照してください。

ガイド

メディア利用のベストプラクティス

メディアの分割アップロード

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