Instagram Reels'i API ile yayımlamak
Instagram API'si bir Reel'i herkese açık bir URL'deki MOV ya da MP4 dosyasından yayımlar: media_type değeri REELS olan bir konteyner oluşturun, Meta videoyu işlerken bekleyin, ardından yayımlayın. Bir Reel 3 saniyeden 15 dakikaya ve 300 MB'a kadar olabilir; Meta, kırpılmayı ve boş alanı önlemek için 9:16 çerçeveyi önerir.
easyCoexistence, Reels'i Claude, ChatGPT ya da kendi kodunuzdan publish_instagram_post ile yayımlar: ona video URL'sini ve açıklamayı verin; video hâlâ işlenirken yayımlamayı kendi başına tamamlar.
API'nin yayımladığı en uzun Reel; en kısası 3 saniyedir.
En büyük Reel dosyası: H.264 ya da HEVC video ve AAC ses içeren MOV ya da MP4.
Meta'nın bir işleme konteynerinin durumunu kontrol etmenizi önerdiği aralık; en fazla 5 dakika.
Bir Reel konteynerinin, sona ermeden önce yayımlanmadan ne kadar bekleyebileceği.
Bir Reel nasıl yayımlanır?
Üç adımda. Önce POST /<IG_ID>/media isteğini gönderin; media_type alanını REELS, video_url alanını dosyaya işaret eden URL olarak ayarlayın ve isterseniz caption parametresini ekleyin. Meta videoyu alır ve bir konteyner ID'si döndürür. İkinci olarak, Instagram videoyu işlerken konteynerin status_code alanını kontrol ederek bekleyin. Üçüncü olarak, creation_id alanı konteyner ID'sine ayarlanmış şekilde POST /<IG_ID>/media_publish çağrısı yapın; yanıt yeni medya ID'sini içerir.
Meta, yeniden başlatılabilir yüklemeyi yalnızca Unified Login dahil Facebook Login for Business ile kurulan kurulumlar için belgelenmiş olarak sunar; bu yükleme dosyayı bilgisayardan gönderebilir. Instagram Login ile video her zaman herkese açık bir URL'den gelir.
Video gereksinimleri nelerdir?
Instagram'ın bir dosyayı işlemeden önce karşılaması gereken Meta belirtimi:
- Konteyner: MOV ya da MP4 (MPEG-4 Part 14), düzenleme listesi yok, moov atomu dosyanın başında.
- Video: H.264 ya da HEVC, progressive tarama, closed GOP, 4:2:0 chroma subsampling, saniyede 23 ila 60 kare, en fazla 1920 piksel genişlik ve 25 Mbps.
- Ses: AAC, en fazla 48 kHz, mono ya da stereo, 128 kbps.
- En-boy oranı: 0,01:1 ile 10:1 arasındaki herhangi bir oran; 9:16 önerilir.
- Süre ve boyut: 3 saniyeden 15 dakikaya, en fazla 300 MB.
İşleme sırasında ne olur?
Konteynerin status_code alanı, Instagram videoyu işleyene kadar IN_PROGRESS değerini gösterir; ardından FINISHED olur ve ancak o zaman yayımlanabilir. Erken yayımlama denemesi 9007 hata kodu, 2207027 alt koduyla başarısız olur; bu, düzeltmek değil beklemek anlamına gelir. Meta, durumu en fazla 5 dakika boyunca dakikada bir kontrol etmenizi öneriyor.
ERROR, konteynerin işlemeyi tamamlayamadığı anlamına gelir; EXPIRED, konteynerin 24 saat boyunca yayımlanmadan beklediği anlamına gelir; her ikisinde de yeni bir konteyner gerekir. PUBLISHED, Reel'in zaten yayında olduğu anlamına gelir.
Reel için hangi seçenekler var?
Video ve açıklamanın yanı sıra Meta'nın Reel konteyneri şu parametreleri alır:
share_to_feed: true, Reel'in Reels sekmesinin yanı sıra Feed'de de görünmesini sağlar; false ise yalnızca Reels sekmesinde tutar. Hiçbir değer Reels sekmesinde yer garantilemez.cover_url: Reels sekmesinde kapak olarak kullanılan, en fazla 8 MB boyutunda bir JPEG; ortadan 9:16 olarak kırpılır ve Feed'de paylaşıldığında kare olur.thumb_offset: Kapak yoksa küçük resim olarak kullanılan kare, milisaniye cinsinden; 0 ilk karedir.audio_name: Reel'in sesi için bir ad; yalnızca bir kez ayarlanabilir.trial_params: Bir deneme Reel'i yayımlar; bu Reel, asıl yayına geçene kadar hesabı takip etmeyen kişilerle paylaşılır.
Bir Reel'e başka hangi kurallar uygulanır?
Konteyner oluşturulduğu andan itibaren bir Reel'e birkaç kural uygulanır.
- Bir Reel karusel öğesi olamaz; her zaman tek başına yayımlanır.
- Hesabın gizlilik ayarları yayımlama anında uygulanır: Remix'e izin ver açıksa yeni Reel de remix'e izin verir.
- Müzik etiketleme yalnızca özgün ses için kullanılabilir.
- Daha sonra okunduğunda Reel, diğer tüm videolar gibi
media_typeVIDEO olarak görünür. - Hesabın 24 saat içinde API ile yayımlanan 100 gönderisinden biri sayılır.
Bir Reel hangi metrikleri raporlar?
Medya içgörüleri uç noktası üzerinden bir Reel; reach, views, likes, comments, saved, shares, total_interactions ve reposts metriklerini raporlar. Ayrıca üç kendine özgü metrik sunar: ig_reels_avg_watch_time, ig_reels_video_view_total_time ve reels_skip_rate; bu sonuncusu, ilk 3 saniye içinde atlanan görüntülemelerin oranıdır. Likes, comments ve views metrikleri yalnızca organik etkinliği sayar ve bunların dayandığı veriler 48 saate kadar gecikebilir.
Yaygın hatalar
- Konteyner oluşturulur oluşturulmaz yayımlamak. status_code FINISHED değerini gösterene kadar bekleyin; aksi halde çağrı 2207027 alt koduyla başarısız olur.
- WebM ya da AVI dosyası yüklemek. Reels MOV ya da MP4 olmalıdır; aksi halde Meta bunları 352 hata kodu ve 2207026 alt koduyla reddeder.
- share_to_feed'in Reel'i Reels sekmesine koyacağını sanmak. Yalnızca Feed'i ekler; Reels sekmesinde ne gösterileceğine Instagram karar verir.
- Bir konteyneri gece boyunca yayımlanmadan bırakmak. Oluşturulduktan 24 saat sonra sona erer ve yayımlamak için yenisi gerekir.
Reels ayrıca kendi kuyruğundan zamanlanabilir. Bağlantı başına aylık US$ 9'dan US$ 0,75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme dahildir.
Sık sorulan sorular
Bir Reel API üzerinden ne kadar uzun olabilir?
3 saniyeden 15 dakikaya kadar; en fazla 300 MB boyutunda MOV ya da MP4 dosyası olarak.
Bir Reel'i bilgisayarımdan yükleyebilir miyim?
Instagram Login ile hayır. API videoyu herkese açık bir URL'den alır; bu yüzden dosyayı önce herkese açık bir bağlantı verecek bir yere koyun.
API ile yayımlanan bir Reel Feed'de de görünür mü?
Görünebilir. share_to_feed parametresi, Reel'in Reels sekmesinin yanı sıra Feed'de de yer alıp almayacağını belirler.
Bir Reel yayımlanırken neden 9007 hata kodu alıyorum?
Instagram videoyu hâlâ işliyor. status_code değeri FINISHED olduğunda yayımlayın; istekte düzeltilecek bir şey yoktur.
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