Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Facebook Reels API: publikowanie Reels na Stronie

Facebook Reels API publikuje Reels na Stronie w trzech krokach: POST /{page-id}/video_reels z upload_phase start zwraca video_id, wideo trafia na rupload.facebook.com, a POST /{page-id}/video_reels z upload_phase finish i video_state PUBLISHED je publikuje. Specyfikacja Meta to wideo 9:16 o długości od 3 do 90 sekund, a Strona może opublikować przez API 30 Reels w ciągu 24 godzin.

easyCoexistence publikuje wideo na Stronie na Facebooku jako zwykłe posty wideo przez publish_facebook_post, z Claude, ChatGPT lub Twojego własnego kodu, obok tekstu, linków i zdjęć.

30 a day

Reels opublikowane przez API na Stronę w ruchomym okresie 24 godzin, egzekwowane na POST /{page_id}/video_reels.

3 to 90 s

Długość Reels akceptowana przez Meta; Reels opublikowany jako relacja na Stronie nie może przekraczać 60 sekund.

540 x 960

Minimalna rozdzielczość Reels; Meta zaleca 1080 x 1920 pikseli przy proporcji 9 x 16.

29 days

Najdalej wysunięty scheduled_publish_time, jaki może ustawić Reels, co najmniej 10 minut naprzód, z video_state SCHEDULED.

1363128

Kod błędu dla Reels o długości, której Facebook nie obsługuje; Reels muszą trwać od 3 do 90 sekund.

Jak Reels API publikuje Reels?

W trzech krokach w dwóch hostach. Wywołania start i finish idą do edge video_reels Strony na graph.facebook.com, a samo wideo trafia na rupload.facebook.com, pod upload_url zwrócony przez wywołanie start. Sprawdzenie statusu ID wideo między uploadem a finish pokazuje, czy Meta ma cały plik i czy go przetworzyła.

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

Jakie wideo potrzebuje Reels?

Meta publikuje specyfikacje Reels w przewodniku Reels Publishing, a upload, który nie spełnia wymagań dotyczących proporcji, rozdzielczości, długości lub liczby klatek na sekundę, zostaje odrzucony z własnym kodem błędu. Reels przeznaczony jako relacja na Stronie musi też mieścić się w 60 sekundach.

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

Jak wideo jest wysyłane?

Żądaniem POST na upload_url na rupload.facebook.com, z tokenem Strony w nagłówku Authorization: OAuth. Plik na Twoim komputerze idzie jako treść żądania, z nagłówkiem offset ustawionym na 0 i file_size ustawionym na jego rozmiar w bajtach. Plik już dostępny w sieci wysyłasz zamiast tego w nagłówku file_url; Meta sama go pobiera, a udany upload zwraca success ustawione na true.

  • file_url przyjmuje adresy http lub https; adresy wymagające uwierzytelnienia nie są obsługiwane.
  • Host musi pozwolić agentowi użytkownika facebookexternalhit/1.1 pobrać plik, bo Meta odrzuca pliki na stronach, które to blokują w robots.txt.
  • Pliki z sieci CDN Meta, na przykład adresy fbcdn, są odrzucane; Meta wskazuje crossposting, aby ponownie użyć wideo na innej Stronie.
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"

Jak sprawdzić status Reels?

Żądaniem GET /{video-id}?fields=status na graph.facebook.com. Odpowiedź zawiera video_status, które przyjmuje wartości uploading, upload_complete, processing, ready, upload_failed, expired lub error, oraz po jednym obiekcie na fazę: uploading_phase z bytes_transfered, processing_phase z ewentualnym komunikatem błędu oraz publishing_phase z publish_status (draft, scheduled, published lub error) i publish_time. Status każdej fazy to not_started, in_progress, completed lub error.

Jak wznowić przerwany upload?

Wysyłając ponownie POST uploadu z nagłówkiem offset ustawionym na uploading_phase.bytes_transfered z wywołania statusu, czyli na bajty, które Meta już ma. Offset, którego Meta nie przyjmuje, zwraca OffsetInvalidError, treść niezgodna z długością pliku zwraca PartialRequestError, a gdy ponowny upload nie działa, Meta radzi zacząć od pierwszego kroku.

Co przyjmuje wywołanie finish?

video_id z wywołania start, upload_phase ustawione na finish oraz video_state ustawione na PUBLISHED, DRAFT lub SCHEDULED. description niesie tekst i obsługuje hashtagi. title oraz place dla Strony z lokalizacją, a także is_ai_generated, które ujawnia, że Reels został stworzony lub edytowany z pomocą AI, są opcjonalne. Zaplanowany Reels dodaje scheduled_publish_time, znacznik czasu UNIX więcej niż 10 minut i nie dalej niż 29 dni naprzód. Meta odpowiada success ustawionym na true.

Ile Reels Strona może opublikować przez API?

