透過 API 發布 Instagram 限時動態
Instagram API 以單一公開網址的圖片或影片發布限時動態:先以 media_type 設為 STORIES 建立容器,再發布。圖片須為 JPEG,最大 8 MB;影片長 3 至 60 秒,最大 100 MB。Meta 建議使用 9:16 畫面,限時動態在 24 小時後消失,與應用程式一致。
easyCoexistence 可透過 Claude、ChatGPT 或您自己的程式,以 publish_instagram_post 發布圖片與影片限時動態,並可從其內建佇列排程。
API 可發布的最長限時動態影片;最短為 3 秒,檔案最大可達 100 MB。
可發布的最大限時動態圖片,必須為 JPEG 格式。
已發布的限時動態在到期前會保留多久。
限時動態指標數值低於 5 時,會返回錯誤代碼 10(觀看人數不足),而不是數字。
限時動態如何發布?
流程與任何貼文相同,只需兩次呼叫。以 media_type 設為 STORIES,並指定 image_url 或 video_url,呼叫 POST /<IG_ID>/media;然後以容器 ID 呼叫 POST /<IG_ID>/media_publish。影片限時動態需先處理,其容器的 status_code 須顯示 FINISHED,才可發布。
Meta 參考文件所述的說明文字只適用於相片、影片及輪播,不適用於限時動態,因此要給觀眾看的文字,應放在圖片或影片本身。
限時動態的媒體規格是什麼?
Meta 建議限時動態的圖片與影片都使用 9:16 畫面,以免裁切或留白。
- 圖片:JPEG,最大 8 MB,使用 sRGB;其他色彩空間會被轉換。
- 影片:MOV 或 MP4,影片編碼採用 H.264 或 HEVC,音訊為 AAC,每秒 23 至 60 幀,寬度最大 1920 像素,最高 25 Mbps。
- 影片長度:3 至 60 秒,檔案最大 100 MB。
- 影片畫面比例:介乎 0.1:1 至 10:1 均可接受。
限時動態可包含什麼?
圖片或影片本身,以及提及其他帳戶。自 2025 年 7 月起,user_tags 參數可在圖片與影片限時動態中標記公開帳戶,x 與 y 座標可選填。Meta 不支援透過 API 發布貼紙,因此連結貼紙、投票貼紙與位置貼紙仍須在應用程式中加入。
限時動態發布後會怎樣?
會保留 24 小時,之後與應用程式一樣到期。Meta 將仍在有效期內的限時動態列於獨立的 stories 邊(edge)下;帳戶的媒體列表 GET /<IG_ID>/media 不包括它們。讀回時,限時動態的 media_type 為 IMAGE 或 VIDEO,與其他媒體相同,因此須按找到的位置而非類型分辨限時動態。
回覆與提及如何送回?
以私訊形式送回。對限時動態的回覆,會以 messages Webhook 送達帳戶,並附上該限時動態的 ID 與網址,同時開啟一般的 24 小時回覆期。當有人在自己的限時動態中提及帳戶時,同樣會以訊息送達,附件類型為 story_mention。Meta 的提及 API 不涵蓋限時動態。
限時動態會報告哪些指標?
觸達人數、瀏覽次數、分享次數、回覆、追蹤、個人檔案瀏覽、個人檔案活動、導航、連結點擊、轉發,以及互動總數,可透過媒體洞察端點讀取。這些數據只保留 24 小時;若數值低於 5,會返回錯誤代碼 10(觀看人數不足),而不是數字。歐洲與日本人士的回覆不計入,由該地區帳戶發布的限時動態,回覆數會報告為 0。
常見錯誤
- 計劃加入連結貼紙。API 不發布貼紙,因此連結須以其他方式送達,例如透過私訊回覆。
- 翌日才讀取限時動態指標。數據只保留 24 小時,因此應於限時動態有效期內收集。
- 在帳戶的媒體列表中尋找已發布的限時動態。仍有效的限時動態列於獨立的 stories 邊下。
- 把橫向影片發布為限時動態。Meta 建議使用 9:16,其他比例可能出現留白或被裁切。
限時動態的回覆以私訊送達,可轉寄至您的端點,或由自動化功能回覆。每個連接每月 US$ 9 至 US$ 0.75,連接越多單價越低,並提供前 3 天免費試用。
常見問題
可以透過 API 為限時動態加入連結貼紙嗎?
不可以。Meta 不支援透過 API 發布貼紙,包括連結、投票與位置貼紙。以不加貼紙的方式提及其他帳戶則受支援。
已發布的限時動態會在 API 的哪裡列出?
在帳戶獨立的 stories 邊下,限時動態仍在有效期內時列出。GET /<IG_ID>/media 不包括限時動態,讀回時會顯示為 IMAGE 或 VIDEO。
限時動態可以透過 API 加上說明文字嗎?
不會。Meta 參考文件沒有為限時動態提供說明文字,而 publish_instagram_post 發布限時動態時不附說明文字,因此要給觀眾看的文字,應放在圖片或影片本身。
限時動態的洞察數據可以保留多久?
24 小時。Meta 只會在這段時間內提供限時動態指標,因此應於限時動態有效期內讀取。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期