Facebook Reels API: публикация Reels на Странице
Facebook Reels API публикует Reel на Странице в три шага: POST /{page-id}/video_reels с upload_phase start возвращает video_id, видео отправляется на rupload.facebook.com, а POST /{page-id}/video_reels с upload_phase finish и video_state PUBLISHED публикует его. Спецификация Meta: видео 9:16 длительностью от 3 до 90 секунд, а Страница может опубликовать через API 30 Reels за любые 24 часа.
easyCoexistence публикует видео на Странице Facebook как обычные видеопубликации инструментом publish_facebook_post из Claude, ChatGPT или вашего кода, наряду с текстом, ссылками и фото.
Лимит публикаций через API на Страницу за скользящий период 24 часа, проверяется на POST /{page_id}/video_reels.
Длительность Reel, которую принимает Meta; Reel, опубликованный как история Страницы, не может превышать 60 секунд.
Минимальное разрешение Reel; Meta рекомендует 1080 x 1920 пикселей при соотношении сторон 9 x 16.
Самый дальний срок, на который scheduled_publish_time может запланировать Reel: не меньше 10 минут вперёд, с video_state SCHEDULED.
Код ошибки для Reel, длительность которого Facebook не поддерживает; Reels должны идти от 3 до 90 секунд.
Как Reels API публикует Reel?
В три шага и на двух хостах. Вызовы start и finish идут на эндпоинт video_reels Страницы на graph.facebook.com, а само видео отправляется на rupload.facebook.com, по upload_url, который возвращает вызов start. Проверка статуса по ID видео между загрузкой и finish показывает, получила ли Meta файл целиком и обработала ли его.
Какое видео нужно для Reel?
Meta публикует требования к Reels в руководстве Reels Publishing, и загрузка, не соответствующая им по соотношению сторон, разрешению, длительности или частоте кадров, отклоняется с собственным кодом ошибки. Reel, предназначенный для истории Страницы, также должен укладываться в 60 секунд.
Как загружается видео?
POST на upload_url на rupload.facebook.com с токеном доступа Страницы в заголовке Authorization: OAuth. Файл на вашем компьютере передаётся как тело запроса, с заголовком offset, равным 0, и file_size, равным его размеру в байтах. Файл, уже размещённый онлайн, передаётся вместо этого через заголовок file_url, и Meta сама его забирает; успешная загрузка возвращает success со значением true.
file_urlпринимает адреса http или https; URL, требующие авторизации, не поддерживаются.- Хост должен разрешить пользовательскому агенту facebookexternalhit/1.1 получать файл, так как Meta отклоняет файлы на сайтах, которые блокируют его в robots.txt.
- Файлы на собственном CDN Meta, например URL fbcdn, отклоняются; Meta советует кросспостинг, чтобы повторно использовать видео на другой Странице.
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"Как проверить статус Reel?
GET /{video-id}?fields=status на graph.facebook.com. В ответе есть video_status, который принимает значения uploading, upload_complete, processing, ready, upload_failed, expired или error, и по одному объекту на каждую фазу: uploading_phase с bytes_transfered, processing_phase с сообщением об ошибке, если оно есть, и publishing_phase с publish_status (draft, scheduled, published или error) и publish_time. Собственный статус каждой фазы: not_started, in_progress, completed или error.
Как возобновить прерванную загрузку?
Повторным POST загрузки с заголовком offset, равным uploading_phase.bytes_transfered из проверки статуса, то есть числу байт, которое Meta уже получила. Смещение, которое Meta не принимает, возвращает OffsetInvalidError; тело, не совпадающее с длиной файла, возвращает PartialRequestError. Если повторная загрузка не помогает, Meta советует начать заново с первого шага.
Что принимает вызов finish?
video_id из вызова start, upload_phase со значением finish и video_state со значением PUBLISHED, DRAFT или SCHEDULED. В description передаётся текст, поддерживаются хештеги. Необязательны title, place для Страницы с локацией и is_ai_generated, которое раскрывает, что Reel создан или изменён с помощью ИИ. Для запланированного Reel добавляется scheduled_publish_time, UNIX-метка времени не менее чем на 10 минут и не более чем на 29 дней вперёд. Meta отвечает success со значением true.
Сколько Reels может опубликовать Страница через API?
30 за скользящий период 24 часа. Meta проверяет лимит на POST /{page_id}/video_reels при публикации Reel и рекомендует, чтобы приложения тоже соблюдали его сами, особенно те, что позволяют людям планировать публикации на потом. У приглашений соавторов свой лимит: 10 на Страницу за 24 часа. В справочнике video_reels указана ошибка 613: вызовы этого API превысили ограничение частоты запросов.
Какие разрешения и задача Страницы нужны?
Токен доступа Страницы от пользователя, который может выполнять задачу CREATE_CONTENT на Странице, с разрешениями pages_show_list, pages_read_engagement и pages_manage_posts, выданными через Facebook Login. Meta также просит приложения показать пользователю уведомление о том, как его Reels используются на Facebook, с настройками управления им, и предлагать только аудиторию «Public», так как публикация на Странице неявно подразумевает публичный доступ.
Какие ошибки возвращает Reels API?
Код 100 означает, что не передан обязательный параметр, например upload_phase; сообщение Meta перечисляет недостающие. Ещё четыре кода отклоняют видео, которое не соответствует требованиям:
- 1363040: соотношение сторон не поддерживается; видео должно быть между 16x9 и 9x16.
- 1363127: разрешение не поддерживается; минимум 540 x 960 пикселей.
- 1363128: длительность не поддерживается; Reels идут от 3 до 90 секунд.
- 1363129: средняя частота кадров не поддерживается; Reels требуют от 24 до 60 кадров в секунду.
Как получить список Reels Страницы?
GET /{page-id}/video_reels возвращает опубликованные Reels Страницы с их ID, временем обновления и описаниями. since и until сужают список до дат, заданных как today, yesterday, UNIX-метка времени или yyyy-mm-dd, при этом until должно быть позже since. Справочник ленты Meta указывает на этот эндпоинт для Reels, опубликованных на Странице.
Как опубликовать Reel через easyCoexistence?
Сейчас не как Reel. publish_facebook_post отправляет видео на эндпоинт videos Страницы как обычные видеопубликации, а инструмента для вызовов video_reels в easyCoexistence нет; токены Страницы не выдаются, поэтому и из вашего кода через его подключение три шага выполнить нельзя. Опубликуйте Reel из Facebook или Meta Business Suite либо разместите видео как обычную видеопубликацию.
Распространённые ошибки
- Отправка загрузки на graph.facebook.com. Видео уходит на rupload.facebook.com с заголовком Authorization: OAuth; на graph.facebook.com идут только вызовы start, finish и проверки статуса.
- Файл размещён там, где Meta не может его забрать. file_url за логином, на сайте, где robots.txt блокирует facebookexternalhit/1.1, или на fbcdn отклоняется.
- Начинать заново после прерванной загрузки. Сначала проверьте статус: uploading_phase.bytes_transfered это offset, с которого нужно продолжить, а новая сессия остаётся крайним вариантом.
- Постановка в очередь более 30 Reels для одной Страницы за день. Meta считает опубликованные через API Reels за скользящий период 24 часа, поэтому распределяйте запланированные публикации.
Инструмента для Reels API у него нет, поэтому Reel публикуется из Facebook или Meta Business Suite. От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений снижается, с бесплатным пробным периодом 3 дня.
Часто задаваемые вопросы
Можно ли публиковать Reel через API в профиль Facebook или группу?
Нет. Reels Publishing API от Meta публикует Reels только на Страницы Facebook и кросспостит их только на Страницы.
Публикует ли publish_facebook_post Reels?
Нет. Он публикует на Странице текст, ссылки, фото и видео. Для Reel нужны вызовы video_reels, которые инструменты easyCoexistence не выполняют.
Как проверить Reel на совпадения с авторскими правами?
Читайте GET /{video-id}?fields=copyright_check_information с разрешением pages_read_engagement. Meta запускает проверку при загрузке, она может занять пару минут, а совпадения видит только владелец.
Может ли другая Страница опубликовать мой Reel тоже?
Да, как соавтор. POST /{video-id}/collaborators с target_id, равным ID их Страницы, отправляет приглашение, и после принятия Reel появляется и на их Странице.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на