TL;DR, szybka odpowiedź
8 min czytaniaMeta podaje w dokumentacji POST /<IG_ID>/media cztery zasady dla obrazów: format JPEG, maksymalnie 8 MB, proporcje w zakresie od 4:5 do 1.91:1 i szerokość od 320 do 1440 pikseli. Format, rozmiar i proporcje mają własne kody błędów: 36001, 36000 i 36003. Szerokość w ogóle nie zwraca błędu, bo Meta skaluje obraz. Limit rozmiaru jest opublikowany dwukrotnie: jako 8 MB w specyfikacji i jako 8 MiB w treści błędu.
Jakie są wymagania API Instagrama dla obrazów?
Wymagania API Instagrama dla obrazów to cztery zasady, a Meta podaje je w jednym bloku "Image Specifications" w dokumentacji POST /<IG_ID>/media: format JPEG, maksymalny rozmiar pliku 8 MB, proporcje w zakresie od 4:5 do 1.91:1 i szerokość od 320 do 1440 pikseli. W brzmieniu opublikowanym przez Meta:
Format: JPEG
File size: 8 MB maximum.
Aspect ratio: Must be within a 4:5 to 1.91:1 range
Minimum width: 320 (will be scaled up to the minimum if necessary)
Maximum width: 1440 (will be scaled down to the maximum if necessary)
Height: Varies, depending on width and aspect ratio
Color Space: sRGB. Images using other color spaces will have their color spaces converted to sRGB.
Przewodnik Content Publishing powtarza zasadę formatu dosadniej w swojej sekcji Limitations: "JPEG is the only image format supported. Extended JPEG formats such as MPO and JPS are not supported."
Po ponownym przeczytaniu bloku widać podział. Część zasad odrzuca żądanie, a część po cichu zmienia twój plik. Format, rozmiar pliku i proporcje to kontrole, a niepowodzenie wraca jako HTTP 400 z kodem i podkodem. Szerokość i przestrzeń barw to konwersje, co Meta zaznacza w nawiasach: skalowanie w górę, skalowanie w dół, konwersja do sRGB. Nic nie informuje, że do nich doszło.
To rozróżnienie decyduje o sposobie walidacji przed wywołaniem API. Pierwszą grupę wychwycisz, czytając błąd. Drugą tylko wtedy, gdy sam zmierzysz plik.
- Format inny niż JPEG
- Rozmiar pliku ponad limit
- Proporcje poza zakresem od 4:5 do 1.91:1
- Szerokość skalowana do zakresu od 320 do 1440
- Przestrzeń barw konwertowana do sRGB
Jaki kod błędu zwraca każde naruszenie?
Każdy udokumentowany przez Meta problem z obrazem wraca jako status HTTP 400 z obiektem JSON error zawierającym code, error_subcode, error_user_title i error_user_msg. Dokumentacja kodów błędów Instagrama przypisuje je jeden do jednego.
| Naruszenie | Kod | Podkod | Komunikat dla użytkownika publikowany przez Meta |
|---|---|---|---|
| Plik większy niż limit | 36000 | 2207004 | The image is too large to download. It should be less than {size}. |
| Format inny niż JPEG | 36001 | 2207005 | The image format {current-image-format} is not supported. Supported formats are: {format}. |
| Proporcje poza zakresem 4:5 do 1.91:1 | 36003 | 2207009 | The submitted image with aspect ratio {submitted-ratio} cannot be published. Please submit an image with a valid aspect ratio. |
| Podpis ponad limit | 36004 | 2207010 | The submitted image's caption was {submitted-caption-length} characters long... |
| Adres URL obrazu niedostępny | 9004 | 2207052 | The media could not be fetched from this uri: {uri} |
| Zbyt długie pobieranie | -2 | 2207003 | It takes too long to download the media. |
| Szerokość poza zakresem | nie opublikowano | nie opublikowano | nie opublikowano |
| Przestrzeń barw inna niż sRGB | nie opublikowano | nie opublikowano | nie opublikowano |
Przykładowy błąd, który Meta umieszcza na początku tej dokumentacji, dotyczy rozmiaru pliku. Warto go przytoczyć dosłownie, bo jego treść różni się od specyfikacji:
{
"error": {
"message": "The image size is too large.",
"type": "OAuthException",
"code": 36000,
"error_subcode": 2207004,
"is_transient": false,
"error_user_title": "Image size too large",
"error_user_msg": "The image is too large to download. It should be less than 8 MiB.",
"fbtrace_id": "A6LJylpZRKw2xKLFsAP-cJh"
}
}Jeden wiersz tej tabeli zawiera błąd w samej dokumentacji Meta. Kolumna Recommended Solution dla 36001, podkod 2207005, czyli odrzucenia formatu, brzmi: "Possible permission error due to missing permission or expired token. Generate a new container and use it to try again." To tekst rozwiązania dla kodu 24, podkod 2207006, zupełnie innego problemu, wklejony do wiersza o formacie. Plik PNG nie stanie się JPEG-iem po odświeżeniu tokena. W tym wierszu zignoruj kolumnę rozwiązania i czytaj komunikat dla użytkownika.
Limit to 8 MB czy 8 MiB?
Meta podaje obie wartości na dwóch aktualnych stronach. Dokumentacja mediów mówi "File size: 8 MB maximum." Dokumentacja kodów błędów mówi w przykładowej odpowiedzi, że obraz "should be less than 8 MiB", a kolumna Recommended Solution w tym samym wierszu podaje "Image exceeded maximum file size of 8MiB."
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
To nie jest ten sam limit. 8 MB to 8 000 000 bajtów. 8 MiB to 8 388 608 bajtów. Różnica wynosi 388 608 bajtów, czyli pas szerokości około jednej trzeciej megabajta, w którym specyfikacja mówi nie, a treść błędu tak.
Projektuj pod 8 000 000 bajtów. Niższy z dwóch opublikowanych limitów to ten, który cię nie zaskoczy, a utracony zapas jest niewielki w porównaniu z publikacją, która pada na etapie kontenera. Jeśli kompresujesz pliki przed wysłaniem, celuj wyraźnie niżej: JPEG o rozmiarze 6 MB przetrwa ponowne kodowanie po stronie Meta, nie zbliżając się do żadnej z tych wartości. Ten sam nawyk obronny dotyczy limitu 2 200 znaków podpisu i zasady 20 oznaczeń @, gdzie pole jest sprawdzane przy tworzeniu kontenera, a nie przy publikacji.

Co się dzieje, gdy obraz jest zbyt szeroki lub zbyt wąski?
Nic, co dałoby się wychwycić w odpowiedzi. Meta przeskalowuje plik i kontynuuje.
Minimalna szerokość to 320 pikseli, a maksymalna 1440, i obie linie kończą się tą samą obietnicą: obraz "will be scaled up to the minimum if necessary" oraz "will be scaled down to the maximum if necessary". Dla żadnego z tych kierunków nie ma kodu błędu. Zdjęcie o szerokości 4000 pikseli zostanie przyjęte, zmniejszone do 1440 i opublikowane w rozdzielczości, której nie wybrano. Miniatura o szerokości 200 pikseli zostanie przyjęta, rozciągnięta do 320 i opublikowana jako nieostra.
Wysokość nie jest w specyfikacji stałą liczbą. Meta pisze "Height: Varies, depending on width and aspect ratio", co oznacza, że wysokość wynika z dwóch egzekwowanych zasad, a nie jest osobną regułą. Przy szerokości 1440 i proporcjach 4:5 wysokość wynosi 1800 pikseli, co jest najwyższym kadrem akceptowanym przez punkt końcowy dla feedu.
Przestrzeń barw zachowuje się tak samo. Wszystko, co nie jest w sRGB, zostaje skonwertowane bez ostrzeżenia i bez błędu. Eksport w Display P3 z telefonu lub edytora zdjęć opublikuje się poprawnie, ale będzie bardziej matowy niż na twoim ekranie. Skonwertuj plik do sRGB przed przesłaniem, aby mieć tę konwersję pod kontrolą. Ta sama zasada stoi za wymiarami w pikselach, które sprawdzają się w różnych miejscach Instagrama: wybierz rozmiar, którego Meta nie ruszy.
Czym zasady API różnią się od tego, co przyjmuje aplikacja Instagram?
Dla aplikacji Meta podaje inny zestaw liczb na innej stronie. Artykuł Centrum pomocy Instagrama "Image resolution of photos you share on Instagram" zaleca: "Upload a photo with a width of at least 1080 pixels with an aspect ratio between 1.91:1 and 3:4."
Zestawmy to obok siebie.
| Zasada | Instagram Graph API | Aplikacja Instagram według Centrum pomocy |
|---|---|---|
| Najwęższe proporcje | 4:5 | 3:4 |
| Najszersze proporcje | 1.91:1 | 1.91:1 |
| Minimalna szerokość | 320 | 320, zalecane 1080 |
| Maksymalna szerokość | 1440 | 1080, szersze obrazy są zmniejszane |
| Format | Tylko JPEG | nie opublikowano |
| Rozmiar pliku | 8 MB | nie opublikowano |
Problemy sprawia pionowa granica. 4:5 to 0,8, a 3:4 to 0,75. Pionowy kadr 3:4, który aplikacja przyjmuje bez zastrzeżeń, w API zwraca kod 36003, podkod 2207009, bo wypada poza udokumentowany zakres. Każdy, kto przenosi proces z telefonu do API, trafia na to w pierwszej kolejności.
Zasady szerokości kończą się w różnych miejscach. Oba dokumenty zaczynają od 320, a Centrum pomocy podaje, że węższe zdjęcie jest powiększane do 320. Wyżej ścieżki się rozchodzą: API zmniejsza wszystko powyżej 1440 do 1440, a aplikacja wszystko powyżej 1080 do 1080. Eksportuj w szerokości 1080 pikseli, a żaden z dokumentów nie da powodu do zmiany pliku. AdaptlyPost publikuje na Instagramie przez to API, więc ten sam limit dotyczy wszystkiego, co jest zaplanowane, a nie dodane ręcznie.
Dwóch kolejnych funkcji aplikacji celowo nie ma w API. Przewodnik Content Publishing mówi wprost: "Shopping tags are not supported" oraz "Filters are not supported." Żadna z nich nie zwraca pomocnego błędu, bo takie parametry nie istnieją.

