Instagram API 发布限制:格式、尺寸与每日帖子数
Instagram API 发布限制为每个专业账户在滚动 24 小时内 100 篇帖子,轮播按一篇计算。每篇帖子可包含一张 JPEG 图片(最大 8 MB)、最多 20 项的轮播、3 秒至 15 分钟的 Reel,或最长 60 秒视频的限时动态。素材由 Meta 从公开 URL 抓取,说明文字最多 2,200 字符。
easyCoexistence 通过 publish_instagram_post 发布照片、2 至 10 项的轮播、Reel 和限时动态,可从 Claude、ChatGPT 或您自己的代码中调用,它会自行完成仍在处理中的视频,并从自己的队列中安排帖子。
账户在滚动 24 小时内通过 API 发布的帖子数;轮播按一篇计算。
API 接受的最大 JPEG 图片,宽高比介于 4:5 与 1.91:1 之间。
账户在滚动 24 小时内可创建的媒体容器数量。
媒体容器未发布前可等待的时长,超时即失效。
说明文字允许的字符数,且最多 20 个 @ 标签,依据 Meta 媒体参考。
Instagram 帮助中心允许单篇帖子使用的最多话题标签数。
API 可以发布哪些内容?
共四种格式,每种都通过相同的两步调用:先从文件创建媒体容器,再发布该容器。
- 照片:一张 JPEG 图片,附带说明文字。
- 轮播:一篇帖子内最多 20 张照片和视频,轮播共用一条说明文字。
- Reel:一个 MOV 或 MP4 视频,附带说明文字。
- 限时动态:一张图片或一个视频,展示 24 小时。
一个账户一天能发布多少篇帖子?
通过 API 在滚动 24 小时内最多 100 篇,轮播计为一篇。Instagram 在发布媒体容器时而非创建时执行上限,因此超出上限的帖子会在该时刻失败,返回代码 9 与子代码 2207042。
GET /<IG_ID>/content_publishing_limit 返回 quota_usage,即该账户在过去 24 小时内已发布的帖子数。该端点的参考文档仍将 quota_total 写为 50,发布指南的轮播部分也是如此,因此请以该端点为账户返回的配额为准,不要依赖这两处公布的数字。
媒体容器如何运作?
容器是 Instagram 已获取并准备好、等待发布的媒体。账户可在滚动 24 小时内创建 400 个容器,多于其可发布的数量,因此失败后可以重新开始。未在 24 小时内发布的容器会失效,唯一的办法是重新创建。
视频容器需要先处理。其 status_code 显示为 IN_PROGRESS,直到变为 FINISHED 为止;Meta 建议每分钟检查一次,最多检查 5 分钟。
媒体文件必须放在哪里?
放在公开服务器上。Meta 会在发布尝试时,自行从请求中的 URL 抓取文件,因此该链接届时必须可用,且前面不能有登录页面。Meta 还建议 URL 只使用 US-ASCII 字符,否则请求可能失败。
Meta 无法抓取的文件会返回代码 9004、子代码 2207052;下载耗时过长的文件则返回子代码 2207003。Meta 记录了可恢复上传功能,可从电脑发送视频文件,但仅适用于基于 Facebook Login for Business 的设置(包括 Unified Login);若使用 Instagram Login,媒体则必须来自 URL。
图片有哪些规则?
仅支持 JPEG。MPO、JPS 等扩展 JPEG 格式会被拒绝,PNG 同样被拒绝。
- 文件大小:最大 8 MB。
- 宽高比:照片须介于 4:5 与 1.91:1 之间;Meta 建议限时动态使用 9:16。
- 宽度:320 至 1440 像素;超出此范围的图片会被缩放以适配。
- 色彩空间:sRGB;其他色彩空间的图片会被转换。
说明文字有哪些规则?
说明文字最多 2,200 个字符和 20 个 @ 标签,依照 Instagram 目前的规则,最多 5 个话题标签(Meta 的 API 参考仍列为 30 个)。被提及的账户会在帖子发布时收到通知。说明文字适用于照片、Reel 和轮播容器;轮播中的单项不支持说明文字,Meta 的参考文档也未说明限时动态支持。超出长度限制的说明文字会返回代码 36004、子代码 2207010,@ 标签过多则返回子代码 2207040。
通过 API 发布不支持哪些功能?
Instagram 应用提供的部分功能,在 API 发布中没有对应功能。
- 购物标签和滤镜。
- 限时动态贴纸,例如链接、投票和位置;提及账户(不使用贴纸)则可行。
- 将 Reel 作为轮播项目。
- 为轮播中的单个项目添加说明文字。
常见错误
- 上传 PNG 或 HEIC 图片。API 只发布 JPEG,MPO、JPS 等扩展 JPEG 格式同样会失败。
- 立即发布视频容器。请等待 status_code 显示为 FINISHED,否则调用会因子代码 2207027 而失败。
- 将媒体托管在需要登录的地方,或放在会过期的链接上。Meta 在发布尝试期间下载文件,届时需要普通的公开 URL。
- 只检查说明文字的字符数。Meta 还将 @ 标签限制为 20 个,而截至 2026 年 11 月,Instagram 帮助中心允许每篇帖子最多 5 个话题标签。
每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,并享有前 3 天免费试用。
常见问题
Instagram API 能发布 PNG 图片吗?
不能。它只发布 JPEG 图片,因此请在发布前将 PNG 或其他格式转换为 JPEG。
轮播算作一篇帖子吗?
算。在 100 篇 API 帖子的上限内,无论轮播包含多少张照片和视频,都只计为一篇。
如何查看账户今天还能发布多少篇帖子?
调用 GET /<IG_ID>/content_publishing_limit。其 quota_usage 字段会报告该账户在过去 24 小时内通过 API 发布的帖子数。
Instagram API 每天的限制是 50 篇还是 100 篇?
Meta 的发布指南规定,滚动 24 小时内上限为 100 篇。content_publishing_limit 参考文档仍给出 quota_total 为 50,因此请以该端点为账户返回的配额为准,不要依赖这两个数字中的任何一个。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间