Słownik

Meta ustala limit znaków alt_text w API Instagrama na 1 000

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •6 min czytania
Meta ustala limit znaków alt_text w API Instagrama na 1 000Meta ustala limit znaków alt_text w API Instagrama na 1 000

TL;DR, szybka odpowiedź

6 min czytania

Parametr alt_text w punkcie końcowym publikowania treści na Instagramie przyjmuje do 1 000 znaków, a dokumentacja Meta ogranicza go do pojedynczego obrazu lub obrazu w karuzeli. Reels i relacje są wprost wymienione jako nieobsługiwane, a żaden kontener wideo nie jest podany jako przyjmujący to pole. Dokumentacja dla deweloperów nie podaje limitu znaków dla pola tekstu alternatywnego w aplikacji Instagram, więc 1 000 to jedyna liczba, którą można poprzeć źródłem.

Jaki jest limit znaków alt_text w API Instagrama?

Dokumentacja Meta ustala limit znaków alt_text w API Instagrama na 1 000 i ogranicza to pole do obrazów statycznych. Opis parametru w punkcie końcowym tworzenia mediów brzmi dosłownie: "Alternative text, up to 1000 character, for an image. Only supported on a single image or image media in a carousel. Reels and stories are not supported."

Jeden opis, trzy osobne zasady. Limit wynosi 1 000. Pole należy do obrazu, samodzielnego lub umieszczonego w karuzeli. Reels i relacje są wykluczone z nazwy. Wszystko inne, co ludzie sądzą o tekście alternatywnym na Instagramie, pochodzi spoza tego opisu.

Pole znajduje się w wywołaniu tworzącym kontener:

POST https://graph.facebook.com/v25.0/<IG_ID>/media
  ?image_url=https://example.com/photo.jpg
  &alt_text=A%20hand-drawn%20site%20plan%20pinned%20to%20a%20studio%20wall
  &caption=Week%20four
  &access_token=<TOKEN>

alt_text przekazujesz przy tworzeniu kontenera, a nie przy publikacji. Krok publikacji, POST /<IG_ID>/media_publish, przyjmuje creation_id i nic więcej, co dotyczyłoby dostępności. Jeśli pominiesz to pole w kontenerze, w tym samym procesie nie będzie drugiej szansy.

Meta podaje dokładną datę wprowadzenia funkcji. Przewodnik po publikowaniu treści mówi: "On March 24, 2025, we introduced the new alt_text field for image posts on the /<INSTAGRAM_PROFESSIONAL_ACCOUNT_ID>/media endpoint. Reels and stories are not supported." Wszystko, co napisano o API publikacji Instagrama przed tą datą, opisuje świat bez programowego tekstu alternatywnego.

Przed 24 marca 2025 i po tej dacie
Przed
  • Brak pola alt_text w API publikacji
  • Brak programowego sposobu na dodanie opisu obrazu
Po
  • Pole alt_text dostępne w punkcie końcowym media
  • Do 1 000 znaków, tylko obrazy
Przewodnik Meta po publikowaniu treści datuje wprowadzenie pola alt_text na 24 marca 2025 roku.

Które typy mediów na Instagramie przyjmują alt_text?

Tylko obrazy. Oto pełne zestawienie, oparte na opisie parametru i liście typów mediów z tej samej strony dokumentacji.

Konteneralt_text przyjmowanyCo mówi dokumentacja
Pojedynczy obraz (bez media_type)Tak"Only supported on a single image"
Obraz w karuzeli (is_carousel_item=true)Tak"or image media in a carousel"
Kontener karuzeli (media_type=CAROUSEL)NiePole opisuje obraz, a kontener zawiera elementy podrzędne, a nie piksele
media_type=REELSNie"Reels and stories are not supported"
media_type=STORIESNie"Reels and stories are not supported"
WideoNiewymienioneParametr dotyczy "for an image"; żaden kontener wideo nie jest opisany jako przyjmujący to pole

Ostatni wiersz przeczytaj uważnie, bo to on bywa błędnie cytowany. Meta nie pisze "video is not supported". Pisze, że parametr to tekst alternatywny "for an image", a jako wyjątki wymienia Reels i relacje. Ten punkt końcowy publikuje samodzielne wideo jako REELS, co zdanie wyklucza wprost. Praktyczny efekt jest zgodny z powtarzanym skrótem, ale dokumentacja dochodzi do niego przez zakres parametru, a nie przez zakaz, i strona ze specyfikacją powinna to rozróżniać.

