הגדרת תמונת כיסוי ל-Reel דרך ה-API של Instagram
ה-API של Instagram קובע את כיסוי ה-Reel ביצירת ה-container, בשתי דרכים. cover_url מצביע על תמונת JPEG שתשמש ככיסוי בלשונית Reels. thumb_offset בוחר פריים מהסרטון, במילישניות מההתחלה. בלי אחד מהם משמש הפריים הראשון, ואם שניהם נשלחים, cover_url גובר.
easyCoexistence מפרסמת Reels עם publish_instagram_post מ-Claude, מ-ChatGPT או מהקוד שלכם.
התמונה הגדולה ביותר לכיסוי Reels; חייבת להיות JPEG, ומרחבי צבע אחרים מומרים ל-sRGB.
הצורה שממליצה עליה Meta; צורות אחרות נחתכות למלבן 9:16 המרכזי שלהן.
הריבוע המרכזי ש-Meta חותכת מהכיסוי כשה-Reel משותף ל-Feed.
ערך ברירת המחדל של thumb_offset, שהופך את הפריים הראשון של הסרטון לתמונה הממוזערת.
קוד שגיאה משנה עבור thumb_offset שקטן מ-0 או שאינו קטן ממשך הסרטון.
איך מגדירים את כיסוי ה-Reel?
ב-container של ה-Reel. הקריאה POST /<IG_ID>/media עם media_type REELS ועם video_url מקבלת גם 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 משותף ל-Feed, הריבוע 1:1 המרכזי הופך לכיסוי הפוסט ב-Feed. שמירת פנים וטקסט קרוב למרכז מאפשרת לשני החיתוכים להציג אותם.
איך עובד thumb_offset?
הוא מציין רגע בסרטון, באלפיות שנייה, שהפריים שלו הופך לתמונה הממוזערת. ברירת המחדל, 0, היא הפריים הראשון. הערך חייב להיות 0 או יותר ופחות ממשך הסרטון, אחרת הבקשה נכשלת עם code 1, subcode 2207057. thumb_offset חל גם על קונטיינרים של וידאו, וכש-Reel כולל גם cover_url, Meta מתעלמת ממנו.
אפשר לקרוא את הכיסוי או לשנות אותו מאוחר יותר?
לקרוא, כן: Reel שפורסם מדווח על media_type VIDEO, ושדה thumbnail_url מחזיר תמונה ממוזערת של המדיה. שינוי הוא עניין אחר, כי העדכון היחיד ש-Meta מתעדת למדיה שפורסמה הוא הפעלה או כיבוי של תגובות, ולכן הכיסוי נקבע ביצירת ה-container.
טעויות נפוצות
- שליחת השדה cover_url יחד עם השדה thumb_offset וציפייה לפריים. Meta משתמשת בשדה cover_url ומתעלמת מהשדה thumb_offset.
- הגדרת thumb_offset בשניות. הערך נספר במילישניות, וערך שמגיע לאורך הסרטון או עובר אותו נכשל עם subcode 2207057.
- העלאת PNG ככיסוי. כיסוי ל-Reels חייב להיות JPEG עד 8 MB.
- מיקום הנושא בקצה הכיסוי. Meta שומרת על המלבן 9:16 המרכזי של התמונה, וב-Feed רק על הריבוע המרכזי.
הכלי לא מקבל cover_url או thumb_offset, ולכן הריל יוצא עם הפריים ש-Instagram בוחר, וכיסוי אחר נבחר באפליקציית Instagram. US$ 9 עד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 הימים הראשונים.
שאלות נפוצות
אפשר להעלות כיסוי מותאם ל-Reel דרך ה-API?
כן. שולחים את cover_url עם הכתובת הציבורית של JPEG עד 8 MB בעת יצירת ה-container של ה-Reel.
האם כיסוי של Reel חייב להיות sRGB?
כן, כדאי. המפרט של Meta מבקש sRGB וממיר תמונות ממרחבי צבע אחרים, והכיסוי חייב להיות JPEG עד 8 MB.
מה משמעות שגיאה 2207057 ב-Reel של Instagram?
thumb_offset של ה-Reel חורג מהטווח, תחת code 1: הערך חייב להיות 0 לפחות ופחות ממשך הסרטון, ונספר במילישניות, כך ש-5 שניות הן 5000.
מה קורה אם שולחים גם cover_url וגם thumb_offset?
Meta משתמשת בתמונה של cover_url ומתעלמת מהשדה thumb_offset.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-