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

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 或你自己的程式使用,與文字、連結及相片並列。

30 a day

透過 POST /{page_id}/video_reels 執行,限制每個粉絲專頁在 24 小時滾動期間內,透過 API 發布的 Reels 數量。

3 to 90 s

Meta 接受的 Reel 長度;以限時動態形式發布至粉絲專頁的 Reel 不得超過 60 秒。

540 x 960

Reel 的最低解像度;Meta 建議使用 1080 x 1920 像素、9 x 16 的長寬比。

29 days

可為 Reel 設定的最遠 scheduled_publish_time,至少須為 10 分鐘後,並搭配 video_state SCHEDULED。

1363128

Reel 長度不受 Facebook 支援時的錯誤代碼;Reels 須為 3 至 90 秒。

Reels API 如何發布 Reel?

分三個步驟、跨兩個主機完成。起始與完成呼叫發送至 graph.facebook.com 上粉絲專頁的 video_reels 端點,影片本身則上傳至起始呼叫所回傳的 upload_url,即 rupload.facebook.com。在上傳與完成之間,可對影片 ID 查詢狀態,確認 Meta 已收到完整檔案並完成處理。

1StartPOST /{page-id}/video_reels, upload_phase start: returns video_id and upload_url
2UploadPOST to rupload.facebook.com with the bytes or a file_url header
3CheckGET /{video-id}?fields=status until processing completes
4FinishPOST /{page-id}/video_reels, upload_phase finish, video_state PUBLISHED

Reel 需要什麼影片?

Meta 在《Reels Publishing 指南》中公布 Reels 規格;若上傳的長寬比、解像度、長度或幀率不符,會以專屬錯誤代碼被拒。供粉絲專頁限時動態使用的 Reel,長度也必須在 60 秒以內。

File.mp4 recommended
Aspect ratio9 x 16
Resolution1080 x 1920 recommended, 540 x 960 at least
Frame rate24 to 60 fps, fixed, progressive scan
Duration3 to 90 seconds
VideoH.264 or H.265 (VP9 and AV1 also supported), 4:2:0, closed GOP of 2 to 5 s
AudioAAC Low Complexity, 48 kHz, stereo, 128 kbps or more

如何上傳影片?

以 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 建議改以跨版發布重用其他粉絲專頁的影片。
Uploading a hosted video
# <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 應分散安排。
使用 EasyCoexistence 完成這項設定

它沒有 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 監察

驗證日期