登入開始免費試用
easyCoexistence 官方 API

透過 API 發布 Instagram 限時動態

Instagram API 以單一公開網址的圖片或影片發布限時動態:先以 media_type 設為 STORIES 建立容器,再發布。圖片須為 JPEG,最大 8 MB;影片長 3 至 60 秒,最大 100 MB。Meta 建議使用 9:16 畫面,限時動態在 24 小時後消失,與應用程式一致。

easyCoexistence 可透過 Claude、ChatGPT 或您自己的程式,以 publish_instagram_post 發布圖片與影片限時動態,並可從其內建佇列排程。

60 s

API 可發布的最長限時動態影片;最短為 3 秒,檔案最大可達 100 MB。

8 MB

可發布的最大限時動態圖片,必須為 JPEG 格式。

24 hours

已發布的限時動態在到期前會保留多久。

Under 5

限時動態指標數值低於 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,其他比例可能出現留白或被裁切。
使用 EasyCoexistence 完成這項設定

限時動態的回覆以私訊送達,可轉寄至您的端點,或由自動化功能回覆。每個連接每月 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 監察

驗證日期