Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Facebook Reels API: menerbitkan Reels ke Halaman

Facebook Reels API menerbitkan Reel ke Halaman dalam tiga langkah: POST /{page-id}/video_reels dengan upload_phase start memulangkan video_id, video dihantar ke rupload.facebook.com, dan POST /{page-id}/video_reels dengan upload_phase finish serta video_state PUBLISHED menyiarkannya. Spesifikasi Meta ialah video 9:16 selama 3 hingga 90 saat, dan sebuah Halaman boleh menerbitkan 30 Reel melalui API dalam tempoh 24 jam.

easyCoexistence menyiarkan video ke Halaman Facebook sebagai siaran video biasa dengan publish_facebook_post, daripada Claude, ChatGPT atau kod anda sendiri, di samping teks, pautan dan foto.

30 a day

Bilangan Reel yang diterbitkan melalui API bagi setiap Halaman dalam tempoh bergerak 24 jam, dikuatkuasakan pada POST /{page_id}/video_reels.

3 to 90 s

Tempoh Reel yang diterima Meta; Reel yang disiarkan sebagai cerita pada Halaman tidak boleh melebihi 60 saat.

540 x 960

Resolusi minimum Reel; Meta mengesyorkan 1080 x 1920 piksel pada nisbah aspek 9 x 16.

29 days

Masa jauh ke hadapan yang boleh ditetapkan oleh scheduled_publish_time untuk Reel, sekurang-kurangnya 10 minit lagi, dengan video_state SCHEDULED.

1363128

Kod ralat bagi Reel yang tempohnya tidak disokong Facebook; Reel mesti berdurasi 3 hingga 90 saat.

Bagaimana Reels API menerbitkan Reel?

Dalam tiga langkah merentasi dua hos. Panggilan mula dan selesai dihantar ke edge video_reels Halaman di graph.facebook.com, manakala video itu sendiri dihantar ke rupload.facebook.com, pada upload_url yang dipulangkan oleh panggilan mula. Semakan status pada ID video antara muat naik dan selesai menunjukkan sama ada Meta sudah menerima keseluruhan fail dan telah memprosesnya.

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

Video jenis apa yang diperlukan oleh Reel?

Meta menerbitkan spesifikasi Reels dalam panduan Reels Publishing, dan muat naik yang tidak memenuhinya dari segi nisbah aspek, resolusi, tempoh atau kadar bingkai akan ditolak dengan kod ralatnya sendiri. Reel yang dimaksudkan sebagai cerita Halaman juga mesti kekal dalam 60 saat.

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

Bagaimana video dimuat naik?

Dengan POST ke upload_url di rupload.facebook.com, membawa token Halaman dalam header Authorization: OAuth. Fail pada mesin anda dihantar sebagai badan permintaan, dengan header offset ditetapkan kepada 0 dan file_size ditetapkan kepada saiznya dalam bait. Fail yang sudah berada dalam talian dihantar sebagai header file_url, dan Meta yang mengambilnya; muat naik yang berjaya memulangkan success ditetapkan kepada true.

  • file_url menerima alamat http atau https; URL yang memerlukan pengesahan tidak disokong.
  • Hos mesti membenarkan ejen pengguna facebookexternalhit/1.1 mengambil fail, kerana Meta menolak fail di laman yang menyekatnya dalam robots.txt.
  • Fail pada CDN Meta sendiri, seperti URL fbcdn, ditolak; Meta menunjuk ke crossposting untuk menggunakan semula video di Halaman lain.
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"

Bagaimana semak status Reel?

Dengan GET /{video-id}?fields=status di graph.facebook.com. Jawapan mengandungi video_status dengan nilai uploading, upload_complete, processing, ready, upload_failed, expired atau error, dan satu objek bagi setiap fasa: uploading_phase dengan bytes_transfered, processing_phase dengan sebarang mesej ralat, dan publishing_phase dengan publish_status (draft, scheduled, published atau “error”) dan publish_time. Status setiap fasa ialah not_started, in_progress, completed atau error.

Bagaimana muat naik yang terganggu disambung semula?

Dengan menghantar semula POST muat naik dengan header offset ditetapkan kepada uploading_phase.bytes_transfered daripada semakan status, iaitu bait yang sudah diterima Meta. Offset yang tidak diterima Meta memulangkan OffsetInvalidError, badan yang panjangnya tidak sepadan dengan fail memulangkan PartialRequestError, dan apabila muat naik semula tidak berfungsi, nasihat Meta ialah memulakan semula dari langkah pertama.

Apakah yang diperlukan oleh panggilan selesai?

video_id daripada panggilan mula, upload_phase ditetapkan kepada finish dan video_state ditetapkan kepada PUBLISHED, DRAFT atau SCHEDULED. description membawa teks dan menyokong hashtag. title, place bagi Halaman lokasi dan is_ai_generated, yang mendedahkan bahawa Reel dicipta atau disunting dengan AI, bersifat pilihan. Reel yang dijadualkan menambah scheduled_publish_time, cap masa UNIX lebih 10 minit dan dalam tempoh 29 hari ke hadapan. Meta menjawab dengan success ditetapkan kepada true.

Berapa banyak Reel yang boleh diterbitkan Halaman melalui API?

