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

Instagram 媒体容器状态:代码与生命周期

Instagram 的 API 通过媒体容器发布内容,每个容器都会报告一个 status_code:IN_PROGRESS 表示仍在发布过程中,FINISHED 表示已准备就绪,PUBLISHED 表示已上线,ERROR 表示发布未能完成,EXPIRED 表示 24 小时内未发布。Meta 建议每分钟检查一次,最多检查 5 分钟。

easyCoexistence 在 publish_instagram_post 内部完成容器流程:创建容器,等待 Instagram 处理完成后发布;视频仍在处理时,它会自行完成发布。

5

status_code 可能的取值:IN_PROGRESS、FINISHED、PUBLISHED、ERROR 和 EXPIRED。

24 hours

容器在未发布状态下可等待的时长,超过后状态变为 EXPIRED。

1 min

Meta 建议的状态检查间隔,最长不超过 5 分钟。

400

一个 Instagram 账户在滚动 24 小时内可以创建的容器数量。

2207027

错误子代码,属于代码 9007,表示容器尚未就绪时就发起发布。

什么是媒体容器?

帖子发布所依托的对象。POST /<IG_ID>/media 基于图片或视频 URL 创建一个容器,Meta 获取并准备媒体;随后以容器 ID 作为 creation_id 调用 POST /<IG_ID>/media_publish,即可将其转为帖子。轮播多一层结构:每个条目各有一个容器,再由一个 CAROUSEL 容器将它们列为子项。

各个状态代码表示什么?

GET /<IG_CONTAINER_ID>?fields=status_code 会返回以下五个值之一,每个值都对应一个后续步骤:

  • IN_PROGRESS:容器仍在发布过程中,请等待并再次检查。
  • FINISHED:容器及其媒体已准备就绪,请发布。
  • PUBLISHED:媒体已上线,无需再做任何发布操作。
  • ERROR:容器未能完成发布过程;status 字段会给出含原因的错误子代码,需要创建新的容器。
  • EXPIRED:未在 24 小时内发布,请创建新的容器。
Checking a container's status
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code

{
  "status_code": "FINISHED",
  "id": "<IG_CONTAINER_ID>"
}

应该多久检查一次状态?

Meta 的建议是每分钟检查一次,最多检查 5 分钟。对于视频,检查尤为重要,因为 Meta 指出视频上传是异步的:收到容器 ID 并不代表上传成功,只有 status_code 为 FINISHED 才能确认。

发布过早会怎样?

media_publish 会以代码 9007、子代码 2207027 失败,表示媒体尚未准备好发布。请求本身无需修改;请检查状态,待其显示 FINISHED 后再发布。代码 24 配合子代码 2207008 则不同,表示容器不存在或已过期,Meta 建议在 30 秒至 2 分钟内重试一到两次,然后再创建新的容器。

容器能保留多久?

24 小时。在此时间内未发布的容器,状态会显示为 EXPIRED,且无法再发布。代码 -2 配合子代码 2207020(媒体已过期)同样需要创建新的容器。一个账户在滚动 24 小时内可以创建 400 个容器,这样在失败后仍有余量重新创建。

容器还会报告哪些内容?

另外两个字段,以及发布时的一条提示。当 status_code 显示 ERROR 时,status 字段会给出一个错误子代码。对于视频,copyright_check_status 字段显示 Meta 的版权检查是否已运行,以及是否发现匹配内容。发布后,media_publish 可能返回 config_issue、CAPTION_NOT_ATTACHED 或 USER_TAGGING_FAILURE,表示帖子在上线时缺少文案或用户标记。

常见错误

  • 把容器 ID 当作上传已完成。视频上传是异步的,只有 status_code 为 FINISHED 才能确认媒体已准备就绪。
  • 状态仍为 IN_PROGRESS 时就发布。在状态显示 FINISHED 之前,调用都会以子代码 2207027 失败。
  • 容器超过一天仍不发布。24 小时未发布后状态会变为 EXPIRED,只能创建新的容器来发布。
  • 失败时只看 status_code。当它显示 ERROR 时,status 字段包含说明原因的子代码。
使用 EasyCoexistence 完成这些操作

Claude、ChatGPT 或你自己的代码会拿到已发布的媒体 ID,或是 easyCoexistence 完成发布期间的处理状态。每个连接每月 US$ 9 起,连接越多单价越低,最低降至 US$ 0.75,前 3 天免费。

常见问题

Instagram 容器上的 IN_PROGRESS 是什么意思?

Meta 仍在准备媒体。请等待并再次检查,因为在状态显示 FINISHED 之前发布,会以代码 9007 失败。

一个 Instagram 账户最多能创建多少个媒体容器?

滚动 24 小时内 400 个,这样失败后仍有余量重新创建容器。

发布后出现 config_issue 是什么意思?

media_publish 已成功,但帖子上线时缺少文案(CAPTION_NOT_ATTACHED)或缺少用户标记(USER_TAGGING_FAILURE)。

为什么我的容器以 ERROR 结束?

它未能完成发布过程。其 status 字段包含说明原因的错误子代码;请修复该原因,然后创建新的容器。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间