登入開始免費試用
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 隨即抓取並準備媒體;再以 POST /<IG_ID>/media_publish,並將容器的 ID 作為 creation_id 傳入,便會把它轉為貼文。輪播則多一層:每個項目各有一個容器,然後由一個 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 會在 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 欄位載有說明原因的子代碼。
使用 EasyCoexistence 完成這項設定

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 監察

驗證日期