透過 API 發布 Instagram 試用 Reels:trial_params 與轉為一般 Reels
Instagram 的 API 透過在 REELS 容器加入 trial_params 發布試用 Reels,這類 Reels 起初只向非追蹤者顯示。graduation_strategy 設定 Reels 如何觸及追蹤者:MANUAL 由帳戶擁有者在 Instagram 應用程式中自行決定,SS_PERFORMANCE 則在表現良好時自動轉為一般 Reels。Meta 自 2025 年 12 月起已支援透過 Instagram Login 使用此功能。
easyCoexistence 讓你從 Claude、ChatGPT 或你自己的程式碼,以 publish_instagram_post 發布 Reels,並照常發送給追蹤者:此工具不接受 trial_params,因此試用 Reels 須在 Instagram 應用程式中分享。
Meta 將試用 Reels 加入內容發布 API,適用於 Instagram Login 與 Facebook Login。
MANUAL,即在 Instagram 應用程式中手動轉為一般 Reels;或 SS_PERFORMANCE,即試用 Reels 表現良好時自動轉換。
只要請求中包含 trial_params,容器必須具有的 media_type。
Reels 容器可接受的最長影片;最短為 3 秒,最大檔案為 300 MB。
媒體容器在未發布的情況下可保留的時間,之後會過期。
什麼是試用 Reels?
Instagram 只會與並非追蹤該帳戶的人分享的 Reels。轉為一般 Reels 後,便會向追蹤者分享,可以是帳戶擁有者在 Instagram 應用程式中自行選擇,也可以是在表現良好時自動轉換,視乎發布時所設定的策略而定。
如何透過 API 發布?
使用一般 Reels 的呼叫,並加入一個額外參數。以 POST /<IG_ID>/media 建立容器,設定 media_type 為 REELS、video_url、說明文字,以及附帶 graduation_strategy 的 trial_params;等待容器的 status_code 顯示 FINISHED;然後以 POST /<IG_ID>/media_publish 發布,並將容器 ID 作為 creation_id 傳入。
POST https://graph.instagram.com/v26.0/<IG_ID>/media
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
{
"media_type": "REELS",
"video_url": "https://www.example.com/videos/reel.mp4",
"caption": "<CAPTION>",
"trial_params": { "graduation_strategy": "MANUAL" }
}應選擇哪種轉換策略?
如果有人會在追蹤者看到之前先查看結果,請選擇 MANUAL。Reels 會一直只向非追蹤者顯示,直至在 Instagram 應用程式中手動轉為一般 Reels。如果決定可交由 Instagram 處理,請選擇 SS_PERFORMANCE,試用 Reels 表現良好時會自動轉換。graduation_strategy 在 trial_params 內為必填,而且只有這兩個值。
哪些規則仍然適用?
所有 Reels 的規則都適用,因為試用 Reels 是以相同參數加上 trial_params 建立的:
- 影片:MOV 或 MP4,長度由 3 秒至 15 分鐘,檔案最大 300 MB,並須位於 Meta 可以存取的公開 URL。
- 處理:如 Meta 建議,每分鐘檢查一次容器的
status_code,直至顯示 FINISHED,最多檢查 5 分鐘。 - 過期:超過 24 小時仍未發布的容器會過期,必須重新建立。
- 說明文字:最多 2,200 個字元及 20 個 @ 標記,而按 Instagram 現行規定,最多可用 5 個 hashtag(Meta 的 API 參考仍列為 30 個)。
- 輪播:Reels 不能出現在輪播中。
支援 Instagram Login 嗎?
支援。Meta 的更新日誌於 2025 年 12 月 3 日公布,為 Instagram API 的 Instagram Login 與 Facebook Login 加入試用 Reels,其發布指南則示範以 graph.instagram.com 作出呼叫。所需權限為發布權限的兩項:instagram_business_basic 與 instagram_business_content_publish。
可否透過 API 轉換試用 Reels?
Meta 描述試用 Reels 的兩種轉換方式:MANUAL 為在 Instagram 應用程式中手動轉換,SS_PERFORMANCE 為表現良好時自動轉換。其發布指南與媒體參考均沒有描述轉換用的 API 呼叫,因此 API 的職責在試用 Reels 發布後即告完成。
如何從 Claude 或 ChatGPT 發布試用 Reels?
目前無法透過 easyCoexistence 完成。publish_instagram_post 會自行建立 Reel 的容器,且不接受 trial_params,因此它發布的 Reels 會照常發送給追蹤者;而 Instagram 權杖亦不會提供給你自行呼叫使用。請在 Instagram 應用程式中分享試用 Reels,並在分享畫面開啟試用開關。
常見錯誤
- 在相片、輪播或限時動態容器中加入 trial_params。Meta 只在 media_type 為 REELS 時才接受。
- 省略 graduation_strategy。它在 trial_params 內為必填,須為 MANUAL 或 SS_PERFORMANCE。
- 影片尚未處理完成便發布。只有容器的 status_code 顯示 FINISHED,media_publish 才會成功。
- 以為試用 Reels 發布後追蹤者便會看到。它只會向非追蹤者顯示,直至轉換為止。
每個連接每月由 US$ 9 降至 US$ 0.75,連接越多越便宜,並提供 3 天免費試用。
常見問題
能否透過 Instagram API 發布試用 Reels?
可以。在 REELS 容器中加入附有 graduation_strategy 的 trial_params,然後照常發布,無論使用 Instagram Login 或 Facebook Login 皆可。
trial_params 能否用於相片或輪播?
不能。Meta 只接受 media_type 為 REELS 的容器使用 trial_params,因此相片、輪播及限時動態容器不能作為試用貼文。
追蹤者會看到試用 Reels 嗎?
起初不會。試用 Reels 只會與非追蹤者分享,待轉為一般 Reels 後才會觸及追蹤者。
試用 Reels 最長可以多長?
與任何 Reels 相同:3 秒至 15 分鐘,為 MOV 或 MP4 檔案,最大 300 MB,並位於 Meta 可以存取的公開 URL。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期