Mengatur sampul Reel lewat API Instagram
API Instagram mengatur sampul Reel saat container dibuat dengan salah satu dari dua cara: cover_url menunjuk ke gambar JPEG yang dipakai sebagai sampul tab Reels, atau thumb_offset memilih frame video, dalam milidetik dari awal. Jika keduanya tidak dikirim, frame pertama dipakai, dan jika keduanya dikirim, cover_url yang didahulukan.
easyCoexistence menerbitkan Reel dengan publish_instagram_post dari Claude, ChatGPT, atau kode Anda sendiri.
Ukuran sampul Reels terbesar; harus berupa JPEG, dan ruang warna lain dikonversi ke sRGB.
Bentuk sampul yang direkomendasikan Meta; bentuk lain dipotong ke persegi panjang 9:16 di bagian tengahnya.
Persegi tengah yang dipotong Meta dari sampul saat Reel dibagikan ke Feed.
Nilai thumb_offset default, yang menjadikan frame pertama video sebagai thumbnail.
Subkode kesalahan untuk thumb_offset di bawah 0 atau tidak lebih pendek dari durasi video.
Bagaimana cara mengatur sampul Reel?
Pada container Reel. POST /<IG_ID>/media dengan media_type REELS dan video_url juga menerima cover_url, URL publik gambar yang diambil Meta dan dipakai sebagai sampul tab Reels, atau thumb_offset, posisi frame yang dipakai dalam milidetik. Sampul menjadi milik container, jadi dipilih sebelum Reel dipublikasikan.
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"
}Seperti apa gambar sampul harus berupa?
Spesifikasi Meta untuk foto sampul Reels, yang harus dipenuhi gambar di cover_url:
- Format: JPEG.
- Ukuran file: hingga 8 MB.
- Ruang warna: sRGB; gambar dengan ruang warna lain dikonversi.
- Rasio aspek: 9:16 direkomendasikan, agar tidak terpotong atau ada ruang kosong.
- Lokasi: server publik, karena Meta mengambil gambar langsung dari URL.
Bagaimana sampul dipotong?
Dari tengah. Jika gambar bukan 9:16, Meta memotongnya dan memakai persegi panjang 9:16 di tengah sebagai sampul Reel; saat Reel dibagikan ke Feed, persegi 1:1 di tengah menjadi sampul postingan Feed. Menjaga wajah dan teks dekat pusat membuat keduanya tetap terlihat di kedua potongan.
Bagaimana cara kerja thumb_offset?
Menunjuk satu momen dalam video, dalam milidetik, yang frame-nya menjadi thumbnail; nilai default, 0, adalah frame pertama. Nilainya harus 0 atau lebih dan kurang dari durasi video, jika tidak permintaan gagal dengan kode 1, subkode 2207057. thumb_offset juga berlaku untuk container video, dan pada Reel yang juga memiliki cover_url, Meta mengabaikannya.
Bisakah sampul dibaca kembali atau diubah nanti?
Bisa dibaca kembali: Reel yang sudah dipublikasikan melaporkan media_type VIDEO, dan field thumbnail_url mengembalikan gambar thumbnail media. Mengubahnya adalah soal lain, karena satu-satunya pembaruan yang didokumentasikan Meta untuk media yang sudah dipublikasikan adalah mengaktifkan atau menonaktifkan komentar, jadi sampul ditetapkan saat container dibuat.
Kesalahan umum
- Mengirim cover_url dan thumb_offset bersamaan lalu berharap mendapat frame. Meta memakai cover_url dan mengabaikan thumb_offset.
- Memberi thumb_offset dalam detik. Nilainya dihitung dalam milidetik, dan nilai yang sama dengan atau melewati durasi video gagal dengan subkode 2207057.
- Mengunggah sampul PNG. Sampul Reels harus berupa JPEG hingga 8 MB.
- Menempatkan subjek di tepi sampul. Meta mempertahankan 9:16 di tengah gambar, dan hanya persegi tengah di Feed.
Alat ini tidak menerima cover_url atau thumb_offset, sehingga Reel terbit dengan frame yang dipilih Instagram, dan sampul lain dipilih di aplikasi Instagram. US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah saya mengunggah sampul kustom untuk Reel lewat API?
Bisa. Kirim cover_url dengan URL publik JPEG hingga 8 MB saat membuat container Reel.
Apakah sampul Reel harus sRGB?
Sebaiknya begitu. Spesifikasi Meta meminta sRGB dan mengonversi gambar dengan ruang warna lain, dan sampul harus berupa JPEG hingga 8 MB.
Apa arti kesalahan 2207057 pada Reel Instagram?
thumb_offset Reel berada di luar rentang, di bawah kode 1: nilainya harus minimal 0 dan kurang dari durasi video, dihitung dalam milidetik, jadi 5 detik ke dalam adalah 5000.
Bagaimana jika saya mengirim cover_url dan thumb_offset sekaligus?
Meta memakai gambar cover_url dan mengabaikan thumb_offset.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada