跳转到正文
OmniChannels.ai
菜单

WhatsApp Business API

WhatsApp API 的媒体文件大小限制是多少？

更新于

简短回答

据 Meta 文档，Cloud API 媒体上限为：图片 5 MB，视频和音频 16 MB，文档 100 MB，动态贴纸 500 KB，静态贴纸 100 KB。请上传文件并发送媒体 ID 而非链接，且 MIME 类型须与文件一致。

各类媒体的大小限制

Cloud API 对任何媒体的上限为 100 MB。文件即使满足大小限制，仍可能因格式被拒，例如视频不是 H.264 配 AAC 音频，或图片不是 8 位 RGB 或 RGBA。

媒体类型最大大小说明
图片5 MB仅限 8 位 RGB 或 RGBA
视频16 MBH.264 视频，AAC 音频
音频16 MBAAC、AMR、MP3、M4A、Opus 编码的 OGG
文档100 MBOffice、PDF 和文本文件
贴纸（动态）500 KB仅限 WebP
贴纸（静态）100 KB仅限 WebP

上传还是用链接，ID 有效多久

Meta 建议先上传文件并发送其媒体 ID，以获得更好的性能。上传返回的 ID 有效期为 30 天，入站 Webhook 中收到的 ID 有效期为 7 天，因此请及时下载客户发来的文件。下载 URL 5 分钟后失效。

图片、视频和文档的说明文字最多 1,024 个字符。音频和贴纸消息没有说明文字。

常见错误

  • 只看大小，忽略编解码器或颜色格式。
  • 提供的文件 MIME 类型与文件不符，这是错误 131053 的常见原因。
  • 使用超过 30 天的媒体 ID。
  • 把动态 WebP 当作图片发送，会被拒绝。

官方来源