Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Reel kapak görselini Instagram API ile ayarlama

Instagram API'si bir Reel'in kapağını container oluşturulurken iki yoldan biriyle belirler: cover_url, Reels sekmesinde kapak olarak kullanılacak bir JPEG görselin adresini gösterir; thumb_offset ise videonun başından itibaren milisaniye cinsinden bir kareyi seçer. İkisi de gönderilmezse ilk kare kullanılır; ikisi birden gönderilirse cover_url geçerli olur.

easyCoexistence, Reel'leri Claude, ChatGPT veya kendi kodunuzdan publish_instagram_post ile yayımlar.

8 MB

Reels kapak görselinin izin verilen en büyük boyutu; JPEG olmalı, diğer renk uzayları sRGB'ye dönüştürülür.

9:16

Meta'nın önerdiği kapak şekli; diğer şekiller ortadaki 9:16 dikdörtgene kırpılır.

1:1

Reel Feed'de paylaşıldığında Meta'nın kapaktan kestiği orta kare.

0 ms

Varsayılan thumb_offset; videonun ilk karesini küçük resim yapar.

2207057

thumb_offset 0'ın altındaysa ya da videonun süresine eşit veya daha uzunsa dönen hata alt kodu.

Reel'in kapağı nasıl ayarlanır?

Kapak, Reel'in container'ı üzerinde belirlenir. POST /<IG_ID>/media isteğinde media_type değeri REELS olarak ayarlanır ve video_url ile birlikte cover_url ya da thumb_offset kabul edilir: cover_url, Meta'nın alıp Reels sekmesinde kapak olarak kullandığı görselin herkese açık adresidir; thumb_offset ise kullanılacak karenin milisaniye cinsinden konumudur. Kapak container'a ait olduğu için Reel yayımlanmadan önce seçilir.

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"
}

Kapak görseli nasıl olmalı?

cover_url'deki görselin karşılaması gereken Meta Reels kapak fotoğrafı özellikleri:

  • Biçim: JPEG.
  • Dosya boyutu: en fazla 8 MB.
  • Renk uzayı: sRGB; diğer renk uzaylarındaki görseller dönüştürülür.
  • En-boy oranı: kırpma ya da boş alan olmaması için 9:16 önerilir.
  • Konum: herkese açık bir sunucu, çünkü Meta görseli URL'den kendisi çeker.

Kapak nasıl kırpılır?

Ortadan. Görsel 9:16 değilse Meta onu kırpar ve Reel'in kapağı olarak ortadaki 9:16 dikdörtgeni kullanır; Reel Feed'de paylaşıldığında ise Feed gönderisinin kapağı ortadaki 1:1 kare olur. Yüzleri ve yazıları merkeze yakın tutmak, her iki kırpmada da görünmelerini sağlar.

thumb_offset nasıl çalışır?

Videoda milisaniye cinsinden bir anı belirtir; o andaki kare küçük resim olur. Varsayılan değer 0'dır ve ilk kareyi kullanır. Değer 0 veya daha büyük ve videonun süresinden küçük olmalıdır; aksi halde istek, 1 hata kodu ve 2207057 alt koduyla başarısız olur. thumb_offset video container'larında da geçerlidir; cover_url de olan bir Reel'de Meta thumb_offset'i yok sayar.

Kapak sonradan okunabilir veya değiştirilebilir mi?

Okunabilir: yayımlanmış bir Reel'in media_type değeri VIDEO olarak döner ve thumbnail_url alanı medyanın küçük resim görselini verir. Değiştirmek ise başka bir konu: Meta'nın yayımlanmış medya için belgelediği tek güncelleme yorumları açıp kapatmaktır; bu yüzden kapak container oluşturulduğunda kesinleşir.

Yaygın hatalar

  • cover_url ve thumb_offset birlikte gönderip kareyi beklemek. Meta cover_url'i kullanır ve thumb_offset'i yok sayar.
  • thumb_offset'i saniye cinsinden vermek. Değer milisaniye sayılır; video uzunluğuna eşit ya da daha uzun bir değer 2207057 alt koduyla başarısız olur.
  • PNG kapak yüklemek. Reels kapağı en fazla 8 MB'lık bir JPEG olmalıdır.
  • Konuyu kapağın kenarına yerleştirmek. Meta görselin ortadaki 9:16'sını, Feed'de ise yalnızca ortadaki kareyi tutar.
Bunu EasyCoexistence'la yapmak

Araç cover_url ya da thumb_offset almaz; bu yüzden Reel, Instagram'ın seçtiği kareyle yayımlanır ve başka bir kapak Instagram uygulamasında seçilir. Bağlantı başına aylık US$ 9'dan US$ 0,75'e, bağlantı sayısı arttıkça düşen fiyatla; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Reel için API üzerinden özel kapak yükleyebilir miyim?

Evet. Reel'in container'ını oluştururken, en fazla 8 MB'lık bir JPEG'in herkese açık adresini cover_url ile gönderin.

Reel kapağı sRGB olmak zorunda mı?

Olmalıdır. Meta'nın teknik özellikleri sRGB ister ve diğer renk uzaylarındaki görselleri dönüştürür; kapak ayrıca en fazla 8 MB'lık bir JPEG olmalıdır.

Instagram Reel'inde 2207057 hatası ne anlama gelir?

Reel'in thumb_offset değeri aralık dışındadır; 1 hata kodu altında değer en az 0 ve videonun süresinden küçük olmalı, milisaniye cinsinden sayılmalıdır. Yani 5. saniye için 5000 yazılır.

cover_url ve thumb_offset birlikte gönderirsem ne olur?

Meta, cover_url görselini kullanır ve thumb_offset'i yok sayar.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi