Установка обложки Reel через API Instagram
API Instagram задаёт обложку Reel одним из двух способов при создании контейнера: cover_url указывает на JPEG, который используется как обложка на вкладке Reels, а thumb_offset выбирает кадр видео в миллисекундах от начала. Если не задан ни один, используется первый кадр, а при передаче обоих побеждает cover_url.
EasyCoexistence публикует Reels через publish_instagram_post из Claude, ChatGPT или вашего кода.
Самое крупное изображение обложки Reels; это должен быть JPEG, другие цветовые пространства конвертируются в sRGB.
Формат обложки, который рекомендует Meta; другие форматы обрезаются по средней области 9:16.
Средний квадрат, который Meta вырезает из обложки при публикации Reel в ленте.
Значение thumb_offset по умолчанию, при котором миниатюрой становится первый кадр видео.
Код подошибки для thumb_offset меньше 0 или не меньше длительности видео.
Как задать обложку Reel?
На контейнере Reel. POST /<IG_ID>/media с media_type REELS и video_url также принимает cover_url, публичный URL изображения, которое Meta загружает и использует как обложку на вкладке Reels, или thumb_offset, позицию кадра в миллисекундах. Обложка принадлежит контейнеру, поэтому её выбирают до публикации Reel.
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 изображения и только средний квадрат в ленте.
Инструмент не принимает 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.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на