Instagram 媒体容器状态:代码与生命周期
Instagram 的 API 通过媒体容器发布内容,每个容器都会报告一个 status_code:IN_PROGRESS 表示仍在发布过程中,FINISHED 表示已准备就绪,PUBLISHED 表示已上线,ERROR 表示发布未能完成,EXPIRED 表示 24 小时内未发布。Meta 建议每分钟检查一次,最多检查 5 分钟。
easyCoexistence 在 publish_instagram_post 内部完成容器流程:创建容器,等待 Instagram 处理完成后发布;视频仍在处理时,它会自行完成发布。
status_code 可能的取值:IN_PROGRESS、FINISHED、PUBLISHED、ERROR 和 EXPIRED。
容器在未发布状态下可等待的时长,超过后状态变为 EXPIRED。
Meta 建议的状态检查间隔,最长不超过 5 分钟。
一个 Instagram 账户在滚动 24 小时内可以创建的容器数量。
错误子代码,属于代码 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 小时内发布,请创建新的容器。
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 字段包含说明原因的子代码。
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 监控
验证时间