Dlaczego liczba w aplikacji różni się od liczby w API?

Dokumentacja Meta dla deweloperów podaje dokładnie jeden limit tekstu alternatywnego: 1 000 znaków dla parametru alt_text. Nie podaje żadnego limitu dla pola tekstu alternatywnego w aplikacji Instagram.

Właśnie tę lukę warto nazwać. Poradniki o dostępności i blogi o mediach społecznościowych powtarzają znacznie krótszą wartość dla aplikacji, cytowaną bez odnośnika do Meta. Nie występuje ona nigdzie w dokumentacji dla deweloperów ani w dzienniku zmian, który nie ma żadnego wpisu o alt_text. Dlatego ta strona jej nie powtarza. Jeśli chcesz wiedzieć, ile znaków zmieści edytor w aplikacji, odpowiedź dostępna od Meta jest taka, że Meta tego nie podaje.

Dostajesz za to konkretną liczbę dla jedynej powierzchni, która się dokumentuje. Jeśli tekst alternatywny przechodzi przez API, masz do dyspozycji 1 000 znaków, i to jedyny budżet, do którego Meta zobowiązuje się na piśmie. Ograniczenie, pod które ludzie planują, okazuje się nie tym, które faktycznie istnieje.

Jak limit alt_text wypada na tle limitu podpisu?

Ta sama strona dokumentacji opisuje oba, więc porównanie jest uczciwe.

PoleLimitDodatkowe zasady
alt_text1 000 znakówTylko obrazy. Bez Reels, bez relacji
caption2 200 znakówMaksymalnie 30 hashtagów i 20 oznaczeń @

Opis podpisu w dokumentacji Meta jasno określa liczbę oznaczeń: "Maximum 2200 characters, 30 hashtags, and 20 @ tags." Opis alt_text nie zawiera podobnych zasad szczegółowych. Nie ma udokumentowanego limitu hashtagów, wzmianek ani obsługi znaczników. To zwykłe pole tekstowe z limitem.

Ta asymetria ma znaczenie przy budowie edytora. Walidator podpisu potrzebuje trzech liczników. Walidator tekstu alternatywnego potrzebuje jednego oraz sprawdzenia, jaki typ mediów wybrał użytkownik.

Osoba przesuwa karuzelę zdjęć na telefonie, co pokazuje, że tekst alternatywny dotyczy każdego slajdu osobno.

Gdzie umieścić alt_text w poście z karuzelą?

W każdym kontenerze podrzędnym, po kolei. Karuzelę buduje się w dwóch etapach. Najpierw kontener dla każdego elementu z is_carousel_item=true, potem kontener nadrzędny z media_type=CAROUSEL i tablicą children z tymi identyfikatorami. Uwaga Meta przy is_carousel_item brzmi: "Applies only to images and video. Set to true. Indicates image or video appears in a carousel."

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Tekst alternatywny dodaje się na poziomie elementu podrzędnego, co wynika z opisu parametru obejmującego "image media in a carousel". Dziesięć slajdów to dziesięć osobnych wartości alt_text, napisanych dla dziesięciu osobnych obrazów. Nie ma pola na poziomie kontenera nadrzędnego opisującego całość ani sposobu na jeden tekst dla całej karuzeli. Zespoły przygotowujące karuzele hurtowo w narzędziu do planowania na Instagramie od razu to odczuwają. Praca nad tekstem alternatywnym rośnie z liczbą slajdów, a nie postów.

Elementy wideo w karuzeli mają ten sam problem z zakresem co samodzielne wideo. Kontener podrzędny przyjmuje is_carousel_item, ale alt_text jest udokumentowany dla obrazów.

Co dzieje się z tekstem alternatywnym w Reels i relacjach?

Nic, bo tam tego pola nie ma. Wysyłając alt_text w kontenerze REELS lub STORIES, przekazujesz parametr, którego punkt końcowy nie dokumentuje. Nie ma częściowej obsługi, przycinania ani przeniesienia do podpisu.

To realna luka dla wszystkich, którzy publikują dużo wideo przez API do publikowania na Instagramie. Opis dostępnościowy musi znaleźć się gdzie indziej, czyli w praktyce w podpisie, w tekście na ekranie albo w napisach wtopionych w wideo. To decyzje redakcyjne, a nie pola API, i ich miejsce jest w kalendarzu treści, z którego korzysta twój zespół.

Osoba niedowidząca trzyma smartfon blisko ucha i słucha czytnika ekranu, czyli odbiorca, dla którego powstaje tekst alternatywny.

