透過 Instagram API 設定 Reel 封面
Instagram 的 API 在建立容器時,有兩種方式設定 Reel 封面:cover_url 指向用作 Reels 分頁封面的 JPEG 圖片,或 thumb_offset 以毫秒計,從影片開頭選取一個畫格。兩者皆未提供時,使用第一個畫格;同時提供兩者時,以 cover_url 為準。
easyCoexistence 透過 Claude、ChatGPT 或您自己的程式碼,使用 publish_instagram_post 發布 Reels。
最大的 Reels 封面圖片,必須為 JPEG,其他色彩空間會轉換為 sRGB。
Meta 建議的封面比例;其他比例會裁切為中間的 9:16 矩形。
Reel 分享至動態時,Meta 從封面裁切出的中間正方形。
預設的 thumb_offset,使影片的第一個畫格成為縮圖。
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 前選定。
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 範圍,而動態中只保留中間的正方形。
此工具不接受 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 監察
驗證日期