# Posty na Instagram przez API: rozmiary, karuzele i publikacja

> Posty i karuzele na Instagram z szablonu, w rozmiarach, których Instagram nie przycina, jako pliki JPEG przyjmowane przez jego API do publikacji.

Opublikowano 2026-11-06 · https://shareglint.com/pl/use-cases/instagram-posts

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](https://shareglint.com/pl/use-cases/social-media-images).

## 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](https://help.instagram.com/1631821640426723/?locale=en_US)).

**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](https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/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:

| Preset | Rozmiar | Proporcje | Do czego |
|---|---|---|---|
| `portrait` | 1080×1350 | 4:5 | Pojedyncze posty — najwyższe, jakie przyjmuje API, zajmują najwięcej ekranu w aktualnościach |
| `square` | 1080×1080 | 1:1 | Karuzele, karty z cytatami |
| `og` | 1200×630 | 1,91:1 | Zdjęcia poziome, w aktualnościach rzadko używane |

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

```bash
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](https://developers.facebook.com/documentation/instagram-platform/content-publishing)). 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).

```bash
# 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](https://developers.facebook.com/documentation/instagram-platform/overview)).
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](https://shareglint.com/en/integrations/n8n) albo [Make](https://shareglint.com/en/integrations/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](https://shareglint.com/pl/pricing)).

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

## FAQ

### Jaki rozmiar powinno mieć zdjęcie w poście na Instagramie?

Instagram nie przycina zdjęcia, które ma od 320 do 1080 pikseli szerokości i proporcje od 1,91:1 do 3:4, czyli 1080 pikseli szerokości i od 566 do 1440 pikseli wysokości. Najczęściej wybiera się pion 4:5 (1080×1350) albo kwadrat 1:1 (1080×1080).

### Czy mogę publikować na Instagramie automatycznie przez API?

Content Publishing API Instagrama publikuje obrazki z publicznego adresu URL na kontach profesjonalnych (firmowych lub twórców). Przyjmuje tylko JPEG, proporcje od 4:5 do 1,91:1 i pliki do 8 MB. Wyrenderuj obrazek tutaj jako JPEG, a potem przekaż jego adres do API Instagrama.

### Dlaczego JPEG, a nie PNG?

Dokumentacja API Instagrama do publikacji podaje, że JPEG to jedyny obsługiwany format obrazów. PNG zadziała, gdy wgrywasz zdjęcie ręcznie w aplikacji, ale automatyczny post wymaga formatu jpeg.

### Czy mogę zrobić karuzelę na Instagram przez API?

Tak. Wyrenderuj okładkę, slajdy i slajd końcowy z szablonów karuzeli w jednym rozmiarze, a potem utwórz kontener karuzeli przez API Instagrama. Instagram pozwala na maksymalnie 20 elementów i przycina każdy z nich do proporcji pierwszego.
