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

Установка обложки Reel через API Instagram

API Instagram задаёт обложку Reel одним из двух способов при создании контейнера: cover_url указывает на JPEG, который используется как обложка на вкладке Reels, а thumb_offset выбирает кадр видео в миллисекундах от начала. Если не задан ни один, используется первый кадр, а при передаче обоих побеждает cover_url.

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

8 MB

Самое крупное изображение обложки Reels; это должен быть JPEG, другие цветовые пространства конвертируются в sRGB.

9:16

Формат обложки, который рекомендует Meta; другие форматы обрезаются по средней области 9:16.

1:1

Средний квадрат, который Meta вырезает из обложки при публикации Reel в ленте.

0 ms

Значение thumb_offset по умолчанию, при котором миниатюрой становится первый кадр видео.

2207057

Код подошибки для thumb_offset меньше 0 или не меньше длительности видео.

Как задать обложку Reel?

На контейнере Reel. POST /<IG_ID>/media с media_type REELS и video_url также принимает cover_url, публичный URL изображения, которое Meta загружает и использует как обложку на вкладке Reels, или thumb_offset, позицию кадра в миллисекундах. Обложка принадлежит контейнеру, поэтому её выбирают до публикации Reel.

A Reel container with its own cover
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json

{
  "media_type": "REELS",
  "video_url": "https://example.com/reel.mp4",
  "caption": "<CAPTION>",
  "cover_url": "https://example.com/cover.jpg"
}

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

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

  • Формат: JPEG.
  • Размер файла: до 8 МБ.
  • Цветовое пространство: sRGB; изображения в других цветовых пространствах конвертируются.
  • Соотношение сторон: рекомендуется 9:16, чтобы избежать обрезки и пустых полей.
  • Расположение: публичный сервер, так как Meta сама загружает изображение по URL.

Как обрезается обложка?

От центра. Если изображение не 9:16, Meta обрезает его и использует средний прямоугольник 9:16 как обложку Reel. При публикации Reel в ленте обложкой поста становится средний квадрат 1:1. Лица и текст, расположенные ближе к центру, попадут в оба кадра.

Как работает thumb_offset?

Он задаёт момент видео в миллисекундах, кадр которого становится миниатюрой; по умолчанию 0, то есть первый кадр. Значение должно быть не меньше 0 и меньше длительности видео, иначе запрос завершится с кодом 1, подкодом 2207057. thumb_offset применяется и к контейнерам видео; если у Reel также задан cover_url, Meta его игнорирует.

Можно ли позже прочитать или изменить обложку?

Прочитать можно: опубликованный Reel возвращает media_type VIDEO, а поле thumbnail_url отдаёт изображение миниатюры. Изменить сложнее: единственное обновление, которое Meta документирует для опубликованного медиа, включает или отключает комментарии, поэтому обложка определяется при создании контейнера.

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

  • Передача cover_url и thumb_offset вместе с ожиданием кадра. Meta использует cover_url и игнорирует thumb_offset.
  • Указание thumb_offset в секундах. Значение считается в миллисекундах, а значение, равное длительности видео или превышающее её, завершится с подкодом 2207057.
  • Загрузка PNG в качестве обложки. Обложка Reels должна быть JPEG размером до 8 МБ.
  • Размещение объекта у края обложки. Meta сохраняет средний 9:16 изображения и только средний квадрат в ленте.
Настройка с EasyCoexistence

Инструмент не принимает cover_url и thumb_offset, поэтому Reels выходит с кадром, который выбирает Instagram, а другая обложка выбирается в приложении Instagram. От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений, с бесплатным пробным периодом на первые 3 дня.

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

Можно ли загрузить собственную обложку для Reel через API?

Да. Передайте cover_url с публичным URL JPEG размером до 8 МБ при создании контейнера Reel.

Обязательно ли обложка Reel должна быть в sRGB?

Желательно. Спецификация Meta требует sRGB и конвертирует изображения в других цветовых пространствах; обложка должна быть JPEG размером до 8 МБ.

Что означает ошибка 2207057 для Reel в Instagram?

Значение thumb_offset Reel выходит за допустимые пределы под кодом 1: оно должно быть не меньше 0 и меньше длительности видео, в миллисекундах, так что 5 секунд от начала соответствуют значению 5000.

Что будет, если передать и cover_url, и thumb_offset?

Meta использует изображение из cover_url и игнорирует thumb_offset.

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

Статус медиаконтейнера Instagram: коды и жизненный циклЧто означает status_code медиаконтейнера Instagram: от IN_PROGRESS до EXPIRED, сколько живёт контейнер и как часто его проверять.Лимиты подписей в Instagram: символы, хэштеги и @-упоминания в APIПодписи в API Instagram: до 2 200 символов и 20 @-упоминаний. Instagram разрешает 5 хэштегов в публикации, а справочник API всё ещё указывает 30.Альтернативный текст в публикациях Instagram через APIКак API Instagram добавляет альтернативный текст к постам с фото через alt_text: до 1 000 символов на фото или каждое изображение карусели.Публикация Reels в Instagram через APIКак Instagram API публикует Reels: требования Meta к видео, контейнеры и время обработки, показ в Feed, обложки и метрики Reels.Лимиты публикации в Instagram API: форматы, размеры и посты в деньЧто вмещает публикация через Instagram API и сколько их в сутки: JPEG до 8 МБ, Reels, Stories, подписи до 2 200 символов, 100 постов за 24 часа.

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

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

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

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