30 w ruchomym okresie 24 godzin. Meta egzekwuje limit na POST /{page_id}/video_reels przy publikacji i zaleca, aby same aplikacje też go egzekwowały, zwłaszcza te, które pozwalają ludziom planować posty na później. Zaproszenia współpracowników mają własny limit, 10 na Stronę w ciągu 24 godzin, a dokumentacja video_reels podaje błąd 613: wywołania tego API przekroczyły limit częstotliwości.

Jakie uprawnienia i zadanie na Stronie są potrzebne?

Token dostępu Strony od kogoś, kto może wykonać zadanie CREATE_CONTENT na Stronie, z uprawnieniami pages_show_list, pages_read_engagement i pages_manage_posts przyznanymi przez Facebook Login. Meta prosi też aplikacje, aby pokazywały użytkownikowi informację o tym, jak jego Reels są używane na Facebooku, wraz z opcjami kontroli, oraz aby oferowały tylko widownię Public, ponieważ publikacja na Stronie ma domyślnie zasięg publiczny.

Jakich błędów zwraca Reels API?

Kod 100 oznacza brak wymaganego parametru, na przykład upload_phase, a komunikat Meta wymienia brakujące. Cztery kolejne kody odrzucają wideo spoza specyfikacji:

  • 1363040: proporcja nie jest obsługiwana; wideo musi mieścić się między 16x9 a 9x16.
  • 1363127: rozdzielczość nie jest obsługiwana; minimum to 540 x 960 pikseli.
  • 1363128: długość nie jest obsługiwana; Reels trwają od 3 do 90 sekund.
  • 1363129: średnia liczba klatek na sekundę nie jest obsługiwana; Reels potrzebują od 24 do 60 klatek na sekundę.

Jak wylistować Reels Strony?

Żądaniem GET /{page-id}/video_reels, które zwraca opublikowane Reels Strony wraz z ich ID, czasem aktualizacji i opisami. since i until zawężają listę do dat podanych jako today, yesterday, znacznik czasu UNIX lub yyyy-mm-dd, przy czym until musi być późniejsze niż since. Dokumentacja feedu Meta wskazuje tę krawędź dla Reels opublikowanych na Stronie.

Jak publikować Reels przez easyCoexistence?

Dziś nie jako Reels. publish_facebook_post wysyła wideo do edge videos Strony jako zwykłe posty wideo, a easyCoexistence nie ma narzędzia do wywołań video_reels; tokeny Strony nie są wydawane, więc tych trzech kroków nie da się też wykonać z Twojego własnego kodu na jego połączeniu. Opublikuj film w Reels z Facebooka lub Meta Business Suite albo wrzuć wideo jako zwykły post wideo.

Typowe błędy

  • Wysyłanie uploadu na graph.facebook.com. Wideo idzie na rupload.facebook.com z nagłówkiem Authorization: OAuth; tylko wywołania start, finish i status używają graph.facebook.com.
  • Hostowanie pliku tam, gdzie Meta go nie pobierze. file_url za logowaniem, na stronie, której robots.txt blokuje facebookexternalhit/1.1, albo na fbcdn jest odrzucany.
  • Zaczynanie od nowa po przerwanym uploadzie. Najpierw sprawdź status: uploading_phase.bytes_transfered to offset, od którego wznawiasz, a nowa sesja to ostateczność.
  • Kolejkowanie ponad 30 Reels dla jednej Strony w ciągu dnia. Meta liczy Reels opublikowane przez API w ruchomym okresie 24 godzin, więc rozłóż zaplanowane równomiernie.
Z EasyCoexistence zrobisz to

Nie ma narzędzia do Reels API, więc Reels publikuje się z Facebooka lub Meta Business Suite. US$ 9 do US$ 0.75 za połączenie miesięcznie, z każdym kolejnym połączeniem taniej, a pierwsze 3 dni są bezpłatne.

Najczęściej zadawane pytania

Czy przez API można opublikować Reels na profilu Facebooka lub w grupie?

Nie. Reels Publishing API Meta publikuje Reels tylko na Stronach Facebooka, a crossposting kieruje je wyłącznie na inne Strony.

Czy publish_facebook_post publikuje Reels?

Nie. Wysyła tekst, linki, zdjęcia i wideo na Stronę. Reels wymaga wywołań video_reels, których narzędzia easyCoexistence nie wykonują.

Jak sprawdzić Reels pod kątem dopasowań praw autorskich?

Odczytaj GET /{video-id}?fields=copyright_check_information z pages_read_engagement. Meta uruchamia sprawdzenie przy uploadzie, może to potrwać kilka minut, a dopasowania widzi tylko właściciel.

Czy inna Strona może opublikować mój Reels?

Tak, jako współpracownik. POST /{video-id}/collaborators z target_id ustawionym na ID ich Strony wysyła zaproszenie, a po jego przyjęciu Reels pojawia się także na ich Stronie.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w