Tekst alternatywny w postach na Instagramie przez API
API Instagrama dodaje tekst alternatywny do posta ze zdjęciem przez parametr alt_text, ustawiany przy tworzeniu kontenera multimediów. Przyjmuje do 1,000 znaków i działa przy pojedynczym zdjęciu lub przy każdym obrazie w karuzeli, natomiast Reels i relacje nie obsługują tego pola. Meta dodała to pole 24 marca 2025 roku.
easyCoexistence publikuje zdjęcia i karuzele narzędziem publish_instagram_post z poziomu Claude, ChatGPT lub własnego kodu.
Najwięcej znaków tekstu alternatywnego, jakie jeden obraz może mieć przez API.
Kiedy Meta wprowadziła pole alt_text dla postów ze zdjęciami w endpoincie media.
alt_text działa przy pojedynczych obrazach i obrazach w karuzeli; Reels i relacje nie są obsługiwane.
Pole opublikowanych multimediów zwracające opisowy tekst obrazu, dla dostępności.
Czym jest tekst alternatywny w poście na Instagramie?
Pisemny opis obrazu, który dokumentacja multimediów Meta nazywa opisowym tekstem obrazów, służącym dostępności. Przez API ustawia się go dla każdego obrazu parametrem alt_text przy tworzeniu kontenera, a odczytuje z pola alt_text po opublikowaniu posta.
Jak dodać tekst alternatywny?
Parametrem alt_text w kontenerze obrazu. POST /<IG_ID>/media z image_url, podpisem i alt_text tworzy kontener, a POST /<IG_ID>/media_publish publikuje go jak zwykle. W przypadku karuzeli ustaw alt_text w kontenerze każdego elementu obrazu, czyli tych utworzonych z is_carousel_item ustawionym na true, zanim utworzysz kontener karuzeli.
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json
{
"image_url": "https://example.com/photo.jpg",
"caption": "<CAPTION>",
"alt_text": "<WHAT_THE_IMAGE_SHOWS>"
}Które posty obsługują tekst alternatywny?
Wyłącznie posty ze zdjęciami, zgodnie z opisem parametru w dokumentacji Meta:
- Pojedynczy post ze zdjęciem: obsługiwany, do 1,000 znaków.
- Zdjęcia w karuzeli: obsługiwane, każde z własnym tekstem.
- Filmy, także elementy wideo w karuzeli: nieobsługiwane.
- Reels i relacje: nieobsługiwane.
- Sam kontener karuzeli: tekst trafia zamiast tego do jej elementów obrazowych.
Jak odczytać tekst alternatywny?
Poproś o pole alt_text opublikowanego obrazu: GET /<IG_MEDIA_ID>?fields=alt_text. To publiczne pole obiektu multimediów, więc można je pobrać także dla obrazów karuzeli przez krawędź children, która wylicza zdjęcia i filmy wewnątrz posta.
Czy tekst alternatywny można zmienić po publikacji?
Meta nie udokumentowała takiej możliwości. Jedyna aktualizacja opublikowanego posta, jaką wymienia jej dokumentacja multimediów, włącza lub wyłącza komentarze, więc tekst alternatywny zapisuje się w kontenerze przed publikacją, razem z podpisem i adresem URL obrazu.
Typowe błędy
- Wysyłanie alt_text z Reelem lub relacją. Meta obsługuje to pole wyłącznie w postach ze zdjęciami.
- Umieszczanie go w kontenerze karuzeli. Tekst alternatywny należy do każdego elementu obrazowego w karuzeli.
- Przekroczenie 1,000 znaków. Tyle maksymalnie może mieć tekst alternatywny jednego obrazu.
Narzędzie nie przyjmuje alt_text, więc opis dodaje się w aplikacji Instagram, z opcji edycji posta. US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami w bezpłatnym okresie próbnym.
Najczęściej zadawane pytania
Jak długi może być tekst alternatywny w API Instagrama?
Do 1,000 znaków na obraz, ustawianych parametrem alt_text w kontenerze każdego obrazu, więc każdy obraz w karuzeli ma własny tekst.
Czy Reel może mieć tekst alternatywny przez API?
Nie. Meta nie obsługuje alt_text w Reels ani w relacjach.
Jak dodać tekst alternatywny do karuzeli?
Ustaw alt_text w kontenerze każdego elementu obrazowego, utworzonego z is_carousel_item ustawionym na true, zanim utworzysz kontener karuzeli.
Kiedy API Instagrama dodało tekst alternatywny?
Meta wprowadziła pole alt_text dla postów ze zdjęciami 24 marca 2025 roku.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w