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

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ę.

15 min

Najdłuższy Reel publikowany przez API; najkrótszy ma 3 sekundy.

300 MB

Maksymalny rozmiar pliku Reel: MOV lub MP4 z wideo H.264 lub HEVC i audio AAC.

1 min

Jak często Meta sugeruje sprawdzać status przetwarzanego kontenera, nie dłużej niż przez 5 minut.

24 hours

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

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