Posty na Instagram przez API: rozmiary, karuzele i publikacja

Post na Instagramie z szablonu to karta z cytatem, ogłoszenie, opinia klienta, slajd karuzeli albo kolaż zdjęć — w układzie twojej marki i ze słowami z tego tygodnia. W Shareglint renderujesz go z danych — jedno zapytanie na post, jedno zlecenie hurtowe na cały miesiąc — jako JPEG, bo tylko ten format przyjmuje API Instagrama do publikacji. Ta strona opisuje rozmiary, karuzele i automatyczną publikację; pracę z wieloma sieciami naraz omawia strona o grafikach do social mediów.

Dwa zestawy liczb

Instagram ma dwa zestawy zasad i nie są one takie same.

W aplikacji — gdy ktoś wgrywa zdjęcie ręcznie — zdjęcie zachowuje swoją rozdzielczość, jeśli ma od 320 do 1080 pikseli szerokości, a jego proporcje mieszczą się między 1,91:1 a 3:4, czyli „a width of 1080 pixels with a height between 566 and 1440 pixels” (1080 pikseli szerokości i od 566 do 1440 pikseli wysokości). Inne proporcje są przycinane, mniejsze zdjęcia powiększane do 320 px szerokości, a większe zmniejszane do 1080 px (Pomoc Instagrama).

Przez Content Publishing API — gdy publikuje za ciebie narzędzie — obrazek musi być JPEG-iem, ważyć najwyżej 8 MB, mieć proporcje „within a 4:5 to 1.91:1 range” (od 4:5 do 1,91:1), szerokość od 320 do 1440 pikseli (inne są skalowane w górę albo w dół) i przestrzeń barw sRGB (Meta for Developers, IG User Media, stan na 6 listopada 2026). Najbardziej pionowe proporcje, jakie przyjmuje API, to 4:5, a nie 3:4 dopuszczane w aplikacji.

Dlatego wszystko, co może być publikowane automatycznie, trzymaj w zakresie od 4:5 do 1,91:1. Presety, które spełniają oba zestawy zasad:

Pliki wychodzą domyślnie w dwukrotności rozmiaru presetu (portrait to 2160×2700); API zmniejsza wszystko, co ma ponad 1440 px szerokości, a zdjęcie wgrane ręcznie jest skalowane do 1080 px. Dodaj "scale": 1, jeśli chcesz dostać plik o szerokości dokładnie 1080 px.

Jeden post

curl -X POST "https://shareglint.com/v1/images?wait=true" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "template": "testimonial-stars",
    "size": "portrait",
    "format": "jpeg",
    "modifications": {
      "quote": "Cotygodniowe raporty skróciliśmy z całego dnia do godziny.",
      "rating": "5",
      "name": "Anna Kowalczyk",
      "role": "Kierowniczka operacji",
      "company": "Northwind"
    }
  }'

format: jpeg to najważniejsza linijka: PNG wystarczy przy ręcznym wgrywaniu, ale API Instagrama go odrzuci — „JPEG is the only image format supported” (JPEG to jedyny obsługiwany format) (publikowanie treści na Instagramie). Domyślna jakość JPEG to 85; przy projektach z dużą ilością tekstu ustaw quality nawet na 100. Te same wartości zwracają ponownie ten sam plik za darmo.

Karuzele

Karuzela to okładka, slajdy i slajd końcowy. Wyrenderuj je z szablonów karuzeli, wszystkie w tym samym rozmiarze: Instagram przycina każdy element karuzeli „based on the first image in the carousel” (według pierwszego obrazka karuzeli), domyślnie do 1:1, i pozwala na maksymalnie 20 elementów w jednej karuzeli (dokumentacja publikowania treści na Instagramie, link wyżej).

# Okładka i slajd końcowy: po jednym zapytaniu. Slajdy: jedno zlecenie hurtowe.
curl -X POST "https://shareglint.com/v1/batches" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "template": "carousel-slide",
    "sizes": ["square"],
    "format": "jpeg",
    "rows": [
      { "id": "2", "index": "2", "total": "6", "heading": "Mierz jedną rzecz", "body": "Wybierz liczbę, którą zespół może ruszyć w tym miesiącu." },
      { "id": "3", "index": "3", "total": "6", "heading": "Zapisz to", "body": "Cel w wątku na czacie to tylko życzenie." }
    ]
  }'

GET /v1/batches/{id} zwraca adres każdego slajdu razem z jego id, więc łatwo ułożysz je w kolejności karuzeli. Limit wierszy na zlecenie według planu: Free 50, Starter 500, Pro 1 000, Scale 2 000, Business 5 000.

Automatyczna publikacja

Shareglint tworzy obrazek; publikuje go API Instagrama (albo twoje narzędzie do planowania postów, które korzysta z tego API). Tak wygląda przebieg opisany przez Meta:

1. Konto musi być kontem profesjonalnym na Instagramie — firmowym albo twórcy (przegląd Instagram Platform).
2. POST /<IG_ID>/media z image_url ustawionym na adres wyrenderowanego JPEG-a tworzy kontener. Meta sama pobiera plik, więc „must be on a public server” (musi leżeć na publicznym serwerze) — adres z renderu właśnie taki jest.
3. POST /<IG_ID>/media_publish z creation_id ustawionym na identyfikator kontenera publikuje post.
4. Przy karuzeli utwórz kontener dla każdego elementu z is_carousel_item=true, potem jeden kontener CAROUSEL z listą ich identyfikatorów i opublikuj właśnie ten kontener.

Limity, o których trzeba pamiętać: kontenery wygasają po 24 godzinach, a dzienna liczba postów publikowanych przez API jest ograniczona — strona o publikowaniu treści podaje w jednym miejscu 100 postów w ciągu kroczących 24 godzin, a w uwagach o karuzelach 50 (stan na 6 listopada 2026), więc zamiast polegać na którejkolwiek z tych liczb, sprawdzaj GET /<IG_ID>/content_publishing_limit.

Narzędzia no-code działają tak samo: w n8n albo Make krok HTTP renderuje JPEG, a drugi krok publikuje jego adres przez API Meta.

Uwagi do projektu

• Wielkość tekstu. W aktualnościach post widać w ułamku jego rozmiaru w pikselach, więc nagłówki pisz krótkie i duże. We wbudowanych szablonach długi tekst zmniejsza się, żeby zmieścić się w swoim polu.
• Marka. Pola accent i theme, które ma każdy szablon, utrzymują spójny wygląd postów przez cały miesiąc.

Koszt

Jeden render na obrazek; karuzela z sześciu slajdów to sześć renderów, a te same slajdy wyrenderowane ponownie są darmowe. 100 renderów miesięcznie w planie Free ma znak wodny. Starter kosztuje $9 miesięcznie za 2 000 renderów (cennik).

Czego nie robi

• Nie publikuje na Instagramie i nie przechowuje twojego tokenu Instagrama; robi to twój kod albo narzędzie do planowania, przez API Meta.
• Nie pisze opisów do postów ani hashtagów.
• Nie nakłada filtrów Instagrama, muzyki ani naklejek — istnieją one tylko w aplikacji.
• Nie opublikuje niczego na koncie osobistym: API Instagrama działa wyłącznie z kontami profesjonalnymi.