Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Menyiarkan Instagram Reels melalui API

API Instagram menyiarkan Reel daripada fail MOV atau MP4 di URL awam: cipta container dengan media_type REELS, tunggu sementara Meta memproses video, kemudian siarkannya. Reel boleh berdurasi 3 saat hingga 15 minit dan saiz sehingga 300 MB, serta Meta mengesyorkan bingkai 9:16 supaya tidak dipotong atau ada ruang kosong.

easyCoexistence menyiarkan Reels dengan publish_instagram_post daripada Claude, ChatGPT atau kod sendiri anda: beri URL video dan kapsyen, dan semasa video masih diproses, ia menyiapkan penerbitan dengan sendirinya.

15 min

Reel terpanjang yang disiarkan oleh API; yang terpendek ialah 3 saat.

300 MB

Fail Reel terbesar, dalam format MOV atau MP4 dengan video H.264 atau HEVC dan audio AAC.

1 min

Kekerapan Meta mencadangkan semakan status container yang sedang diproses, selama tidak lebih daripada 5 minit.

24 hours

Tempoh container Reel boleh menunggu tanpa disiarkan sebelum ia tamat tempoh.

Bagaimana Reel disiarkan?

Dalam tiga langkah. Pertama, POST /<IG_ID>/media dengan media_type ditetapkan kepada REELS, video_url menunjuk ke fail dan, jika mahu, kapsyen; Meta mengambil video dan memulangkan ID container. Kedua, tunggu sementara Instagram memproses video, dengan menyemak status_code container. Ketiga, POST /<IG_ID>/media_publish dengan creation_id ditetapkan kepada ID container, dan respons membawa ID media yang baharu.

Meta mendokumentasikan muat naik boleh disambung semula, yang boleh menghantar fail daripada komputer, hanya untuk persediaan yang dibina atas Facebook Login for Business, termasuk Unified Login. Dengan Instagram Login, video sentiasa datang daripada URL awam.

Apakah keperluan video?

Spesifikasi Meta untuk Reel, yang mesti dipenuhi oleh fail sebelum Instagram memprosesnya:

  • Container: MOV atau MP4 (MPEG-4 Part 14), tanpa edit list, dengan atom moov di hadapan fail.
  • Video: H.264 atau HEVC, imbasan progresif, closed GOP, subsampling kroma 4:2:0, 23 hingga 60 bingkai sesaat, sehingga 1920 piksel lebar dan 25 Mbps.
  • Audio: AAC, sehingga 48 kHz, mono atau stereo, pada 128 kbps.
  • Nisbah aspek: mana-mana antara 0.01:1 hingga 10:1, dengan 9:16 disyorkan.
  • Panjang dan saiz: 3 saat hingga 15 minit, sehingga 300 MB.

Apa yang berlaku semasa video diproses?

status_code container akan menunjukkan IN_PROGRESS sehingga Instagram selesai memproses video, kemudian FINISHED, dan hanya selepas itu ia boleh disiarkan. Menyiarkan lebih awal gagal dengan kod 9007, subkod 2207027, yang bermaksud perlu tunggu, bukan diperbetulkan. Meta mencadangkan semakan status sekali seminit, selama tidak lebih daripada 5 minit.

ERROR bermaksud container gagal menyelesaikan pemprosesan, dan EXPIRED bermaksud ia kekal tanpa disiarkan selama 24 jam; kedua-duanya memerlukan container baharu. PUBLISHED bermaksud Reel sudah disiarkan dan dalam talian.

Apakah pilihan Reel yang ditawarkan API?

Selain video dan kapsyen, container Reel Meta menerima parameter berikut:

  • share_to_feed: true membolehkan Reel muncul di Feed serta tab Reels, false mengekalkannya di tab Reels sahaja. Kedua-dua nilai tidak menjamin tempat dalam tab Reels.
  • cover_url: JPEG sehingga 8 MB yang digunakan sebagai sampul tab Reels, dipotong kepada 9:16 di tengah, dan kepada segi empat sama apabila dikongsi ke Feed.
  • thumb_offset: bingkai, dalam milisaat, yang digunakan sebagai imej kecil apabila tiada sampul; 0 ialah bingkai pertama.
  • audio_name: nama untuk audio Reel, yang hanya boleh ditetapkan sekali.
  • trial_params: menyiarkan Reel percubaan, yang hanya dikongsi kepada orang yang tidak mengikuti akaun sehingga ia diluluskan.

Apa lagi yang terpakai pada Reel?

Beberapa peraturan terpakai pada Reel sejak container dicipta.

  • Reel tidak boleh menjadi item karusel; ia sentiasa disiarkan secara berasingan.
  • Tetapan privasi akaun terpakai semasa penyiaran: dengan Benarkan remix dihidupkan, Reel baharu turut membenarkan remix.
  • Penandaan muzik hanya tersedia untuk audio asal.
  • Apabila dibaca semula kemudian, Reel melaporkan media_type VIDEO, seperti video lain.
  • Ia dikira sebagai satu daripada 100 siaran melalui API bagi akaun dalam tempoh 24 jam.

Metrik apa yang dilaporkan Reel?

Melalui endpoint wawasan media, Reel melaporkan capaian, tontonan, suka, komen, disimpan, kongsi, total_interactions dan siaran semula, serta tiga metrik tersendiri: ig_reels_avg_watch_time, ig_reels_video_view_total_time dan reels_skip_rate, iaitu bahagian tontonan yang dilangkau dalam 3 saat pertama. Suka, komen dan tontonan hanya dikira sebagai aktiviti organik, dan data di sebalik mereka boleh lewat sehingga 48 jam.

Kesilapan biasa

  • Menyiarkan sebaik sahaja container dicipta. Tunggu sehingga status_code menunjukkan FINISHED, jika tidak panggilan gagal dengan subkod 2207027.
  • Menghantar fail WebM atau AVI. Reel mesti dalam format MOV atau MP4, atau Meta menolaknya dengan kod 352, subkod 2207026.
  • Mengharapkan share_to_feed meletakkan Reel dalam tab Reels. Ia hanya menambah Feed; Instagram yang menentukan apa yang dipaparkan dalam tab Reels.
  • Membiarkan container tanpa disiarkan semalaman. Ia tamat tempoh 24 jam selepas dicipta, dan penyiaran kemudian memerlukan container baharu.
Menggunakan EasyCoexistence untuk ini

Reels juga boleh dijadualkan dari barisan jadualnya sendiri. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Berapa lama Reel boleh berada melalui API?

Dari 3 saat hingga 15 minit, sebagai fail MOV atau MP4 sehingga 300 MB.

Bolehkah saya memuat naik Reel dari komputer saya?

Tidak dengan Instagram Login. API mengambil video daripada URL awam, jadi letakkan fail di tempat yang memberinya pautan awam dahulu.

Adakah Reel yang disiarkan melalui API juga muncul di Feed?

Boleh. Parameter share_to_feed menentukan sama ada Reel boleh muncul di Feed serta dalam tab Reels.

Mengapa penyiaran Reel gagal dengan 9007?

Instagram masih memproses video. Semak status_code container dan siarkan apabila ia menunjukkan FINISHED; tiada apa dalam permintaan itu yang perlu diperbetulkan.

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