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

Публикация каруселей в Instagram через API

Согласно руководству Meta по публикации, API Instagram публикует карусель как один пост до 20 фото и видео, хотя справочник ошибок всё ещё указывает 10. Каждый элемент получает собственный контейнер с is_carousel_item, равным true, затем контейнер CAROUSEL перечисляет их в поле children и содержит подпись. Публикация этого контейнера размещает все элементы вместе и засчитывается как один из 100 постов, опубликованных через API за 24 часа.

easyCoexistence публикует карусели из фото и видео от 2 до 10 через publish_instagram_post из Claude, ChatGPT или вашего кода: один вызов с элементами и подписью публикует пост, а пока видео обрабатывается, публикация завершается самостоятельно.

Up to 20

Количество фото и видео, которое может содержать карусель, по руководству Meta по публикации и параметру children.

2207028

Подкод в рамках кода 100, сообщение которого всё ещё говорит, что карусели нужны от 2 до 10 элементов.

1 post

Сколько карусель засчитывается против лимита 100 постов, опубликованных через API за 24 часа.

1:1

Обрезка по умолчанию для изображений карусели: все они следуют соотношению сторон первого изображения.

0

Показатели Insights, которые Meta возвращает для отдельных фото и видео внутри карусели.

Как публикуется карусель?

В три этапа, всё через POST /<IG_ID>/media и один вызов публикации.

  • Элементы: создайте контейнер для каждого фото (image_url) или видео (media_type VIDEO и video_url), с is_carousel_item, равным true, и без подписи.
  • Карусель: создайте контейнер с media_type CAROUSEL, полем children со списком ID контейнеров элементов через запятую и подписью.
  • Публикация: POST /<IG_ID>/media_publish с creation_id, равным ID контейнера карусели.

Сколько элементов может содержать карусель?

До 20. Руководство Meta по публикации и параметр children в POST /<IG_ID>/media задают предел в 20 изображений, видео или их сочетание. Справочник ошибок ещё говорит по-старому: сообщение для кода 100, подкода 2207028, гласит, что карусели нужно как минимум 2 и не более 10 элементов, поэтому количество от 2 до 10 принимается всей документацией Meta. Элементами могут быть фото или видео, но не Reels: элемент карусели всегда является контейнером с изображением или видео.

Как обрезаются изображения карусели?

По первому. Каждое изображение в карусели обрезается под соотношение сторон первого изображения, по умолчанию это квадрат 1:1. Каждое изображение всё равно должно соответствовать обычным требованиям: JPEG, до 8 МБ, соотношение сторон от 4:5 до 1,91:1. Поставьте первым изображение нужной формы или сделайте все изображения одной формы перед публикацией.

Что относится к карусели, а что к каждому элементу?

Большинство настроек поста хранятся в контейнере карусели, а не в элементах.

  • Подпись: только в контейнере карусели; элементы её не принимают.
  • Местоположение: только в контейнере карусели.
  • Метка ИИ-генерации: is_ai_generated задаётся в контейнере карусели, а если задать его в элементе, возвращается ошибка.
  • Альтернативный текст: поддерживается для элементов-изображений, до 1 000 символов у каждого.

Как читается карусель?

Как один медиа-объект с media_type CAROUSEL_ALBUM. GET /<IG_MEDIA_ID>/children перечисляет фото и видео внутри него, хотя некоторые поля, например permalink, для дочерних элементов не работают. Счётчики комментариев и лайков карусели не включают её элементы, а Meta не возвращает показатели для отдельных элементов, только для поста-карусели.

Как карусель засчитывается в лимитах?

Как один пост. Аккаунт может опубликовать 100 постов через API за скользящие 24 часа, и карусель занимает одно место независимо от числа элементов. Но каждый элемент всё равно является контейнером, а аккаунт может создать 400 контейнеров за скользящие 24 часа, поэтому серия каруселей по десять элементов достигнет этого потолка раньше лимита публикаций.

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

  • Подпись на элементе. Подписи не поддерживаются для элементов карусели; задайте её один раз в контейнере карусели.
  • Добавление Reel как элемента. Элементы карусели являются контейнерами с изображением или видео, и Reel не может попасть в карусель.
  • Смешивание вертикальных и горизонтальных фото без проверки первого. Каждое изображение получает соотношение сторон первого.
  • Ожидание показателей по каждому слайду. Meta не возвращает их для медиа внутри карусели, только для поста.
Настройка с EasyCoexistence

Карусели можно также планировать через собственную очередь. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, с бесплатным пробным периодом в 3 дня.

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

Можно ли запланировать карусель в Instagram через API?

Да, через очередь, поскольку Meta публикует карусель при публикации её контейнера. Метод publish_instagram_post в easyCoexistence принимает scheduled_at, от 1 минуты до 90 дней вперёд, для каруселей из 2 до 10 элементов.

Можно ли пометить карусель как созданную ИИ?

Да, через is_ai_generated в контейнере карусели. Если задать его в элементе, возвращается ошибка.

Может ли карусель содержать Reel?

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

Почему карусель выдаёт ошибку 2207028?

Сообщение Meta для неё гласит, что карусели нужно как минимум 2 и не более 10 элементов. Количество от 2 до 10 удовлетворяет и этому сообщению, и лимиту в 20 из руководства по публикации, поэтому скорректируйте элементы и создайте контейнер карусели заново.

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

Лимиты публикации в Instagram API: форматы, размеры и посты в деньЧто вмещает публикация через Instagram API и сколько их в сутки: JPEG до 8 МБ, Reels, Stories, подписи до 2 200 символов, 100 постов за 24 часа.Публикация Reels в Instagram через APIКак Instagram API публикует Reels: требования Meta к видео, контейнеры и время обработки, показ в Feed, обложки и метрики Reels.Публикация историй Instagram через APIКак API Instagram публикует истории: требования к изображению и видео, что может нести история, 24-часовой срок жизни, ответы в DM и метрики.Статистика Instagram через API: метрики аккаунта и постовМетрики, которые API Instagram возвращает для аккаунта и каждого поста, Reels и Stories, с порогами Meta, задержками и переименованными метриками.Ошибки Instagram API: что означают распространённые кодыЧастые ошибки Instagram API: истёкшие токены, лимиты частоты, медиа, которые Meta не может загрузить, дневной лимит публикаций, закрытые окна переписки.

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

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

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

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