Facebook Reels API:向粉絲專頁發布 Reels
Facebook Reels API 分三個步驟,向粉絲專頁發布一個 Reel:先以 upload_phase 為 start 呼叫 POST /{page-id}/video_reels,取得 video_id;再把影片上傳至 rupload.facebook.com;最後以 upload_phase 為 finish、video_state 為 PUBLISHED 呼叫 POST /{page-id}/video_reels 完成發布。Meta 的規格為 9:16 的影片,長度 3 至 90 秒,每個粉絲專頁每 24 小時可透過 API 發布 30 個 Reels。
easyCoexistence 以 publish_facebook_post 將影片以一般影片貼文的形式發布到 Facebook 專頁,可由 Claude、ChatGPT 或你自己的程式使用,與文字、連結及相片並列。
透過 POST /{page_id}/video_reels 執行,限制每個粉絲專頁在 24 小時滾動期間內,透過 API 發布的 Reels 數量。
Meta 接受的 Reel 長度;以限時動態形式發布至粉絲專頁的 Reel 不得超過 60 秒。
Reel 的最低解像度;Meta 建議使用 1080 x 1920 像素、9 x 16 的長寬比。
可為 Reel 設定的最遠 scheduled_publish_time,至少須為 10 分鐘後,並搭配 video_state SCHEDULED。
Reel 長度不受 Facebook 支援時的錯誤代碼;Reels 須為 3 至 90 秒。
Reels API 如何發布 Reel?
分三個步驟、跨兩個主機完成。起始與完成呼叫發送至 graph.facebook.com 上粉絲專頁的 video_reels 端點,影片本身則上傳至起始呼叫所回傳的 upload_url,即 rupload.facebook.com。在上傳與完成之間,可對影片 ID 查詢狀態,確認 Meta 已收到完整檔案並完成處理。
Reel 需要什麼影片?
Meta 在《Reels Publishing 指南》中公布 Reels 規格;若上傳的長寬比、解像度、長度或幀率不符,會以專屬錯誤代碼被拒。供粉絲專頁限時動態使用的 Reel,長度也必須在 60 秒以內。
如何上傳影片?
以 POST 傳送至 rupload.facebook.com 的 upload_url,並在 Authorization: OAuth 標頭中附上粉絲專頁存取權杖。本機檔案以請求主體傳送,offset 標頭設為 0,file_size 設為以位元組計的檔案大小。已在網上的檔案則改用 file_url 標頭,由 Meta 自行抓取;上傳成功會回傳 success 為 true。
file_url接受 http 或 https 位址;需要驗證的 URL 不受支援。- 主機必須允許 facebookexternalhit/1.1 用戶代理程式抓取檔案,若網站的 robots.txt 封鎖它,Meta 會拒絕該檔案。
- Meta 自家 CDN 上的檔案,例如 fbcdn 網址,會被拒絕;Meta 建議改以跨版發布重用其他粉絲專頁的影片。
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"如何查詢 Reel 的狀態?
發送 GET /{video-id}?fields=status 至 graph.facebook.com。回應包含 video_status,其值為 uploading、upload_complete、processing、ready、upload_failed、expired 或 error,並為每個階段提供一個物件:uploading_phase 含 bytes_transfered,processing_phase 含任何錯誤訊息,publishing_phase 含 publish_status(draft、scheduled、published 或 error)與 publish_time。各階段自身的狀態為 not_started、in_progress、completed 或 error。
中斷的上傳如何續傳?
重新發送上傳 POST,並把 offset 標頭設為狀態查詢中 uploading_phase.bytes_transfered 的值,即 Meta 已收到的位元組數。若 Meta 不接受該偏移量,會回傳 OffsetInvalidError;若主體長度與檔案不符,則回傳 PartialRequestError。若重新上傳仍無效,Meta 建議從第一步重新開始。
完成呼叫需要什麼?
起始呼叫中的 video_id、upload_phase 設為 finish,以及 video_state 設為 PUBLISHED、DRAFT 或 SCHEDULED。description 放置文字,並支援主題標籤。title、place(適用於地點粉絲專頁),以及 is_ai_generated(聲明該 Reel 由 AI 建立或編輯)皆為選填。排程的 Reel 另須加入 scheduled_publish_time,即 UNIX 時間戳,且須較目前時間晚 10 分鐘以上,並不超過 29 天後。Meta 會回傳 success 為 true。
粉絲專頁可透過 API 發布多少 Reels?
在 24 小時滾動期間內為 30 個。Meta 在發布 Reel 時於 POST /{page_id}/video_reels 執行此上限,並建議應用程式自行執行,特別是讓用戶安排日後發布的應用程式。協作者邀請有獨立上限,每個粉絲專頁每 24 小時 10 次;video_reels 參考資料列出錯誤 613,即此 API 的呼叫已超過速率限制。
需要哪些權限與粉絲專頁任務?
由能執行粉絲專頁 CREATE_CONTENT 任務的人員所取得的粉絲專頁存取權杖,並透過 Facebook Login 授予 pages_show_list、pages_read_engagement 與 pages_manage_posts。Meta 亦要求應用程式向用戶顯示披露,說明其 Reels 在 Facebook 上的用途,並提供控制選項,且只提供公開受眾,因為發布至粉絲專頁具有隱含的公開範圍。
Reels API 會回傳哪些錯誤?
代碼 100 表示缺少必要參數,例如 upload_phase,Meta 的訊息會列出所有缺少的參數。另有四個代碼會拒絕不符合規格的影片:
- 1363040:長寬比不受支援;影片須介於 16x9 與 9x16 之間。
- 1363127:解像度不受支援;最低為 540 x 960 像素。
- 1363128:長度不受支援;Reels 須為 3 至 90 秒。
- 1363129:平均幀率不受支援;Reels 需要每秒 24 至 60 幀。
如何列出粉絲專頁的 Reels?
發送 GET /{page-id}/video_reels,會回傳粉絲專頁已發布的 Reels,包括其 ID、更新時間與描述。since 與 until 可將結果限制在指定日期,日期可為 today、yesterday、UNIX 時間戳或 yyyy-mm-dd,且 until 須晚於 since。Meta 的動態消息參考文件即指向此端點,以取得發布至粉絲專頁的 Reels。
如何透過 easyCoexistence 發布 Reel?
目前不能以 Reel 發布。publish_facebook_post 會將影片以一般影片貼文的形式傳送至粉絲專頁的 videos 端點,而 easyCoexistence 沒有 video_reels 呼叫的工具;專頁存取權杖不會交出,因此這三個步驟也無法從你自己的程式透過其連接執行。請在 Facebook 或 Meta Business Suite 發布 Reel,或把影片以一般影片貼文發布。
常見錯誤
- 把上傳送到 graph.facebook.com。影片應送往 rupload.facebook.com,並附上 Authorization: OAuth 標頭;只有起始、完成與狀態呼叫使用 graph.facebook.com。
- 把檔案放在 Meta 無法抓取的地方。若 file_url 位於登入之後、網站的 robots.txt 封鎖 facebookexternalhit/1.1,或位於 fbcdn,都會被拒絕。
- 上傳中斷後從頭開始。應先查詢狀態:uploading_phase.bytes_transfered 是續傳的偏移量,建立新工作階段只是最後的手段。
- 同一天為單一粉絲專頁排入超過 30 個 Reels。Meta 以 24 小時滾動期間計算透過 API 發布的 Reels,因此排程發布的 Reels 應分散安排。
它沒有 Reels API 的工具,因此 Reel 須在 Facebook 或 Meta Business Suite 發布。每個連接每月 US$ 9 至 US$ 0.75,連接越多費用越低,前 3 天免費試用。
常見問題
能否透過 API 把 Reel 發布到 Facebook 個人檔案或社團?
不能。Meta 的 Reels Publishing API 只把 Reels 發布到 Facebook 粉絲專頁,並且只跨版發布到其他粉絲專頁。
publish_facebook_post 會發布 Reels 嗎?
不會。它將文字、連結、相片與影片發布到粉絲專頁。Reel 須執行 video_reels 呼叫,而 easyCoexistence 的工具並不會執行這些呼叫。
如何檢查 Reel 是否有版權相符?
使用 pages_read_engagement 權限讀取 GET /{video-id}?fields=copyright_check_information。Meta 在上傳時執行檢查,可能需要數分鐘,且只有擁有者能看到相符結果。
其他粉絲專頁可以發布我的 Reel 嗎?
可以,以協作者身分。發送 POST /{video-id}/collaborators,並將 target_id 設為對方粉絲專頁的 ID 以發出邀請;對方接受後,該 Reel 也會出現在其粉絲專頁上。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期