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

透過 Instagram API 設定 Reel 封面

Instagram 的 API 在建立容器時,有兩種方式設定 Reel 封面:cover_url 指向用作 Reels 分頁封面的 JPEG 圖片,或 thumb_offset 以毫秒計,從影片開頭選取一個畫格。兩者皆未提供時,使用第一個畫格;同時提供兩者時,以 cover_url 為準。

easyCoexistence 透過 Claude、ChatGPT 或您自己的程式碼,使用 publish_instagram_post 發布 Reels。

8 MB

最大的 Reels 封面圖片,必須為 JPEG,其他色彩空間會轉換為 sRGB。

9:16

Meta 建議的封面比例;其他比例會裁切為中間的 9:16 矩形。

1:1

Reel 分享至動態時,Meta 從封面裁切出的中間正方形。

0 ms

預設的 thumb_offset,使影片的第一個畫格成為縮圖。

2207057

thumb_offset 小於 0 或不小於影片長度時的錯誤子代碼。

如何設定 Reel 封面?

在 Reel 的容器上設定。請求 POST /<IG_ID>/media 時,media_type 設為 REELS,video_url 之外還可加入 cover_url 或 thumb_offset 其中一項。cover_url 為 Meta 會擷取並用作 Reels 分頁封面的圖片公開網址;thumb_offset 則為所用畫格的位置,單位為毫秒。封面屬於容器,因此須在發布 Reel 前選定。

A Reel container with its own cover
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json

{
  "media_type": "REELS",
  "video_url": "https://example.com/reel.mp4",
  "caption": "<CAPTION>",
  "cover_url": "https://example.com/cover.jpg"
}

封面圖片須符合什麼要求?

以下為 Meta 對 Reels 封面相片的規格,cover_url 所指的圖片須符合:

  • 格式:JPEG。
  • 檔案大小:最大 8 MB。
  • 色彩空間:sRGB;其他色彩空間的圖片會被轉換。
  • 比例:建議 9:16,以免裁切或留白。
  • 位置:公開伺服器,因為 Meta 會自行從網址擷取圖片。

封面如何裁切?

以中間部分為準。圖片若不是 9:16,Meta 會裁切並以中間的 9:16 矩形作為 Reel 封面;Reel 分享至動態時,中間的 1:1 正方形會成為動態貼文的封面。將臉部與文字置於中央,兩種裁切都能完整顯示。

thumb_offset 如何運作?

它指定影片中的某一時刻(以毫秒計),該時刻的畫格會成為縮圖;預設值 0 即第一個畫格。數值須為 0 或以上,且小於影片長度,否則請求會失敗,回傳代碼 1、子代碼 2207057。thumb_offset 同樣適用於影片容器;若 Reel 同時帶有 cover_url,Meta 會忽略它。

封面可以讀取或稍後更改嗎?

可以讀取:已發布的 Reel 會回報 media_type 為 VIDEO,其 thumbnail_url 欄位會回傳該媒體的縮圖圖片。但更改則另當別論:Meta 所記載對已發布媒體的唯一更新,只能開啟或關閉留言,因此封面在建立容器時即已確定。

常見錯誤

  • 同時傳送 cover_url 與 thumb_offset 並期望使用該畫格。Meta 會採用 cover_url,忽略 thumb_offset。
  • 以秒為單位提供 thumb_offset。它以毫秒計算,若數值等於或超過影片長度,會因子代碼 2207057 而失敗。
  • 上傳 PNG 封面。Reels 封面必須是不超過 8 MB 的 JPEG。
  • 把主體放在封面邊緣。Meta 保留圖片中間的 9:16 範圍,而動態中只保留中間的正方形。
使用 EasyCoexistence 完成這項設定

此工具不接受 cover_url 或 thumb_offset,因此 Reels 會以 Instagram 選取的畫面發布,如要使用其他封面,請在 Instagram 應用程式中選擇。每個連接每月 US$ 9 至 US$ 0.75,連接越多,單價越低,首 3 天免費試用。

常見問題

可以透過 API 為 Reel 上傳自訂封面嗎?

可以。建立 Reel 容器時,傳入不超過 8 MB 的 JPEG 公開網址作為 cover_url 即可。

Reel 封面必須是 sRGB 嗎?

建議如此。Meta 的規格要求 sRGB,並會轉換其他色彩空間的圖片;封面亦須為不超過 8 MB 的 JPEG。

Instagram Reel 出現錯誤 2207057 是什麼意思?

代表 Reel 的 thumb_offset 超出範圍,屬於代碼 1 之下:它必須至少為 0,且小於影片長度,以毫秒計算,因此 5 秒處即為 5000。

若同時傳送 cover_url 與 thumb_offset 會怎樣?

Meta 會使用 cover_url 指定的圖片,並忽略 thumb_offset。

繼續閱讀

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

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

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

驗證日期