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

透過 API 發佈 Instagram Reels

Instagram API 從公開網址的 MOV 或 MP4 檔案發佈 Reel:以 media_type REELS 建立媒體容器,等待 Meta 處理影片,然後發佈。Reel 長度由 3 秒至 15 分鐘,檔案最大 300 MB,Meta 建議使用 9:16 畫面,以免被裁切或出現空白。

easyCoexistence 可透過 Claude、ChatGPT 或你自己的程式,以 publish_instagram_post 發佈 Reel:提供影片網址及說明文字,影片仍在處理時,它會自行完成發佈。

15 min

API 可發佈的最長 Reel;最短為 3 秒。

300 MB

最大 Reel 檔案,為 MOV 或 MP4 格式,影片採用 H.264 或 HEVC,音訊採用 AAC。

1 min

Meta 建議查看處理中媒體容器狀態的頻率,最多不超過 5 分鐘。

24 hours

Reel 媒體容器在未發佈狀態下可等待的時間,之後即會失效。

Reel 如何發佈?

分三個步驟。第一,以 POST /<IG_ID>/media 發出請求,media_type 設為 REELS,video_url 指向檔案,如需要,加入說明文字;Meta 會擷取影片並回傳容器 ID。第二,等待 Instagram 處理影片,並檢查容器的 status_code。第三,以 POST /<IG_ID>/media_publish 發出請求,creation_id 設為容器 ID,回應會附上新的媒體 ID。

Meta 記錄了可續傳上傳功能,可從電腦傳送檔案,但僅適用於 Facebook Login for Business 的設定,包括 Unified Login。若使用 Instagram 登入,影片一律來自公開網址。

影片規格有哪些要求?

Meta 的 Reel 規格,檔案須符合以下要求,Instagram 才會處理:

  • 容器:MOV 或 MP4(MPEG-4 Part 14),不得含編輯清單,moov atom 須位於檔案開頭。
  • 影片:H.264 或 HEVC,逐行掃描,封閉式 GOP,4:2:0 色度抽樣,每秒 23 至 60 格,寬度最高 1920 像素,最高 25 Mbps。
  • 音訊:AAC,最高 48 kHz,單聲道或立體聲,128 kbps。
  • 長寬比:由 0.01:1 至 10:1 均可,建議 9:16。
  • 長度及大小:3 秒至 15 分鐘,最大 300 MB。

影片處理期間會發生什麼事?

在 Instagram 處理完影片前,容器的 status_code 會顯示 IN_PROGRESS,完成後顯示 FINISHED,之後才可發佈。提早發佈會失敗並返回錯誤代碼 9007、子代碼 2207027,代表應等待,而非修正。Meta 建議每分鐘查看一次狀態,最多不超過 5 分鐘。

ERROR 表示容器處理未能完成,EXPIRED 表示容器在未發佈狀態下已等候 24 小時;兩者均需重新建立容器。PUBLISHED 表示 Reel 已發佈上線。

API 提供哪些 Reel 選項?

除影片及說明文字外,Meta 的 Reel 媒體容器還接受以下參數:

  • share_to_feed:設為 true 時,Reel 會同時出現在動態消息及 Reels 分頁;設為 false 則只限 Reels 分頁。兩者均不保證 Reel 會出現在 Reels 分頁。
  • cover_url:JPEG 檔案,最大 8 MB,用作 Reels 分頁的封面,會裁切為中間的 9:16 部分;分享至動態消息時則裁切為正方形。
  • thumb_offset:以毫秒計的畫格位置,在沒有封面時用作縮圖;0 為第一格畫格。
  • audio_name:Reel 音訊的名稱,只能設定一次。
  • trial_params:發佈試用版 Reel,在轉為正式 Reel 前,只會分享予未追蹤該帳戶的人士。

Reel 還有哪些適用規則?

由媒體容器建立起,Reel 便受以下規則約束:

  • Reel 不能作為輪播項目,必須獨立發佈。
  • 發佈時套用帳戶的私隱設定:若開啟「允許混剪」,新 Reel 亦會允許混剪。
  • 音樂標籤只適用於原創音訊。
  • 日後讀取時,Reel 的 media_type 會顯示為 VIDEO,與其他影片相同。
  • 它計入帳戶在 24 小時內透過 API 發佈的 100 則貼文配額。

Reel 會報告哪些數據指標?

透過媒體數據分析端點,Reel 會報告觸及人數、觀看次數、讚好、留言、已儲存、分享、total_interactions 及轉發,另有三項 Reel 專屬指標:ig_reels_avg_watch_time、ig_reels_video_view_total_time,以及 reels_skip_rate,即在首 3 秒內略過的觀看佔比。讚好、留言及觀看次數只計自然互動,其背後的數據可能延遲最多 48 小時。

常見錯誤

  • 容器一建立便立即發佈。須等待 status_code 顯示 FINISHED,否則呼叫會以子代碼 2207027 失敗。
  • 上傳 WebM 或 AVI 檔案。Reel 必須為 MOV 或 MP4,否則 Meta 會以代碼 352、子代碼 2207026 拒絕。
  • 以為 share_to_feed 會令 Reel 出現在 Reels 分頁。它只會加入動態消息;Reels 分頁顯示的內容由 Instagram 決定。
  • 媒體容器隔夜仍未發佈。它會在建立後 24 小時失效,之後發佈便須重新建立。
使用 EasyCoexistence 完成這項設定

Reel 亦可從其內建的排程佇列排程。每個連接每月由 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,並提供首 3 天免費試用。

常見問題

透過 API 的 Reel 長度可以是多少?

由 3 秒至 15 分鐘,為 MOV 或 MP4 檔案,大小最多 300 MB。

我可以從電腦上傳 Reel 嗎?

使用 Instagram 登入時不可以。API 會從公開網址擷取影片,因此須先將檔案放在可取得公開連結的地方。

透過 API 發佈的 Reel 也會出現在動態消息嗎?

可以。share_to_feed 參數決定 Reel 能否同時出現在動態消息及 Reels 分頁。

為何發佈 Reel 時會因 9007 失敗?

Instagram 仍在處理影片。請查看媒體容器的 status_code,待其顯示 FINISHED 後才發佈;請求本身無須修改。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期