30 dalam tempoh bergerak 24 jam. Meta menguatkuasakan had pada POST /{page_id}/video_reels apabila Reel diterbitkan dan mengesyorkan agar aplikasi turut menguatkuasakannya sendiri, terutamanya aplikasi yang membenarkan orang menjadualkan siaran untuk kemudian. Jemputan kolaborator mempunyai had tersendiri, 10 setiap Halaman dalam 24 jam, dan rujukan video_reels menyenaraikan ralat 613, panggilan kepada API ini telah melebihi had kadar.

Apakah kebenaran dan tugas Halaman yang diperlukan?

Token akses Halaman daripada seseorang yang boleh melaksanakan tugas CREATE_CONTENT pada Halaman, dengan pages_show_list, pages_read_engagement dan pages_manage_posts diberikan melalui Facebook Login. Meta juga meminta aplikasi memaparkan kepada pengguna notis pendedahan tentang cara Reel mereka digunakan di Facebook, dengan pilihan untuk mengawalnya, dan hanya menawarkan audiens Public, kerana penerbitan ke Halaman mempunyai skop awam tersirat.

Apakah ralat yang dikembalikan oleh Reels API?

Kod 100 bermakna parameter wajib tiada, seperti upload_phase, dan mesej Meta menyenaraikan parameter yang hilang. Empat kod lagi menolak video yang berada di luar spesifikasi:

  • 1363040: nisbah aspek tidak disokong; video perlu berada antara 16x9 dan 9x16.
  • 1363127: resolusi tidak disokong; minimum ialah 540 x 960 piksel.
  • 1363128: tempoh tidak disokong; Reel berdurasi 3 hingga 90 saat.
  • 1363129: purata kadar bingkai tidak disokong; Reel memerlukan 24 hingga 60 bingkai sesaat.

Bagaimana menyenaraikan Reel sebuah Halaman?

Dengan GET /{page-id}/video_reels, yang memulangkan Reel Halaman yang diterbitkan beserta ID, masa kemas kini dan penerangannya. since dan until mempersempitkan senarai kepada tarikh yang diberikan sebagai today, yesterday, cap masa UNIX atau yyyy-mm-dd, dengan until lebih lewat daripada since. Rujukan suapan Meta menunjuk ke edge ini untuk Reel yang diterbitkan ke Halaman.

Bagaimana menerbitkan Reel melalui easyCoexistence?

Bukan sebagai Reel, buat masa ini. publish_facebook_post menghantar video ke edge videos Halaman, sebagai siaran video biasa, dan easyCoexistence tiada alat untuk panggilan video_reels; token Halaman tidak diberikan, jadi tiga langkah itu juga tidak boleh dijalankan daripada kod anda sendiri pada sambungannya. Terbitkan Reel daripada Facebook atau Meta Business Suite, atau siarkan video itu sebagai siaran video biasa.

Kesilapan biasa

  • Menghantar muat naik ke graph.facebook.com. Video pergi ke rupload.facebook.com dengan header Authorization: OAuth; hanya panggilan mula, selesai dan status menggunakan graph.facebook.com.
  • Menghoskan fail di tempat Meta tidak dapat mengambilnya. file_url di sebalik log masuk, di laman yang robots.txt-nya menyekat facebookexternalhit/1.1, atau di fbcdn, akan ditolak.
  • Memulakan semula selepas muat naik terganggu. Baca status dahulu: uploading_phase.bytes_transfered ialah offset untuk disambung semula, dan sesi baharu ialah pilihan terakhir.
  • Menjadualkan lebih 30 Reel untuk satu Halaman dalam sehari. Meta mengira Reel yang diterbitkan melalui API dalam tempoh bergerak 24 jam, jadi agihkan Reel yang dijadualkan.
Menggunakan EasyCoexistence untuk ini

Ia tiada alat untuk Reels API, jadi Reel diterbitkan daripada Facebook atau Meta Business Suite. Daripada US$ 9 sebulan bagi setiap sambungan, menurun kepada US$ 0.75 apabila sambungan ditambah, dengan percubaan percuma 3 hari.

Soalan lazim

Bolehkah Reel diterbitkan ke profil Facebook atau kumpulan melalui API?

Tidak. API Penerbitan Reels Meta menerbitkan Reel ke Halaman Facebook sahaja, dan hanya menyiarkan silangnya ke Halaman lain.

Adakah publish_facebook_post menerbitkan Reel?

Tidak. Ia menyiarkan teks, pautan, foto dan video ke Halaman. Reel memerlukan panggilan video_reels, yang tidak dibuat oleh alat easyCoexistence.

Bagaimana saya menyemak Reel untuk padanan hak cipta?

Baca GET /{video-id}?fields=copyright_check_information dengan pages_read_engagement. Meta menjalankan semakan pada muat naik, ia boleh mengambil masa beberapa minit, dan hanya pemilik yang melihat padanan tersebut.

Bolehkah Halaman lain menerbitkan Reel saya juga?

Boleh, sebagai kolaborator. POST /{video-id}/collaborators dengan target_id ditetapkan kepada ID Halaman mereka menghantar jemputan, dan selepas mereka menerima, Reel itu muncul di Halaman mereka juga.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada