Słownik

Wymagania API Instagrama dla obrazów egzekwowane przez Meta przy przesyłaniu

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Wymagania API Instagrama dla obrazów egzekwowane przez Meta przy przesyłaniuWymagania API Instagrama dla obrazów egzekwowane przez Meta przy przesyłaniu

TL;DR, szybka odpowiedź

8 min czytania

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

Dwa rodzaje problemów z obrazem
Odrzucone i widoczne
  • Format inny niż JPEG
  • Rozmiar pliku ponad limit
  • Proporcje poza zakresem od 4:5 do 1.91:1
Zmienione po cichu
  • Szerokość skalowana do zakresu od 320 do 1440
  • Przestrzeń barw konwertowana do sRGB
Format, rozmiar pliku i proporcje wracają jako HTTP 400. Szerokość i przestrzeń barw po prostu zmieniają się po stronie Meta.

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.

NaruszenieKodPodkodKomunikat dla użytkownika publikowany przez Meta
Plik większy niż limit360002207004The image is too large to download. It should be less than {size}.
Format inny niż JPEG360012207005The image format {current-image-format} is not supported. Supported formats are: {format}.
Proporcje poza zakresem 4:5 do 1.91:1360032207009The submitted image with aspect ratio {submitted-ratio} cannot be published. Please submit an image with a valid aspect ratio.
Podpis ponad limit360042207010The submitted image's caption was {submitted-caption-length} characters long...
Adres URL obrazu niedostępny90042207052The media could not be fetched from this uri: {uri}
Zbyt długie pobieranie-22207003It takes too long to download the media.
Szerokość poza zakresemnie opublikowanonie opublikowanonie opublikowano
Przestrzeń barw inna niż sRGBnie opublikowanonie opublikowanonie 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
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.

Osoba przycina zdjęcie na ekranie laptopa, co pokazuje, jak szerokość i proporcje są dostosowywane przed publikacją.

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.

ZasadaInstagram Graph APIAplikacja Instagram według Centrum pomocy
Najwęższe proporcje4:53:4
Najszersze proporcje1.91:11.91:1
Minimalna szerokość320320, zalecane 1080
Maksymalna szerokość14401080, szersze obrazy są zmniejszane
FormatTylko JPEGnie opublikowano
Rozmiar pliku8 MBnie 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ą.

Osoba nagrywa pionowe wideo smartfonem na statywie, czyli format, wokół którego budowane są relacje i okładki Reels.

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.

MiejsceFormatRozmiarProporcje
Obraz w feedzieJPEG8 MBMuszą mieścić się w zakresie od 4:5 do 1.91:1
Obraz w relacjiJPEG8 MBZalecane 9:16, brak opublikowanego zakresu
Okładka ReelsJPEG8 MBZalecane 9:16, przy innych proporcjach kadrowanie
Element karuzeliJPEG8 MBKadrowanie 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
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.

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.

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

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

Powiązane artykuły