LINEのリッチメニュー画像サイズの上限が管理画面とMessaging APIで違うので検証してみた
西田@リテールアプリ共創部マッハチームです。
今回からはマッハチームのメンバーで「LINE」をテーマにブログを書いていきます
LINE のリッチメニュー画像をアップロードする方法には、Messaging API と LINE 公式アカウント管理画面の 2 つがあります。それぞれファイルサイズの上限が異なり、Messaging API は 1MB、管理画面は 10MBと記載されています。
同じ画像を違う方法でアップロードすると最大サイズが本当に異なるか、実際に両方の方法で検証してみました。
まずは結論から
先に結論をお伝えすると、ドキュメント通りにOAM(LINE公式アカウント管理画面)よりMessaging APIでアップロードする画像サイズの方が制限が強いことがわかりました
| アップロード方法 | 公式ドキュメント | 実測値 |
|---|---|---|
| Messaging API | 1MB | 1MB 以下 ✅ |
| LINE公式アカウント管理画面 | 10MB | 7MB 以下 ⚠️ |
Messaging API は公式ドキュメント通りでしたが、管理画面は公式の「10MB」より低い 7MB 程度 が今回試した上限でした。以下、検証の詳細を紹介します。
リッチメニューの画像要件
まず、公式ドキュメントに記載されているリッチメニュー画像の要件を整理します。
画像サイズ（ピクセル）
リッチメニューのレイアウトに応じて、以下のいずれかのサイズを使用します。
| レイアウト | サイズオプション |
|---|---|
| 大（フルサイズ） | 2500×1686px、1200×810px、800×540px |
| 小（ハーフサイズ） | 2500×843px、1200×405px、800×270px |
ファイル形式
JPEG または PNG が使用できます。
ファイルサイズ上限（公式ドキュメント）
| アップロード方法 | 公式ドキュメントの上限 |
|---|---|
| Messaging API | 1MB |
| LINE公式アカウント管理画面 | 10MB |
検証環境
各サイズのテスト画像を ImageMagick で作成しました。解像度はすべてフルサイズの 2500×1686px（JPEG）です。
| ファイル | ファイルサイズ |
|---|---|
| richmenu_test_1mb.jpg | 0.95 MB |
| richmenu_test_2mb.jpg | 2.09 MB |
| richmenu_test_7mb.jpg | 6.95 MB |
| richmenu_test_8mb.jpg | 8.19 MB |
JPEG の品質パラメータ（-quality）を調整することで、同一解像度で異なるファイルサイズの画像を生成しています。
# 例: 約1MBの画像を生成
magick -size 2500x1686 plasma:red-blue -quality 30 richmenu_test_1mb.jpg
# 例: 約8MBの画像を生成
magick -size 2500x1686 plasma:red-blue -quality 100 richmenu_test_8mb.jpg
検証結果
Messaging API
Messaging API の リッチメニュー画像アップロードエンドポイント を使ってテストしました。
| ファイルサイズ | 結果 |
|---|---|
| 0.95 MB | ✅ 成功 |
| 2 MB | ❌ 失敗（413 エラー） |
1MB を超えるファイルをアップロードすると、API のレスポンスではなく nginx レイヤーで 413 Request Entity Too Large が返されます。
<html>
<head><title>413 Request Entity Too Large</title></head>
<body>
<center><h1>413 Request Entity Too Large</h1></center>
<hr><center>nginx</center>
</body>
</html>
LINE Developers ドキュメントに記載されている「1MB」という上限は、実際の動作と一致していました。
LINE公式アカウント管理画面
LINE 公式アカウント管理画面のリッチメニュー設定画面から画像をアップロードしてテストしました。
| ファイルサイズ | 結果 |
|---|---|
| 7 MB | ✅ 成功 |
| 8 MB | ❌ 失敗 |
8MB の画像をアップロードしようとすると、以下のエラーメッセージが表示されました。
[ アップロードした画像の情報 ]
[ 失敗メッセージ ]
公式ドキュメントでは「10MB以下」と記載されていますが、実測では 7MB 程度が上限 となっています。原因は不明ですが、実装上の制限がある可能性があります
まとめ
検証結果を踏まえると、以下を目安にしておくと安心です。
- Messaging API を使う場合: 画像は 1MB 以下に収める（JPEG 品質を調整するか、PNG → JPEG 変換で対応）
- 管理画面を使う場合: 余裕を持って 5MB 以下 を目安にする
なお、この検証は 2026年2月時点のものです。LINE 側の仕様変更により、上限値が変わる可能性があります。
この記事が誰かの役に立てば幸いです。
