Instagram API 發布限制:格式、大小與每日貼文數
Instagram API 的發布上限為專業帳戶在滾動 24 小時內 100 則貼文,輪播計為一則。每則貼文可包含一張最大 8 MB 的 JPEG 圖片、最多 20 項的輪播、3 秒至 15 分鐘的 Reel,或最長 60 秒影片的限時動態;媒體由 Meta 從公開網址擷取。說明文字最多 2,200 字元。
easyCoexistence 可透過 publish_instagram_post 發布相片、2 至 10 項的輪播、Reels 及限時動態,無論來自 Claude、ChatGPT 或您自己的程式碼;它會自行完成仍在處理中的影片,並從自己的排程佇列發布貼文。
每個帳戶在滾動 24 小時內透過 API 發布的貼文數;輪播計為單一則貼文。
API 接受的最大 JPEG 圖片,長寬比介乎 4:5 至 1.91:1 之間。
帳戶在滾動 24 小時內可建立的媒體容器數量。
媒體容器未發布前可等候的時間,逾時即失效。
根據 Meta 的媒體參考,說明文字可包含的字元數,以及最多 20 個 @ 標記。
Instagram 說明中心容許單一貼文使用的最多主題標籤數目。
API 可以發布哪些內容?
共四種格式,每種都經過相同的兩個步驟:先由檔案建立媒體容器,再發布該容器。
- 相片:一張 JPEG 圖片,附說明文字。
- 輪播:一則貼文最多 20 張相片及影片,輪播整體共用一段說明文字。
- Reel:一段 MOV 或 MP4 影片,附說明文字。
- 限時動態:一張圖片或一段影片,顯示 24 小時。
帳戶每日可發布多少則貼文?
透過 API 在滾動 24 小時內最多 100 則,輪播計為一則。Instagram 是在發布媒體容器時而非建立時套用上限,因此超出上限的貼文會在該一刻失敗,回傳錯誤代碼 9 及子代碼 2207042。
GET /<IG_ID>/content_publishing_limit 會回傳 quota_usage,即帳戶在過去 24 小時內已發布的貼文數目。該端點的參考資料仍列 quota_total 為 50,發布指南的輪播部分亦然,因此應以端點為該帳戶回傳的配額為準,而不應依賴上述兩個數字之一。
媒體容器如何運作?
媒體容器是 Instagram 已擷取並準備好、等待發布的媒體。帳戶在滾動 24 小時內可建立 400 個,多於其可發布的數量,因此失敗後仍可重新開始。容器若在 24 小時內未發布便會失效,唯一的補救方法是建立新的容器。
影片容器需要先處理。其 status_code 會顯示 IN_PROGRESS,直至變為 FINISHED;Meta 建議每分鐘檢查一次,最多 5 分鐘。
媒體必須放在哪裡?
放在公開伺服器上。Meta 會在發布嘗試時,由要求中的網址自行擷取檔案,因此該連結在那時必須有效,前面不可有登入。Meta 亦建議網址只使用 US-ASCII 字元,否則要求可能失敗。
Meta 無法擷取的檔案會失敗,回傳錯誤代碼 9004、子代碼 2207052;下載時間過長的檔案則回傳子代碼 2207003。Meta 記載的可續傳上傳功能(可從電腦傳送影片檔案)只適用於以 Facebook Login for Business 建構的設定(包括 Unified Login);若使用 Instagram Login,媒體一律須來自網址。
圖片有哪些規則?
只接受 JPEG。MPO 及 JPS 等擴充 JPEG 格式會被拒絕,PNG 同樣不被接受。
- 檔案大小:最大 8 MB。
- 長寬比:相片須介乎 4:5 至 1.91:1 之間;Meta 建議限時動態採用 9:16。
- 寬度:320 至 1440 像素;超出範圍的圖片會縮放至合適尺寸。
- 色彩空間:sRGB;其他色彩空間的圖片會被轉換。
說明文字有哪些規則?
說明文字最多可包含 2,200 字元及 20 個 @ 標記,以及根據 Instagram 現行規則最多 5 個主題標籤(Meta 的 API 參考仍列為 30 個),而在說明中提及的帳戶會在貼文發布時收到通知。說明文字適用於相片、Reel 及輪播容器;輪播項目不設說明文字,Meta 的參考資料亦未說明限時動態的說明文字。超出字數上限的說明文字會回傳錯誤代碼 36004、子代碼 2207010,@ 標記過多則回傳子代碼 2207040。
透過 API 發布時,缺少哪些功能?
Instagram 應用程式提供的部分功能,在 API 發布中並無對應功能。
- 購物標籤及濾鏡。
- 限時動態貼圖,例如連結、投票及位置;不使用貼圖提及帳戶則可行。
- 以 Reel 作為輪播項目。
- 為輪播中的個別項目加入說明文字。
常見錯誤
- 上傳 PNG 或 HEIC 圖片。API 只發布 JPEG,MPO 及 JPS 等擴充 JPEG 格式同樣會失敗。
- 影片容器一建立即發布。請等待 status_code 顯示 FINISHED,否則呼叫會以子代碼 2207027 失敗。
- 將媒體放在登入後方,或放在會過期的連結上。Meta 在發布嘗試時下載檔案,屆時需要一個純粹的公開網址。
- 只計算說明文字的字數。Meta 另設 @ 標記上限為 20,而截至 2026 年 11 月,Instagram 說明中心容許每則貼文最多 5 個主題標籤。
每個連接每月 US$ 9 至 US$ 0.75,連接越多越便宜,並提供首 3 天免費試用。
常見問題
API 可以發布 PNG 圖片嗎?
不可以。API 只發布 JPEG 圖片,因此發布前請將 PNG 或其他格式轉換為 JPEG。
輪播算作一則貼文嗎?
算。以 100 則透過 API 發布貼文的上限計算,無論輪播包含多少張相片及影片,都只計一則。
如何查看帳戶今日還可發布多少則貼文?
呼叫 GET /<IG_ID>/content_publishing_limit。其 quota_usage 欄位會顯示帳戶在過去 24 小時內透過 API 發布的貼文數目。
Instagram API 每日上限是 50 還是 100 則貼文?
依 Meta 的發布指南,速率限制為滾動 24 小時內 100 則。content_publishing_limit 的參考資料仍列 quota_total 為 50,因此應以該端點為帳戶回傳的配額為準,而不是依賴以上兩個數字。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期