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

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

Instagram API публикует Reels из файла MOV или MP4 по публичному URL: создайте контейнер с media_type REELS, дождитесь, пока Meta обработает видео, и опубликуйте его. Длина Reels от 3 секунд до 15 минут, размер до 300 МБ. Meta рекомендует кадр 9:16, чтобы не было обрезки и пустых полей.

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

15 min

Самый длинный Reels, который публикует API; самый короткий длится 3 секунды.

300 MB

Максимальный размер файла Reels в форматах MOV или MP4 с видео H.264 или HEVC и аудио AAC.

1 min

Как часто Meta советует проверять статус обрабатываемого контейнера, но не дольше 5 минут.

24 hours

Сколько времени контейнер Reels может ждать неопубликованным, прежде чем истечёт.

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

В три шага. Сначала отправьте POST /<IG_ID>/media с media_type, равным REELS, video_url с адресом файла и, если нужна, подпись (caption). Meta загрузит видео и вернёт ID контейнера. Затем дождитесь, пока Instagram обработает видео, проверяя значение status_code контейнера. Наконец, отправьте POST /<IG_ID>/media_publish с creation_id, равным ID контейнера; в ответе будет ID медиа.

Meta описывает возобновляемую загрузку, которая может передать файл с компьютера, только для настроек, построенных на Facebook Login for Business, включая Unified Login. При Instagram Login видео всегда берётся по публичному URL.

Каковы требования к видео?

Требования Meta к Reels, которым файл должен соответствовать, прежде чем Instagram начнёт его обрабатывать:

  • Контейнер: MOV или MP4 (MPEG-4 Part 14), без edit lists, с moov atom в начале файла.
  • Видео: H.264 или HEVC, прогрессивная развёртка, closed GOP, субдискретизация цветности 4:2:0, от 23 до 60 кадров в секунду, ширина до 1920 пикселей и до 25 Мбит/с.
  • Аудио: AAC, до 48 кГц, моно или стерео, 128 кбит/с.
  • Соотношение сторон: от 0,01:1 до 10:1, рекомендуется 9:16.
  • Длина и размер: от 3 секунд до 15 минут, до 300 МБ.

Что происходит во время обработки видео?

Значение status_code контейнера остаётся IN_PROGRESS, пока Instagram обрабатывает видео, затем становится FINISHED, и только после этого его можно опубликовать. Публикация раньше завершается ошибкой с кодом 9007 и подкодом 2207027, что означает «подождите», а не «исправьте». Meta советует проверять статус раз в минуту, но не дольше 5 минут.

ERROR означает, что контейнер не смог завершить обработку, а EXPIRED означает, что он 24 часа простоял неопубликованным; в обоих случаях нужен новый контейнер. PUBLISHED означает, что публикация уже вышла.

Какие параметры Reels поддерживает API?

Помимо видео и подписи, контейнер Reels в API Meta принимает такие параметры:

  • share_to_feed: true показывает Reels и в Feed, и на вкладке Reels; false оставляет только вкладку Reels. Ни одно значение не гарантирует место на вкладке Reels.
  • cover_url: JPEG до 8 МБ, которое служит обложкой на вкладке Reels; обрезается по центру до 9:16, а при показе в Feed до квадрата.
  • thumb_offset: кадр в миллисекундах, который используется как миниатюра, если обложки нет; 0 означает первый кадр.
  • audio_name: название аудио Reels, которое можно задать только один раз.
  • trial_params: публикует пробный Reels, который показывается только тем, кто не подписан на аккаунт, до перевода в обычный показ.

Что ещё применяется к Reels?

Несколько правил действуют на Reels с момента создания контейнера.

  • Reels нельзя включить в карусель: он всегда публикуется отдельно.
  • Настройки приватности аккаунта действуют при публикации: если включено «Allow remixing», новый Reels тоже разрешает ремиксы.
  • Отметка музыки доступна только для оригинального аудио.
  • При последующем чтении Reels возвращается с media_type VIDEO, как и любое другое видео.
  • Такая публикация считается одной из 100 публикаций через API за 24 часа для аккаунта.

Какие метрики показывает Reels?

По Reels через эндпоинт медиа-инсайтов доступны: reach, views, likes, comments, saved, shares, total_interactions и reposts, а также три собственные метрики: ig_reels_avg_watch_time, ig_reels_video_view_total_time и reels_skip_rate, то есть долю просмотров, которые были пролистаны в первые 3 секунды. Likes, comments и views учитывают только органическую активность, а данные по ним могут отставать до 48 часов.

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

  • Публикация сразу после создания контейнера. Дождитесь, пока status_code станет FINISHED, иначе вызов завершится ошибкой с подкодом 2207027.
  • Отправка файла WebM или AVI. Reels принимаются только в MOV или MP4, иначе Meta отклоняет их с кодом 352 и подкодом 2207026.
  • Ожидание, что share_to_feed поместит Reels на вкладку Reels. Он только добавляет показ в Feed; вкладку Reels формирует Instagram.
  • Оставленный на ночь неопубликованный контейнер. Он истекает через 24 часа после создания, и для публикации понадобится новый.
Настройка с EasyCoexistence

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

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

Какой длины может быть Reels через API?

От 3 секунд до 15 минут, в виде файла MOV или MP4 размером до 300 МБ.

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

Не при Instagram Login. API берёт видео по публичному URL, поэтому сначала разместите файл там, где он получит публичную ссылку.

Появляется ли Reels, опубликованный через API, и в Feed?

Может. Параметр share_to_feed определяет, может ли Reels показываться и в Feed, и на вкладке Reels.

Почему публикация Reels завершается ошибкой 9007?

Instagram ещё обрабатывает видео. Проверьте status_code контейнера и опубликуйте, когда он станет FINISHED; в запросе ничего исправлять не нужно.

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

Лимиты публикации в Instagram API: форматы, размеры и посты в деньЧто вмещает публикация через Instagram API и сколько их в сутки: JPEG до 8 МБ, Reels, Stories, подписи до 2 200 символов, 100 постов за 24 часа.Публикация каруселей в Instagram через APIКак API Instagram публикует карусели до 20 фото и видео: контейнеры элементов, одна подпись, обрезка по первому изображению и лимиты.Публикация историй 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

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