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 隨即抓取並準備媒體;再以 POST /<IG_ID>/media_publish,並將容器的 ID 作為 creation_id 傳入,便會把它轉為貼文。輪播則多一層:每個項目各有一個容器,然後由一個 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 會在 status_code 顯示 ERROR 時載有錯誤子代碼。copyright_check_status 則顯示影片是否已完成 Meta 的版權檢查,以及是否找到相符內容。發佈後,media_publish 可能返回 config_issue、CAPTION_NOT_ATTACHED 或 USER_TAGGING_FAILURE,即貼文上線時缺少說明文字或用戶標記。
常見錯誤
- 把容器 ID 當作上傳已完成。影片上傳是非同步的,只有 status_code 為 FINISHED 才能確認媒體已準備就緒。
- 在狀態仍為 IN_PROGRESS 時發佈。請求會失敗並返回子代碼 2207027,直至狀態變為 FINISHED。
- 容器擱置超過一天。若 24 小時內未發佈,其狀態會變為 EXPIRED,只能建立新的容器來發佈。
- 失敗時只看 status_code。當其顯示 ERROR 時,status 欄位載有說明原因的子代碼。
Claude、ChatGPT 或你自己的程式會取回已發佈的媒體 ID,或在 easyCoexistence 完成發佈期間取回處理狀態。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,並提供首 3 天免費試用。
常見問題
IN_PROGRESS 在 Instagram 容器中是什麼意思?
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 監察
驗證日期