介绍

媒体对象表示一张照片、一个视频或一个动图（GIF）。媒体对象被 X API 中的许多 endpoint 使用，并可出现在 Posts、私信、用户资料、广告素材等处。每个媒体对象可能提供多个显示或播放版本，分辨率或格式各不相同。

​

媒体类型与大小限制

通过 API 上传的大小限制

• 图片：5 MB
• GIF：15 MB
• 视频：512 MB（使用 media_category=amplify_video 时）

​

创建

诸如 Post、私信、用户头像、托管 Ads 卡片等对象可以包含一个或多个媒体对象。这些顶级对象统称为实体。相关的实体创建 API（例如 POST /2/tweets）可通过唯一的 media_id 传入一个或多个媒体对象。

包含媒体对象的实体可按以下步骤创建：

1. 使用推荐的分块上传（图片/GIF/视频）或较早的简单上传（仅图片）来上传媒体文件。
2. 从第 1 步获取一个 media_id。如果该实体允许传入多个 media_id 参数，可针对不同媒体多次重复此步骤。
3. 调用相应的 endpoint 创建实体，并包含 media_id 及其他必需参数。例如，使用 POST /2/tweets endpoint 将 media_id 附加到一个 Post。

​

检索

请参阅数据字典中的媒体对象（Media Object）。