Które zasady zmieniają się dla relacji, okładek Reels i karuzel?
Limit 8 MB i zasada JPEG obowiązują wszędzie. Zasada proporcji już nie.
| Miejsce | Format | Rozmiar | Proporcje |
|---|---|---|---|
| Obraz w feedzie | JPEG | 8 MB | Muszą mieścić się w zakresie od 4:5 do 1.91:1 |
| Obraz w relacji | JPEG | 8 MB | Zalecane 9:16, brak opublikowanego zakresu |
| Okładka Reels | JPEG | 8 MB | Zalecane 9:16, przy innych proporcjach kadrowanie |
| Element karuzeli | JPEG | 8 MB | Kadrowanie do pierwszego obrazu |
Relacje całkowicie rezygnują z egzekwowanego zakresu. Meta pisze tylko, że "recommended 9:16 to avoid cropping or blank space", co oznacza, że kwadratowy obraz opublikuje się jako relacja z pasami, a nie z błędem.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Okładki Reels są kadrowane dwukrotnie. Meta podaje, że jeśli okładka nie ma proporcji 9:16, "we crop the image and use the middle most 9:16 rectangle as the cover photo for the reel", a udostępnienie rolki w feedzie powoduje drugie kadrowanie: "the middle most 1:1 square". Wszystko, co ważne i blisko krawędzi, znika, zanim trafi do siatki.
Karuzele ignorują proporcje wszystkich slajdów poza pierwszym. Przewodnik mówi jasno: "Carousel images are all cropped based on the first image in the carousel, with the default being a 1:1 aspect ratio." Świadomie układaj kolejność elementów, bo pierwszy slajd wyznacza kadr dla wszystkich dziesięciu. To ograniczenie działa obok liczby kontenerów i limitu publikacji dla karuzel, gdzie karuzela z dziesięcioma obrazami nadal zużywa jedną publikację. A jeśli w tym samym żądaniu ustawiasz tekst alternatywny, pole alt_text ma własny, osobny limit, niezwiązany z samym obrazem.
Najczęściej zadawane pytania
Czy API Instagrama przyjmuje obrazy PNG?
Nie. Meta pisze w przewodniku Content Publishing: "JPEG is the only image format supported". Plik PNG zwraca kod 36001, podkod 2207005, z komunikatem "The image format {current-image-format} is not supported. Supported formats are: {format}."
Jaki jest maksymalny rozmiar pliku obrazu w API Instagrama?
Meta podaje dwie wartości. Dokumentacja mediów mówi "File size: 8 MB maximum." Dokumentacja kodów błędów podaje, że obraz "should be less than 8 MiB", czyli 8 388 608 bajtów. Projektuj pod mniejszą liczbę, 8 000 000 bajtów.
Jakie proporcje odrzuca API Instagrama?
Wszystko poza zakresem od 4:5 do 1.91:1. Odrzucane są więc 3:4, 9:16 i 2:1 dla obrazów w feedzie, co zwraca kod 36003, podkod 2207009.
Czy obraz o szerokości 4000 pikseli powoduje błąd w API Instagrama?
Nie. Meta zmniejsza go do maksymalnych 1440 pikseli i publikuje. Dla szerokości spoza zakresu nie ma kodu błędu w żadnym kierunku.
Czy pliki MPO i JPS są akceptowane jako JPEG?
Nie. Przewodnik Content Publishing wymienia je wprost: "Extended JPEG formats such as MPO and JPS are not supported."
Czy obrazy w relacjach i karuzelach podlegają tej samej zasadzie proporcji co posty w feedzie?
Nie. Relacje nie mają opublikowanego egzekwowanego zakresu, tylko zalecenie 9:16. Slajdy karuzeli są kadrowane do pierwszego obrazu, a domyślne proporcje to 1:1.
Z jaką wysokością publikowany jest obraz przez API Instagrama?
Meta nie podaje w specyfikacji stałej wysokości, pisze tylko "Height: Varies, depending on width and aspect ratio." Wysokość wynika z dwóch faktycznie egzekwowanych zasad, szerokości i proporcji, a nie jest osobną regułą. Przy maksymalnej szerokości 1440 pikseli i proporcjach 4:5 obraz publikuje się z wysokością 1800 pikseli, najwyższą akceptowaną przez punkt końcowy dla feedu.
Czy można ufać kolumnie Recommended Solution w dokumentacji kodów błędów Meta?
Nie w każdym wierszu. Tekst obok kodu 36001, czyli odrzucenia formatu, opisuje kod 24, błąd uprawnień, i każe utworzyć nowy kontener i spróbować ponownie. Plik PNG nie zmieni się w JPEG po odświeżeniu tokena, więc w tym wierszu czytaj pole error_user_msg zamiast kolumny rozwiązania.
Czy okładka Reels może być kadrowana więcej niż raz?
Może być kadrowana dwukrotnie. Meta przycina każdą okładkę o proporcjach innych niż 9:16 do środkowego prostokąta 9:16, a jeśli rolka jest też udostępniana w feedzie, kadruje ją ponownie do środkowego kwadratu 1:1. Wszystko umieszczone blisko krawędzi oryginalnego kadru znika, zanim trafi do siatki.
Czy aplikacja Instagram egzekwuje limit rozmiaru pliku tak jak API?
Artykuł Centrum pomocy o rozdzielczości zdjęć w ogóle nie podaje rozmiaru pliku. Dokumentuje go tylko Graph API, jako 8 MB w specyfikacji i 8 MiB w treści błędu, więc limit rozmiaru pliku to zasada wyłącznie dla API, bez opublikowanego odpowiednika w aplikacji.
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


Limit zapytań API Instagrama to 4800 razy liczba wyświetleń
Meta ustala limit zapytań API Instagrama na 4800 wywołań na wyświetlenie w kroczącym okresie 24 godzin i raportuje użycie w X-Business-Use-Case-Usage.


Co naprawdę daje zakres instagram_business_content_publish
Zakres instagram_business_content_publish pozwala aplikacji tworzyć organiczne posty na Instagramie i przy każdym wywołaniu zależy od instagram_business_basic.


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.
Powiązane artykuły


Dlaczego dzienny limit postów na Instagramie to w dokumentacji Mety 100 i 50
Instagram nie podaje dziennego limitu postów dla aplikacji. Dokumentacja API Mety mówi raz o 100 postach na 24 godziny, a dwa razy o 50. Sprawdź, co obowiązuje.


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.


Co liczą interakcje z treściami na Instagramie, a co odejmują
Interakcje z treściami na Instagramie w praktyce: metryka Interakcje, pole API total_interactions, powody spadku liczby i to, kiedy wliczane są reklamy.

