登录开始免费试用
easyCoexistence 官方 API

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 还是您自己的代码;在轮播上只需设置一次文案。

2,200

通过 Instagram API 文案最多可容纳的字符数。

5

Instagram 帮助中心现允许每条帖子使用的最多话题标签数,文案和评论中的均计算在内。

30

Meta API 参考中每条文案的最多话题标签数,该文档仍给出旧数值。

20

一条文案中最多的 @ 标签数;超出将返回代码 100,子代码 2207040。

2207010

代码 36004 下的错误子代码,表示文案超出 Instagram 允许的长度。

Partial

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 后重新发布。第一次发布的帖子已经上线,再次发布会产生重复帖子。
使用 EasyCoexistence 完成这些操作

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 监控

验证时间