ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Альтернативный текст в публикациях Instagram через API

API Instagram добавляет альтернативный текст к посту с изображением через параметр alt_text, который задаётся при создании контейнера медиа. Он принимает до 1 000 символов и работает для одного фото или для каждого изображения в карусели, а Reels и Stories его не поддерживают. Meta добавила это поле 24 марта 2025 г.

easyCoexistence публикует фото и карусели через publish_instagram_post из Claude, ChatGPT или вашего кода.

1,000

Наибольший объём альтернативного текста, который одно изображение может иметь через API.

24 Mar 2025

Когда Meta добавила поле alt_text для постов с изображениями в эндпоинте media.

Images only

alt_text работает для одиночных изображений и изображений карусели; Reels и Stories не поддерживаются.

alt_text

Поле опубликованного медиа, которое возвращает описательный текст изображения для доступности.

Что такое альтернативный текст в посте Instagram?

Письменное описание изображения, которое в справочнике медиа Meta называется описательным текстом для доступности. Через API его задают для каждого изображения параметром alt_text при создании контейнера, а читают из поля alt_text после публикации.

Как добавить альтернативный текст?

Параметром alt_text в контейнере изображения. POST /<IG_ID>/media с image_url, подписью и alt_text создаёт контейнер, а POST /<IG_ID>/media_publish публикует его как обычно. Для карусели задайте alt_text в контейнере каждого элемента изображения, созданного с is_carousel_item, равным true, до создания контейнера карусели.

An image container with alt text
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>"
}

Какие публикации поддерживают альтернативный текст?

Только посты с изображениями, как описывает параметр справочник Meta:

  • Одиночный пост с изображением: поддерживается, до 1 000 символов.
  • Изображения в карусели: поддерживаются, у каждого свой текст.
  • Видео, включая видеоэлементы в карусели: не поддерживаются.
  • Reels и Stories: не поддерживаются.
  • Сам контейнер карусели: текст добавляется к её элементам-изображениям.

Как прочитать альтернативный текст?

Запросите поле alt_text у опубликованного изображения: GET /<IG_MEDIA_ID>?fields=alt_text. Это публичное поле объекта медиа, поэтому его можно запросить и для изображений карусели через ребро children, которое перечисляет фото и видео внутри поста.

Можно ли изменить альтернативный текст после публикации?

Meta не описывает такой возможности. Единственное обновление, которое её справочник медиа перечисляет для опубликованного поста, включает или отключает комментарии, поэтому альтернативный текст записывается в контейнер до публикации вместе с подписью и URL изображения.

Распространённые ошибки

  • Отправка alt_text с Reel или Story. Meta поддерживает его только для постов с изображениями.
  • Размещение в контейнере карусели. Альтернативный текст относится к каждому элементу-изображению внутри карусели.
  • Превышение 1 000 символов. Это максимум, который может вместить альтернативный текст одного изображения.
Настройка с EasyCoexistence

Инструмент не принимает alt_text, поэтому описание добавляется в приложении Instagram, через пункт «Редактировать» у публикации. От US$ 9 до US$ 0,75 за подключение в месяц, тариф снижается по мере добавления подключений. Бесплатный пробный период: 3 дня.

Часто задаваемые вопросы

Насколько длинным может быть альтернативный текст через API Instagram?

До 1 000 символов на изображение, задаётся параметром alt_text в контейнере каждого изображения, поэтому каждое изображение карусели получает свой текст.

Может ли у Reel быть альтернативный текст через API?

Нет. Meta не поддерживает alt_text для Reels и Stories.

Как добавить альтернативный текст к карусели?

Задайте alt_text в контейнере каждого элемента-изображения, созданного с is_carousel_item, равным true, до создания контейнера карусели.

Когда API Instagram добавил альтернативный текст?

Meta добавила поле alt_text для постов с изображениями 24 марта 2025 г.

Читайте дальше

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на