---
title: "WhatsApp API 的媒体文件大小限制是多少？"
description: "WhatsApp Cloud API 媒体限制：图片 5 MB，视频和音频 16 MB，文档 100 MB，贴纸 100 至 500 KB，以及支持的格式和媒体 ID 有效期。"
canonical: "https://omnichannels.ai/zh/answers/whatsapp-media-file-size-limits/"
language: "zh"
updated: "2026-11-08"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

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

Canonical: https://omnichannels.ai/zh/answers/whatsapp-media-file-size-limits/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

**简短回答:** 据 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 MB | H.264 视频，AAC 音频 |
| 音频 | 16 MB | AAC、AMR、MP3、M4A、Opus 编码的 OGG |
| 文档 | 100 MB | Office、PDF 和文本文件 |
| 贴纸（动态） | 500 KB | 仅限 WebP |
| 贴纸（静态） | 100 KB | 仅限 WebP |

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

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

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

## 常见错误

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

## 官方来源

- [Media — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media)
- [Image messages — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/image-messages)
- [Video messages — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/video-messages)
- [Document messages — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/document-messages)
- [Error codes — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)

## 深入指南

- [WhatsApp API媒体消息：支持的文件类型与大小限制](https://omnichannels.ai/zh/blog/whatsapp-media-messages-file-types-size-limits/)
- [WhatsApp Cloud API 错误码：含义与排查方法](https://omnichannels.ai/zh/blog/whatsapp-api-error-codes-troubleshooting/)

## 相关问题

- https://omnichannels.ai/zh/answers/send-whatsapp-message-api/
- https://omnichannels.ai/zh/answers/whatsapp-api-rate-limits/
- https://omnichannels.ai/zh/answers/whatsapp-24-hour-window/

更新于: 2026-11-08