Instagram 文案限制:API 中的字数、话题标签和 @ 标签
Instagram API 发布照片、Reel 或轮播时,文案最多 2,200 字符,最多 20 个 @ 标签。截至 2026 年 11 月,Instagram 帮助中心允许每条帖子最多 5 个话题标签,而 Meta 的 API 参考仍列出 30 个,因此请控制在 5 个以内。发布时会通知被 @ 提及的账户;文案过长会返回错误代码 36004,子代码 2207010。
easyCoexistence 可通过 publish_instagram_post 发布照片、轮播或 Reel 及其文案,无论来自 Claude、ChatGPT 还是您自己的代码;在轮播上只需设置一次文案。
通过 Instagram API 文案最多可容纳的字符数。
Instagram 帮助中心现允许每条帖子使用的最多话题标签数,文案和评论中的均计算在内。
Meta API 参考中每条文案的最多话题标签数,该文档仍给出旧数值。
一条文案中最多的 @ 标签数;超出将返回代码 100,子代码 2207040。
代码 36004 下的错误子代码,表示文案超出 Instagram 允许的长度。
media_publish 可能以 config_issue CAPTION_NOT_ATTACHED 成功返回:帖子已上线,但没有文案。
文案限制是什么?
共三项,均作用于媒体容器的 caption 参数。文案可包含话题标签(写作 #tag)和 Instagram 账户名(写作 @username),须符合以下限制:
- 长度:最多 2,200 字符。
- 话题标签:依据 Instagram 帮助中心,每篇帖子最多 5 个,评论中的话题标签同样计入;Meta 的 API 参考仍列出 30 个。
- @ 标签:最多 20 个,每个被提及的账户在帖子发布时都会收到通知。
哪些帖子可以添加文案?
照片、Reel 和轮播。在轮播中,文案需添加到轮播容器上,因为其中的图片和视频不支持文案;Meta 的参考文档未说明限时动态可以添加文案,因此要放在限时动态中的文字,应直接写在图片或视频里。
文案超出限制时会怎样?
请求会失败,并返回说明问题的错误。文案过长会返回代码 36004、子代码 2207010,Meta 对此的修复说明重申了限制:最多 2,200 字符、30 个话题标签和 20 个 @ 标签。超过 20 个 @ 标签时还可能返回代码 100、子代码 2207040。请缩短文案,然后重新发送请求。
被提及的账户何时收到通知?
在媒体容器发布时收到通知,而非创建时。文案中被 @ 提及的账户会在那一刻收到通知,因此提前准备好的容器在上线前不会通知任何人。Meta 对每条文案 20 个 @ 标签的限制适用于这些提及。
帖子可以在没有文案的情况下上线吗?
可以。media_publish 可能以 config_issue 字段设置为 CAPTION_NOT_ATTACHED 而成功,表示媒体已发布但没有文案。Meta 将此称为部分成功:媒体 ID 有效,因此应核对该帖子,而不是再次发布。
发布后能修改文案吗?
Meta 的媒体参考文档只记录了对已发布媒体的一项更新:通过 POST /<IG_MEDIA_ID> 和 comment_enabled 开启或关闭评论。该文档未列出编辑文案的方法,因此请在创建媒体容器前检查文字、话题标签和 @ 标签。
常见错误
- 只检查长度。字符数不足 2,200 的文案,如果话题标签超过 Instagram 现行规定的 5 个,或 @ 标签超过 20 个,同样违反限制。
- 为轮播中的单个内容添加文案。只有轮播容器可以添加文案。
- 为限时动态编写文案。限时动态容器不接受文案,因此应将文字放进图片或视频中。
- 出现 CAPTION_NOT_ATTACHED 后重新发布。第一次发布的帖子已经上线,再次发布会产生重复帖子。
list_social_posts 可读取每条帖子的文案。每个连接每月 US$ 9 起,随连接数增加而降低,最低降至 US$ 0.75。前 3 天免费试用。
常见问题
Instagram 的错误 2207040 是什么意思?
文案包含超过 20 个 @ 标签,返回代码为 100。请删除标签,直到剩余 20 个或更少,然后重新发送请求。
Instagram 的 5 个话题标签限制是否包括评论中的话题标签?
包括。Instagram 帮助中心允许每条帖子最多 5 个话题标签,文案和评论中的话题标签合并计算。
能否通过 API 关闭已发布帖子的评论?
可以。使用 POST /<IG_MEDIA_ID> 并将 comment_enabled 设为 false 即可关闭评论,设为 true 则重新开启。这是 Meta 媒体参考文档中记录的、针对已发布媒体的唯一更新。
错误 2207010 是什么意思?
文案长度超出 Instagram 的允许范围。请将其缩短至 2,200 字符或以内,然后重新发送请求。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间