Ustawianie okładki Reela przez API Instagrama
API Instagrama ustawia okładkę Reela na jeden z dwóch sposobów przy tworzeniu kontenera: cover_url wskazuje plik JPEG użyty jako okładka w zakładce Reels, a thumb_offset wybiera klatkę wideo w milisekundach od początku. Gdy nie podano żadnego z nich, używana jest pierwsza klatka, a gdy wysłane są oba, cover_url ma pierwszeństwo.
easyCoexistence publikuje Reels przez publish_instagram_post z poziomu Claude, ChatGPT lub własnego kodu.
Największy format okładki Reels; musi być plikiem JPEG, a inne przestrzenie barw są konwertowane do sRGB.
Kształt okładki zalecany przez Meta; inne kształty są przycinane do środkowego prostokąta 9:16.
Środkowy kwadrat, który Meta wycina z okładki, gdy Reel jest udostępniany w Feedzie.
Domyślna wartość thumb_offset, która sprawia, że pierwsza klatka wideo staje się miniaturą.
Podkod błędu dla thumb_offset poniżej 0 lub nie krótszego niż czas trwania wideo.
Jak ustawić okładkę Reela?
Na kontenerze Reela. POST /<IG_ID>/media z media_type REELS i video_url przyjmuje też cover_url, publiczny adres URL obrazu, który Meta pobiera i używa jako okładki w zakładce Reels, albo thumb_offset, pozycję w milisekundach klatki do użycia. Okładka należy do kontenera, więc wybiera się ją przed publikacją Reela.
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"
}Jaki musi być obraz okładki?
Wymagania Meta dla zdjęcia okładki Reels, które obraz pod cover_url musi spełniać:
- Format: JPEG.
- Rozmiar pliku: do 8 MB.
- Przestrzeń barw: sRGB; obrazy w innych przestrzeniach są konwertowane.
- Proporcje: zalecane 9:16, aby uniknąć przycinania lub pustych obszarów.
- Lokalizacja: publiczny serwer, ponieważ Meta pobiera obraz sama z adresu URL.
Jak okładka jest przycinana?
Od środka. Gdy obraz nie ma proporcji 9:16, Meta go przycina i używa środkowego prostokąta 9:16 jako okładki Reela, a gdy Reel jest udostępniany w Feedzie, środkowy kwadrat 1:1 staje się okładką posta w Feedzie. Trzymanie twarzy i tekstu blisko środka sprawia, że oba kadry je pokazują.
Jak działa thumb_offset?
Wskazuje moment w wideo w milisekundach, którego klatka staje się miniaturą; domyślnie 0, czyli pierwsza klatka. Wartość musi wynosić co najmniej 0 i być mniejsza niż czas trwania wideo, inaczej żądanie kończy się błędem z kodem 1, podkodem 2207057. thumb_offset działa też dla kontenerów wideo, a w Reelu, który ma także cover_url, Meta go ignoruje.
Czy okładkę można później odczytać lub zmienić?
Odczytać tak: opublikowany Reel zwraca media_type VIDEO, a pole thumbnail_url zwraca obraz miniatury multimediów. Zmiana to inna sprawa, ponieważ jedyną aktualizacją udokumentowaną przez Meta dla opublikowanych multimediów jest włączanie i wyłączanie komentarzy, więc okładka jest ustalana przy tworzeniu kontenera.
Typowe błędy
- Wysyłanie cover_url i thumb_offset razem i oczekiwanie klatki. Meta używa cover_url i ignoruje thumb_offset.
- Podawanie thumb_offset w sekundach. Liczy on milisekundy, a wartość równa długości wideo lub większa kończy się błędem z podkodem 2207057.
- Wysyłanie okładki w PNG. Okładka Reels musi być plikiem JPEG do 8 MB.
- Umieszczanie głównego motywu na krawędzi okładki. Meta zachowuje środkowe 9:16 obrazu, a w Feedzie tylko środkowy kwadrat.
Narzędzie nie przyjmuje cover_url ani thumb_offset, więc Reel trafia z klatką wybraną przez Instagram, a inną okładkę wybiera się w aplikacji Instagram. Od US$ 9 za połączenie miesięcznie, spadając do US$ 0.75 wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Czy mogę wgrać własną okładkę Reela przez API?
Tak. Podaj cover_url z publicznym adresem URL pliku JPEG do 8 MB przy tworzeniu kontenera Reela.
Czy okładka Reela musi być w sRGB?
Powinna być. Specyfikacja Meta wymaga sRGB i konwertuje obrazy w innych przestrzeniach barw, a okładka musi być plikiem JPEG do 8 MB.
Co oznacza błąd 2207057 w Reelu Instagrama?
Wartość thumb_offset w Reelu jest poza zakresem, w ramach kodu 1: musi wynosić co najmniej 0 i być mniejsza niż czas trwania wideo, liczony w milisekundach, więc 5 sekund od początku to 5000.
Co się stanie, gdy wyślę zarówno cover_url, jak i thumb_offset?
Meta użyje obrazu z cover_url i zignoruje thumb_offset.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w