Publikowanie Reel na Instagramie przez API
API Instagrama publikuje Reel z pliku MOV lub MP4 dostępnego pod publicznym adresem URL: tworzysz kontener z media_type REELS, czekasz, aż Meta przetworzy wideo, a potem je publikujesz. Reel może trwać od 3 sekund do 15 minut i ważyć do 300 MB, a Meta zaleca kadr 9:16, aby uniknąć przycinania lub pustego miejsca.
easyCoexistence publikuje Reel przez publish_instagram_post z Claude, ChatGPT lub własnego kodu: podajesz adres URL wideo i podpis, a jeśli wideo wciąż się przetwarza, narzędzie samo kończy publikację.
Najdłuższy Reel publikowany przez API; najkrótszy ma 3 sekundy.
Maksymalny rozmiar pliku Reel: MOV lub MP4 z wideo H.264 lub HEVC i audio AAC.
Jak często Meta sugeruje sprawdzać status przetwarzanego kontenera, nie dłużej niż przez 5 minut.
Jak długo kontener Reel może czekać nieopublikowany, zanim wygaśnie.
Jak publikuje się Reel?
W trzech krokach. Najpierw wysyłasz POST /<IG_ID>/media z media_type ustawionym na REELS, video_url wskazującym plik i, jeśli chcesz, podpis; Meta pobiera wideo i zwraca ID kontenera. Następnie czekasz, aż Instagram przetworzy wideo, sprawdzając status_code kontenera. Na koniec wysyłasz POST /<IG_ID>/media_publish z creation_id równym ID kontenera, a odpowiedź zawiera nowe ID multimediów.
Meta dokumentuje wznawialne przesyłanie, które może wysłać plik z komputera, ale wyłącznie w konfiguracjach opartych na Facebook Login for Business, łącznie z Unified Login. Przy Instagram Login wideo zawsze pochodzi z publicznego adresu URL.
Jakie są wymagania dla wideo?
Specyfikacja Meta dla Reel, którą plik musi spełnić, zanim Instagram go przetworzy:
- Kontener: MOV lub MP4 (MPEG-4 Part 14), bez list edycji, z atomem moov na początku pliku.
- Wideo: H.264 lub HEVC, skanowanie progresywne, zamknięta GOP, subsampling chrominancji 4:2:0, 23 do 60 klatek na sekundę, do 1920 pikseli szerokości i 25 Mbps.
- Audio: AAC, do 48 kHz, mono lub stereo, 128 kbps.
- Proporcje: od 0,01:1 do 10:1, zalecane 9:16.
- Długość i rozmiar: od 3 sekund do 15 minut, do 300 MB.
Co dzieje się podczas przetwarzania wideo?
status_code kontenera przyjmuje wartość IN_PROGRESS, dopóki Instagram nie przetworzy wideo, a potem FINISHED; dopiero wtedy można je opublikować. Publikacja wcześniej się nie udaje, z kodem 9007 i podkodem 2207027, co oznacza, że trzeba poczekać, a nie naprawiać. Meta sugeruje sprawdzać status raz na minutę, nie dłużej niż przez 5 minut.
ERROR oznacza, że kontener nie zdołał zakończyć przetwarzania, a EXPIRED, że przez 24 godziny czekał nieopublikowany; oba stany wymagają nowego kontenera. PUBLISHED oznacza, że Reel jest już opublikowany.
Jakie opcje Reel oferuje API?
Poza wideo i podpisem kontener Reel w ujęciu Meta przyjmuje te parametry:
share_to_feed: true sprawia, że Reel pojawia się w Feedzie oraz na zakładce Reels, a false zachowuje go tylko na zakładce Reels. Żadna z wartości nie gwarantuje miejsca na zakładce Reels.cover_url: plik JPEG do 8 MB używany jako okładka na zakładce Reels, przycięty do środka w proporcji 9:16, a przy udostępnieniu w Feedzie do kwadratu.thumb_offset: klatka w milisekundach użyta jako miniatura, gdy nie ma okładki; 0 to pierwsza klatka.audio_name: nazwa dźwięku Reel, którą można ustawić tylko raz.trial_params: publikuje Reel próbny, udostępniany tylko osobom, które nie obserwują konta, dopóki nie zostanie przeniesiony do zwykłej publikacji.
Co jeszcze dotyczy Reel?
Kilka zasad obowiązuje Reel od chwili utworzenia kontenera.
- Reel nie może być elementem karuzeli; zawsze jest publikowany samodzielnie.
- Ustawienia prywatności konta obowiązują przy publikacji: przy włączonym „zezwalaj na remiksowanie” nowy Reel także dopuszcza remiksowanie.
- Oznaczanie muzyki jest dostępne tylko dla oryginalnego dźwięku.
- Odczytany później Reel ma
media_typeVIDEO, jak każde inne wideo. - Liczy się jako jeden z 100 postów opublikowanych przez API na konto w ciągu 24 godzin.
Jakie metryki raportuje Reel?
Przez endpoint insightów multimediów Reel raportuje reach, views, likes, comments, saved, shares, total_interactions i reposts oraz trzy własne metryki: ig_reels_avg_watch_time, ig_reels_video_view_total_time i reels_skip_rate, czyli udział wyświetleń pominiętych w ciągu pierwszych 3 sekund. Polubienia, komentarze i wyświetlenia liczą tylko aktywność organiczną, a dane za nimi mogą opóźniać się do 48 godzin.
Typowe błędy
- Publikowanie zaraz po utworzeniu kontenera. Poczekaj, aż status_code pokaże FINISHED, inaczej wywołanie zakończy się błędem z podkodem 2207027.
- Wysyłanie pliku WebM lub AVI. Reel musi być w formacie MOV lub MP4, inaczej Meta go odrzuci kodem 352 i podkodem 2207026.
- Oczekiwanie, że share_to_feed umieści Reel na zakładce Reels. Parametr dodaje tylko Feed; to Instagram decyduje, co pokazuje zakładka Reels.
- Pozostawienie nieopublikowanego kontenera na noc. Wygasa 24 godziny po utworzeniu, a publikacja wymaga wtedy nowego.
Reel można też zaplanować w jego własnej kolejce. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, mniej w miarę dodawania połączeń, a pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Jak długi może być Reel przez API?
Od 3 sekund do 15 minut, jako plik MOV lub MP4 o rozmiarze do 300 MB.
Czy mogę przesłać Reel z komputera?
Nie przy Instagram Login. API pobiera wideo z publicznego adresu URL, więc najpierw umieść plik w miejscu, które daje mu publiczny link.
Czy Reel opublikowany przez API pojawia się też w Feedzie?
Może. Parametr share_to_feed decyduje, czy Reel może pojawić się w Feedzie oraz na zakładce Reels.
Dlaczego publikacja Reel kończy się błędem 9007?
Instagram nadal przetwarza wideo. Sprawdź status_code kontenera i opublikuj, gdy pokaże FINISHED; w żądaniu nie trzeba nic poprawiać.
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