TL;DR, szybka odpowiedź
7 min czytaniaDokumentacja IG User Media ustala dla reeli maksymalnie 15 minut i minimum 3 sekundy, plik do 300 MB, kontener MOV lub MP4 z atomem moov na początku, wideo H264 lub HEVC, dźwięk AAC, od 23 do 60 FPS oraz proporcje "between 0.01:1 and 10:1" z zalecanym 9:16. Meta publikuje podkod błędu dla złego formatu wideo, 2207026, ale nie dokumentuje osobnego podkodu dla reela zbyt długiego lub zbyt ciężkiego.
Co przyjmuje API Instagram Reels?
Wideo wysyłane przez API Instagram Reels musi spełnić każdy punkt jednej opublikowanej specyfikacji, zanim Meta je przetranskoduje, a specyfikacja ta znajduje się w jednym miejscu: w sekcji Reel Specifications dokumentacji IG User Media. Wystarczy jedno niedopatrzenie, a kontener utworzony z media_type=REELS wróci ze status_code ustawionym na ERROR zamiast FINISHED.
Oto cała lista, przepisana z dokumentacji Meta.
| Właściwość | Opublikowana zasada Meta |
|---|---|
| Długość | Maksymalnie 15 minut, minimum 3 sekundy |
| Rozmiar pliku | Maksymalnie 300 MB |
| Kontener | MOV lub MP4 (MPEG-4 Part 14), bez list edycji, atom moov na początku pliku |
| Kodek wideo | HEVC lub H264, skanowanie progresywne, zamknięty GOP, podpróbkowanie 4:2:0 |
| Kodek audio | AAC, próbkowanie maksymalnie 48 kHz, 1 lub 2 kanały (mono lub stereo) |
| Bitrate wideo | VBR, maksymalnie 25 Mb/s |
| Bitrate audio | 128 kb/s |
| Liczba klatek | 23-60 FPS |
| Maksymalna szerokość | 1920 pikseli w poziomie |
| Proporcje | Od 0.01:1 do 10:1, zalecane 9:16 |
Jak długi może być reel publikowany przez API?
Piętnaście minut. Meta pisze "Duration: 15 mins maximum, 3 seconds minimum", więc górny limit API jest znacznie wyższy, niż większość osób się spodziewa, a dolny wyższy, niż większość zauważa.
Problemy sprawia właśnie minimum trzech sekund. Klip przycięty do dwóch i pół sekundy to w pozostałej części internetu całkiem zwyczajny materiał, a tutaj natychmiastowe odrzucenie. Nie ma taryfy ulgowej, a Meta niczego po swojej stronie nie dopełnia.
Górny limit piętnastu minut wymaga zastrzeżenia, którego Meta do niego nie dołącza. Ta liczba określa, co API przyjmie do kontenera. Nie mówi nic o tym, co aplikacja Instagram pozwoli przesłać z telefonu, ani o tym, co system rekomendacji zrobi z czternastominutowym reelem, gdy już powstanie. Właśnie takie ostrzeżenie Meta dołącza do parametru share_to_feed, zaznaczając, że żadna z wartości nie "determines whether the reel actually appears in the Reels tab because the reel may not meet eligibilty requirements or may not be selected by our algorithm." To, że API przyjmie plik, i to, że Instagram go rozpowszechni, to dwie różne sprawy.
Jak duży może być plik?
300 MB. Meta pisze "File size: 300MB maximum" w odniesieniu do reeli, a ta wartość dotyczy tylko ich: na tej samej stronie wideo w relacji ma limit "100MB maximum", a obraz "8 MB maximum".
Jeśli plik źródłowy jest duży albo połączenie zawodne, Meta oferuje drugą ścieżkę przesyłania zamiast wyższego limitu. Ustawienie upload_type=resumable w wywołaniu tworzącym kontener zwraca id oraz uri, a następnie wysyłasz bajty na rupload.facebook.com z nagłówkami offset i file_size:
curl -X POST "https://rupload.facebook.com/ig-api-upload/v25.0/<IG_CONTAINER_ID>" \
-H "Authorization: OAuth <ACCESS_TOKEN>" \
-H "offset: 0" \
-H "file_size: Your_file_size_in_bytes" \
--data-binary "@my_video_file.mp4"Meta opisuje sesję wznawianą jako przeznaczoną dla "large videos from an area with frequent network interruptions or other transmission failures" i ogranicza ją do aplikacji, które wdrożyły Facebook Login for Business. Limit 300 MB nadal obowiązuje.

