上传媒体

媒体目标表示单个照片、视频或动画 GIF。媒体目标在 Twitter API 中由许多端点使用,并且可能涉及推文、私信、用户个人资料、广告素材和其他地方。每个媒体目标可能拥有多种显示或回放形式,具有不同的分辨率或格式。

媒体类型和大小限制

通过 API 进行上传的大小限制 

  • 图像为 5 MB
  • GIF 为 15 MB
  • 视频为 15 MB

创建

诸如推文、私信、用户个人资料图片、托管广告卡片等目标均可包含一个或多个媒体目标。这些顶层目标统称为实体。相关的实体创建 API(如 POST statuses/update)可以使用唯一的 media_id 传输一个或多个每一目标。

可以根据以下步骤创建包含媒体目标的实体:

  1. 使用推荐的分块上传(图像/GIF/视频)或更旧的简易上传(仅限图像)上传媒体文件。
  2. 按照步骤 1 接收 media_id。如果实体允许输入多个 media_id 参数,则此步骤可以在不同的媒体上重复多次。
  3. 通过调用适当的端点(包括 media_id 和其他所需参数)创建实体。例如,使用 POST status /update 端点将 media_id 附加至推文。

检索

请参阅推文数据字典中的媒体对象