Jak w praktyce wykorzystać 1 000 znaków?

Większość tekstów alternatywnych ich nie potrzebuje, a długość nie jest celem. Znajomość prawdziwego limitu usuwa jednak błędny powód do skracania. Gdy zdjęcie zawiera wykres, menu, cennik, harmonogram lub gęsty tekst, nie musisz już wybierać między opisem a streszczeniem. Masz miejsce na jedno i drugie.

Przy gęstym obrazie zacznij od tematu i tego, co się dzieje, potem opisz otoczenie, a tekst widoczny w kadrze przepisz, zamiast go parafrazować. Pomiń "obraz przedstawiający" i "zdjęcie przedstawiające", bo technologie asystujące same informują o elemencie. Głos marki zostaw w podpisie, w czym pomaga generator podpisów AI, a w tekście alternatywnym opisuj to, co widać.

Jedyna liczba, pod którą warto projektować, to 1 000 na kontener, tylko dla obrazów. Cała reszta to albo ocena redakcyjna, albo nieudokumentowane zachowanie aplikacji, do którego Meta nie zobowiązała się na piśmie.

Najczęściej zadawane pytania

Jaka jest maksymalna długość alt_text w API Instagrama?

1 000 znaków. Dokumentacja Meta punktu końcowego tworzenia mediów opisuje parametr jako "Alternative text, up to 1000 character, for an image", i to jedyny limit tekstu alternatywnego opublikowany w dokumentacji dla deweloperów.

Czy API Instagrama obsługuje alt_text w Reels?

Nie. Dokumentacja Meta mówi wprost, że "Reels and stories are not supported" dla pola alt_text, zarówno w opisie parametru, jak i w informacji o wprowadzeniu funkcji w przewodniku po publikowaniu treści.

Czy można ustawić tekst alternatywny dla każdego slajdu karuzeli na Instagramie?

Tak, w każdym kontenerze podrzędnym. Opis parametru obejmuje "image media in a carousel", więc alt_text przekazujesz razem z is_carousel_item=true przy tworzeniu każdego obrazu, zanim złożysz nadrzędny kontener CAROUSEL.

Czy limit tekstu alternatywnego w aplikacji Instagram jest taki sam jak w API?

Dokumentacja Meta dla deweloperów nie podaje limitu znaków dla pola tekstu alternatywnego w aplikacji, więc nie da się porównać tych wartości na podstawie wiarygodnego źródła. Limit 1 000 znaków dotyczy parametru API alt_text.

Kiedy Instagram dodał alt_text do API publikacji?

24 marca 2025 roku. Przewodnik po publikowaniu treści podaje tę datę i ogranicza funkcję do postów z obrazami w punkcie końcowym /<INSTAGRAM_PROFESSIONAL_ACCOUNT_ID>/media.

Czy alt_text wlicza się do limitu podpisu na Instagramie?

Nie. To osobne parametry z osobnymi limitami w tym samym kontenerze: caption pozwala na 2 200 znaków, maksymalnie 30 hashtagów i 20 oznaczeń @, a alt_text na 1 000 znaków bez udokumentowanych zasad szczegółowych.

Czy można dodać alt_text do samodzielnego wideo przez API?

Wideo nie ma na liście kontenerów przyjmujących alt_text. Opis parametru ogranicza pole do "for an image", a ten punkt końcowy publikuje samodzielne wideo przez kontener REELS, jeden z dwóch typów wykluczonych w dokumentacji z nazwy.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Na którym etapie publikacji ustawia się alt_text?

Parametr alt_text przekazujesz przy tworzeniu kontenera w początkowym wywołaniu POST do /<IG_ID>/media, a nie na etapie publikacji. Wywołanie media_publish przyjmuje tylko creation_id, więc gdy kontener powstanie bez tego pola, nie ma drugiej szansy.

Co się stanie, jeśli mimo to wyślesz alt_text w kontenerze Reels lub Stories?

Nic użytecznego, bo punkt końcowy nie dokumentuje tego pola dla tych typów kontenerów. Dokumentacja Meta nie opisuje częściowej obsługi, przycinania ani przeniesienia tekstu do podpisu.

Czy pole alt_text ma zasady szczegółowe, tak jak pole podpisu?

Nie. Parametr podpisu ma obok limitu znaków udokumentowany limit 30 hashtagów i 20 oznaczeń @, a opis alt_text nie wymienia niczego takiego, tylko limit 1 000 znaków i ograniczenie do obrazów.

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