引言

媒体对象表示一张照片、一个视频或一张动图（GIF）。媒体对象被 X API 中的许多端点使用，并可包含在 Post、私信、用户资料、广告素材等内容中。每个媒体对象可能具有多个用于显示或播放的变体，分辨率或格式各不相同。

​

媒体类型和大小限制

通过 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. 调用相应的端点创建实体，并包含 media_id 及其他必需参数。例如，使用 POST /2/tweets 端点将 media_id 附加到 Post。

​

获取

请参阅数据字典中的 Media 对象。