Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Menetapkan imej sampul Reel melalui Instagram API

API Instagram menetapkan sampul Reel dalam salah satu daripada dua cara ketika kontena dicipta: cover_url merujuk kepada imej JPEG untuk digunakan sebagai sampul tab Reels, atau thumb_offset memilih satu bingkai video, dalam milisaat dari permulaan. Tanpa kedua-duanya, bingkai pertama digunakan, dan apabila kedua-duanya dihantar, cover_url yang diutamakan.

easyCoexistence menerbitkan Reels dengan publish_instagram_post daripada Claude, ChatGPT atau kod anda sendiri.

8 MB

Imej sampul Reels terbesar; ia mesti JPEG, dan ruang warna lain ditukar kepada sRGB.

9:16

Bentuk sampul yang disyorkan Meta; bentuk lain dipotong kepada segi empat tepat 9:16 di tengahnya.

1:1

Segi empat sama tengah yang dipotong Meta daripada sampul apabila Reel dikongsi ke Suapan.

0 ms

Nilai lalai thumb_offset, yang menjadikan bingkai pertama video sebagai thumbnail.

2207057

Subkod ralat bagi thumb_offset yang kurang daripada 0 atau tidak lebih pendek daripada tempoh video.

Bagaimana anda menetapkan sampul Reel?

Pada kontena Reel. POST /<IG_ID>/media dengan media_type REELS dan video_url juga menerima sama ada cover_url, URL awam bagi imej yang Meta ambil dan gunakan sebagai sampul tab Reels, atau thumb_offset, kedudukan dalam milisaat bagi bingkai yang hendak digunakan. Sampul tergolong pada kontena, jadi ia dipilih sebelum Reel diterbitkan.

A Reel container with its own cover
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json

{
  "media_type": "REELS",
  "video_url": "https://example.com/reel.mp4",
  "caption": "<CAPTION>",
  "cover_url": "https://example.com/cover.jpg"
}

Apakah keperluan imej sampul?

Spesifikasi Meta untuk foto sampul Reels, yang mesti dipenuhi oleh imej di cover_url:

  • Format: JPEG.
  • Saiz fail: sehingga 8 MB.
  • Ruang warna: sRGB; imej dalam ruang warna lain akan ditukar.
  • Nisbah aspek: 9:16 disyorkan, untuk mengelak pemotongan atau ruang kosong.
  • Lokasi: pelayan awam, kerana Meta mengambil imej daripada URL itu sendiri.

Bagaimana sampul dipotong?

Di sekitar bahagian tengah. Apabila imej bukan 9:16, Meta memotongnya dan menggunakan segi empat tepat 9:16 di tengah sebagai sampul Reel, dan apabila Reel dikongsi ke Suapan, segi empat sama 1:1 di tengah menjadi sampul siaran Suapan. Meletakkan wajah dan teks berdekatan tengah membolehkan kedua-dua pemotongan memaparkannya.

Bagaimana thumb_offset berfungsi?

Ia menamakan satu detik dalam video, dalam milisaat, yang bingkainya menjadi thumbnail; nilai lalai, 0, ialah bingkai pertama. Nilai mesti 0 atau lebih dan kurang daripada tempoh video, jika tidak permintaan gagal dengan kod 1, subkod 2207057. thumb_offset juga terpakai pada kontena video, dan pada Reel yang turut mempunyai cover_url, Meta mengabaikannya.

Bolehkah sampul dibaca semula atau ditukar kemudian?

Boleh dibaca semula: Reel yang diterbitkan melaporkan media_type VIDEO, dan medan thumbnail_url memulangkan imej thumbnail media. Menukarnya ialah perkara lain, kerana satu-satunya kemas kini yang didokumentasikan Meta untuk media diterbitkan ialah mengaktifkan atau menyahaktifkan ulasan, jadi sampul ditetapkan apabila kontena dicipta.

Kesilapan biasa

  • Menghantar cover_url dan thumb_offset bersama dan mengharapkan bingkai itu. Meta menggunakan cover_url dan mengabaikan thumb_offset.
  • Memberikan thumb_offset dalam saat. Ia dikira dalam milisaat, dan nilai pada atau melebihi panjang video gagal dengan subkod 2207057.
  • Memuat naik sampul PNG. Sampul Reels mesti JPEG sehingga 8 MB.
  • Meletakkan subjek di tepi sampul. Meta mengekalkan 9:16 di tengah imej, dan hanya segi empat sama tengah dalam Suapan.
Menggunakan EasyCoexistence untuk ini

Alat itu tidak menerima cover_url atau thumb_offset, jadi Reel keluar dengan bingkai yang dipilih Instagram, dan sampul lain dipilih dalam aplikasi Instagram. Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma selama 3 hari.

Soalan lazim

Bolehkah saya memuat naik sampul tersuai untuk Reel melalui API?

Boleh. Hantar cover_url dengan URL awam bagi JPEG sehingga 8 MB apabila mencipta kontena Reel.

Adakah sampul Reel mesti sRGB?

Sebaiknya begitu. Spesifikasi Meta meminta sRGB dan menukar imej dalam ruang warna lain, dan sampul mesti JPEG sehingga 8 MB.

Apakah maksud ralat 2207057 pada Reel Instagram?

thumb_offset Reel berada di luar julat, di bawah kod 1: ia mesti sekurang-kurangnya 0 dan kurang daripada tempoh video, dikira dalam milisaat, jadi 5 saat ke dalam ialah 5000.

Bagaimana jika saya hantar kedua-dua cover_url dan thumb_offset?

Meta menggunakan imej cover_url dan mengabaikan thumb_offset.

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