Jakie kontenery i kodeki działają?
Tylko MOV lub MP4, z wideo H264 lub HEVC i dźwiękiem AAC. Dwa zapisy w zasadzie dotyczącej kontenera powodują więcej błędów niż same nazwy kodeków.
Pierwszy to "moov atom at the front of the file". Atom moov zawiera indeks, który mówi odtwarzaczowi, gdzie znajduje się cała reszta. Enkodery domyślnie zapisują go na końcu, bo rozmiary nie są znane przed zakończeniem kodowania. Przeniesienie go na początek to w FFmpeg opcja -movflags +faststart, a bez niej Meta musi odczytać cały plik, zanim zacznie pracę, co często kończy się błędem przekroczenia czasu pobierania, a nie błędem formatu.
Drugi to "no edit lists". Lista edycji to tabela wskazująca, które fragmenty ścieżki odtwarzać i kiedy. Narzędzia do przycinania często zostawiają ją w pliku zamiast kodować materiał od nowa. Plik działa prawidłowo w każdym odtwarzaczu na komputerze, a tutaj zostaje odrzucony.
Reszta zasady dotyczącej wideo, "progressive scan, closed GOP, 4:2:0 chroma subsampling", wyklucza materiał z przeplotem i kodowanie z otwartym GOP. Standardowy eksport H264 w 4:2:0 spełnia wszystkie trzy warunki bez żadnych dodatkowych działań.
Jakiej liczby klatek i proporcji wymaga Meta?
Liczba klatek musi mieścić się między 23 a 60 FPS. Meta pisze "Frame rate: 23-60 FPS", co wyklucza 15 FPS, które domyślnie dają programy do nagrywania ekranu i kilka narzędzi wideo opartych na AI, a także 120 FPS, w których telefon nagrywa slow motion.
Przy proporcjach liczby Meta robią się dziwne. Zasada dla reeli brzmi: "Required aspect ratio is between 0.01:1 and 10:1 but we recommend 9:16 to avoid cropping or blank space." Proporcje 0.01:1 oznaczają wideo sto razy wyższe niż szersze. Sekcja Story Video Specifications tuż pod nią, opisująca ten sam proces transkodowania, ustala granicę "between 0.1:1 and 10:1". Te dwie wartości różnią się dziesięciokrotnie i obie widnieją na tej samej stronie.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Żadna z tych granic nie jest zasadą projektową. Zasadą projektową jest 9:16, a rozdzielczość w praktyce ogranicza maksymalna szerokość 1920 pikseli. Skąd bierze się 1080 na 1920, wyjaśniamy w tekście o wymiarach pionowego wideo, a osobny zakres od 4:5 do 1.91:1 obowiązujący zdjęcia w feedzie opisujemy w artykule o rozmiarach obrazów na Instagramie.
Jaki błąd zwraca każde naruszenie?
Meta publikuje tabelę podkodów dla API Instagrama, a zestawienie jej ze specyfikacją reeli ujawnia lukę. Niektóre naruszenia mają własny błąd. Kilka nie ma go wcale.
| Naruszenie | Udokumentowany podkod | Komunikat |
|---|---|---|
| Zły kontener lub kodek | 2207026 | The video format is not supported. Please check spec for supported {video} format |
| Nie można pobrać wideo | 2207052 | The media could not be fetched from this uri: {uri} |
| Zbyt wolne pobieranie | 2207003 | It takes too long to download the media. |
| Okładka powyżej 8 MiB | 2207004 | The image is too large to download. It should be less than {size}. |
| Miniatura poza końcem filmu | 2207057 | Thumbnail offset must be greater than or equal to 0 and less than video duration |
| Zbyt długi opis | 2207010 | The submitted image's caption was {submitted-caption-length} characters long. |
| Nieudane przesłanie, nieznana przyczyna | 2207053 | unknown upload error |
W tej tabeli nie ma długości. Nie ma też rozmiaru pliku, liczby klatek ani proporcji reeli. Meta dokumentuje podkod dotyczący proporcji, 2207009, ale zalecane przez nią rozwiązanie mówi o obrazach: "Advise the app user to try again with an image that falls withing a 4:5 to 1.91:1 range." Odpowiednika dla reeli nie ma na liście.
Odesłanie w samej tabeli też jest zepsute. Rozwiązanie Meta dla 2207026 brzmi "Advise the app user to upload an MOV or MP4 (MPEG-4 Part 14). See Video Specifications", a link prowadzi do kotwicy #video-specifications w dokumentacji IG User Media. Ta strona zawiera dziś sekcje Image Specifications, Reel Specifications, Story Image Specifications i Story Video Specifications. Sekcji Video Specifications, do której można by trafić, nie ma.
Praktyczna konsekwencja: zbyt długi lub zbyt duży reel najczęściej kończy się kodem 2207053, czyli nieznanym błędem przesyłania, którego udokumentowane rozwiązanie brzmi "Generate a new container and use it to try again." To mało pomocny komunikat dla pliku, który i tak nigdy nie zostałby przyjęty, i dlatego warto sprawdzić długość oraz rozmiar lokalnie, zanim w ogóle wywołasz POST /<IG_ID>/media.

Skąd wiadomo, że reel przeszedł?
Odpytuj kontener. Dokumentacja Meta mówi wprost: "Video uploads are asynchronous, so receiving a container ID does not guarantee that the upload was successful", a potwierdzenie uzyskasz, pobierając status_code i czekając na FINISHED. Pełny zestaw wartości i zalecaną przez Meta częstotliwość odpytywania opisujemy w tekście o status_code kontenera na Instagramie. Jeśli budujesz cały proces, a nie szukasz błędu w jednym pliku, pozostałe wywołania omawia przewodnik o planowaniu reeli na Instagramie.
Najczęściej zadawane pytania
Jaka jest maksymalna długość reela przez API?
Piętnaście minut. Sekcja Reel Specifications Meta podaje "Duration: 15 mins maximum, 3 seconds minimum."
Jaki jest maksymalny rozmiar pliku reela?
300 MB. Wideo w relacjach ma w tej samej dokumentacji niższy limit, 100 MB.
Czy API przyjmuje WebM lub AVI?
Nie. Meta wymienia tylko MOV i MP4, a dla wszystkiego innego zwraca podkod 2207026 z komunikatem The video format is not supported.
Czy reel może pojawić się w karuzeli?
Nie. Ograniczenia reeli według Meta mówią: "Reels cannot appear in carousels."
Jakich proporcji powinien używać reel?
9:16. Zakres akceptowany przez Meta jest znacznie szerszy, "between 0.01:1 and 10:1", ale to samo zdanie zaleca 9:16 "to avoid cropping or blank space".
Czy reel potrzebuje obrazu okładki?
Nie. Możesz przekazać cover_url lub thumb_offset, a Meta domyślnie ustawia thumb_offset na 0, czyli pierwszą klatkę. Jeśli podasz oba parametry, Meta użyje cover_url i zignoruje thumb_offset.
Co się stanie, jeśli reel zostanie przycięty do mniej niż trzech sekund?
Meta odrzuci go od razu. Reel Specifications ustalają minimum 3 sekund, a Meta niczego po swojej stronie nie dopełnia. Klip, który działa wszędzie indziej w internecie, tutaj odpada, bo jest za krótki.
Dlaczego zbyt duży reel zwraca "unknown upload error" zamiast jasnego komunikatu?
Tabela podkodów Meta nie ma osobnej pozycji dla naruszeń długości ani rozmiaru pliku. Zbyt długi lub zbyt duży reel najczęściej kończy się podkodem 2207053, którego jedyne udokumentowane rozwiązanie to utworzenie nowego kontenera i ponowna próba. To nic nie da w przypadku pliku, który i tak nie zostałby przyjęty, dlatego lokalne sprawdzenie długości i rozmiaru przed wywołaniem API oszczędza zbędne zapytanie.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Jak limit rozmiaru reela wypada na tle relacji i obrazu?
Reel może ważyć do 300 MB. Wideo w relacji ma limit 100 MB, a obraz 8 MB, wszystko na tej samej stronie dokumentacji IG User Media. Limit dla reela jest trzykrotnie wyższy niż dla relacji.
Dlaczego wideo, które działa na komputerze, zostaje odrzucone przez API?
Większość takich błędów powodują dwa szczegóły kontenera. Lista edycji pozostawiona przez program do przycinania albo atom moov zapisany na końcu pliku zamiast na początku działają bez problemu w zwykłych odtwarzaczach, ale kończą się błędem lub przekroczeniem czasu w zderzeniu ze specyfikacją Meta. Ponowne zakodowanie z atomem moov przeniesionym na początek, czyli z opcją FFmpeg -movflags +faststart, i bez listy edycji rozwiązuje oba problemy.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Dwadzieścia minut w aplikacji: jak długie mogą być Reels na Instagramie
Jak długie mogą być Reels na Instagramie? 20 minut w aplikacji, 15 przez API Meta i 3 minuty, zanim Instagram przestanie pokazywać je nowym odbiorcom.


Rozmiar reela na Instagramie według Meta i miejsca, w których jej strony się różnią
Meta ustala rozmiar reela na Instagramie na 9:16, przyjmuje pliki od 1.91:1 do 9:16 i wymaga minimum 720 pikseli oraz 30 FPS. Pełna specyfikacja, okładki i eksport.


Trzy odpowiedzi na pytanie, jak długie mogą być Reels na Facebooku
Jak długie mogą być Reels na Facebooku? W aplikacji dowolnie długie od 2025, przez API od 3 do 90 sekund, a w grupach 30 sekund, według stron samej Meta.
Powiązane artykuły


Jak rolki próbne na Instagramie docierają do nieobserwujących przed twoimi obserwującymi
Rolki próbne na Instagramie trafiają najpierw do nieobserwujących, a do obserwujących dopiero po udostępnieniu. Wymagania, statystyki i ustawienie w API.


Sesja wznawianego przesyłania na Instagramie i host rupload
Wznawiane przesyłanie na Instagramie zaczyna się od upload_type=resumable w /media, po czym następuje POST na rupload.facebook.com z nagłówkami offset i file_size.


Dwa kształty, jeden kadr: rozmiar okładki reela na Instagramie według Meta
Rozmiar okładki reela na Instagramie to 420 x 654 w centrum pomocy Meta i 9:16 w API, które przycina środkowy kwadrat do feedu. Jak zrobić jedną okładkę.

