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

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 или вашего кода, наряду с текстом, ссылками и фото.

30 a day

Лимит публикаций через API на Страницу за скользящий период 24 часа, проверяется на POST /{page_id}/video_reels.

3 to 90 s

Длительность Reel, которую принимает Meta; Reel, опубликованный как история Страницы, не может превышать 60 секунд.

540 x 960

Минимальное разрешение Reel; Meta рекомендует 1080 x 1920 пикселей при соотношении сторон 9 x 16.

29 days

Самый дальний срок, на который scheduled_publish_time может запланировать Reel: не меньше 10 минут вперёд, с video_state SCHEDULED.

1363128

Код ошибки для Reel, длительность которого Facebook не поддерживает; Reels должны идти от 3 до 90 секунд.

Как Reels API публикует Reel?

В три шага и на двух хостах. Вызовы start и finish идут на эндпоинт video_reels Страницы на graph.facebook.com, а само видео отправляется на rupload.facebook.com, по upload_url, который возвращает вызов start. Проверка статуса по ID видео между загрузкой и finish показывает, получила ли Meta файл целиком и обработала ли его.

1StartPOST /{page-id}/video_reels, upload_phase start: returns video_id and upload_url
2UploadPOST to rupload.facebook.com with the bytes or a file_url header
3CheckGET /{video-id}?fields=status until processing completes
4FinishPOST /{page-id}/video_reels, upload_phase finish, video_state PUBLISHED

Какое видео нужно для Reel?

Meta публикует требования к Reels в руководстве Reels Publishing, и загрузка, не соответствующая им по соотношению сторон, разрешению, длительности или частоте кадров, отклоняется с собственным кодом ошибки. Reel, предназначенный для истории Страницы, также должен укладываться в 60 секунд.

File.mp4 recommended
Aspect ratio9 x 16
Resolution1080 x 1920 recommended, 540 x 960 at least
Frame rate24 to 60 fps, fixed, progressive scan
Duration3 to 90 seconds
VideoH.264 or H.265 (VP9 and AV1 also supported), 4:2:0, closed GOP of 2 to 5 s
AudioAAC Low Complexity, 48 kHz, stereo, 128 kbps or more

Как загружается видео?

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 советует кросспостинг, чтобы повторно использовать видео на другой Странице.
Uploading a hosted video
# <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 часа, поэтому распределяйте запланированные публикации.
Настройка с EasyCoexistence

Инструмента для 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 появляется и на их Странице.

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

Публикация видео на Facebook Page через APIКак опубликовать видео на Facebook Page через Graph API: file_url или загруженный файл на /videos, заголовок, описание и статус обработки.Публикация Stories на Facebook-странице через APIStories API от Meta публикует фото- и видеоистории на Facebook-странице: photo_stories, video_stories, требования к медиа и список историй.Метрики видео и Reels Facebook через APIМетрики видео и Reels Facebook, которые работают в 2026 году: как читать их из video_insights и какие метрики показов Meta объявила устаревшими.API постов Facebook-страницы: текст, ссылки, фото и видеоКак публиковать посты на Facebook-страницах через Graph API: текст и ссылки в /feed, фото по URL в /photos, видео в /videos и правила Meta.Разрешения Facebook Page API и требования App ReviewДевять разрешений Facebook Page, что открывает каждое и что App Review требует: расширенный доступ, верификация бизнеса, запись экрана.Лимиты запросов Graph API Facebook: ошибки 4, 17, 32, 613 и 80001Ошибки Facebook API 4, 17, 32, 613 и 80001: лимит запросов для приложения, пользователя или Страницы и когда повторять вызов.

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

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

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

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