Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

8 MB

Największy format okładki Reels; musi być plikiem JPEG, a inne przestrzenie barw są konwertowane do sRGB.

9:16

Kształt okładki zalecany przez Meta; inne kształty są przycinane do środkowego prostokąta 9:16.

1:1

Środkowy kwadrat, który Meta wycina z okładki, gdy Reel jest udostępniany w Feedzie.

0 ms

Domyślna wartość thumb_offset, która sprawia, że pierwsza klatka wideo staje się miniaturą.

2207057

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.

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"
}

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.
Z EasyCoexistence zrobisz to

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