Video Indexer API ile çalışmaya başlarken

Geçtiğimiz aylarda Microsoft Bilişsel Hizmetler’in bir parçası olarak Video Indexer’in önizlemesini duyurmuştuk. Video Indexer, dijital ve sesli içerik kullanan müşterilerin meta verileri otomatik olarak alıp, akıllı yeni uygulamalar geliştirmekte kullanmalarını mümkün kılıyor. Video Indexer’e https://vi.microsoft.com/ sayfasında kolayca kaydolur, önizleme döneminde bu hizmeti ücretsiz olarak deneyebilirsiniz.

Portaldan yararlanmanın yanı sıra geliştiriciler Video Indexer API’ını kullanarak kolayca özelleştirilmiş uygulamalar da oluşturabilirler. Bu blog yazısında size bir anahtar sözcük, tümcecik arama ya da hesabınızdaki tüm videolarda ve örnek videolarda bir kişi adını algılama, ardından arama sonuçlarında gelen videolardan birinden derin öngörü edinme için Video Indexer API kullanımının bir örneğini göstereceğim.

Video Indexer API’ına erişim

Video Indexer API ile çalışmaya başlamak için bir Microsoft, Google veya Azure Active Directory hesabıyla oturum açmanız gerekir. Tercih ettiğiniz hesapla oturum açtıktan sonra Video Indexer API’si ücretsiz önizlemesine kolayca kaydolabilirsiniz. Aşağıda erişim için kayıt sürecinde atılacak adımları bulacaksınız.

API’a kaydolmak için Products sekmesine gidin ve Free Preview’yu tıklayın. Sonraki sayfada Subscribe düğmesini tıklayın. Bunları tamamladığınızda API’ya erişiminizin olması gerekir. Erişiminizin olmadığını görürseniz, visupport@microsoft.com ile iletişime geçin.

Erişim sağladıktan sonra yeniden Products sekmesine dönüp, Video Indexer APIs – Production bağlantısına gidin.

Şimdi Video Indexer API dokümantasyon sayfasını görmeniz gerekir. Sayfanın sol tarafında birkaç eylem seçeneğini içeren bir liste göreceksiniz. Her eylem sayfası, hangi parametrelerin opsiyonel ya da zorunlu olduğu gibi, o istek için geçerli bilgileri içerir. Bunlardan herhangi birini test etmek isterseniz Try it’i tıklayın, uygun parametreleri ayarladıktan sonra Send’e basın.

API’yı test ederken Postman gibi bir dış araç kullanmak için Video Indexer API’ları – Production Swagger .json dosyasını indirmeniz gerekir. Bunun için sayfanın sağ üst köşesindeki API definition indirme düğmesini tıklayın, Swagger .json dosyasını almak için Open API’yı seçin. Sonraki bölümde kullanmak için dosyayı makinenizde yerel bir konuma kaydedin.

Burada, API’yı test etmek için Postman’ın nasıl kullanıldığını göstereceğim. İzleyebilmek için Postman’ı buradan indirip yükleyebilirsiniz. Postman’ı başlatın ve sol üstteki Import seçeneğini tıklayın.

İndirip yerel konuma kaydettiğiniz Video Indexer API’ları – Production Swagger .json dosyasına giderek dosyayı seçin.

Şimdi Collections altında API eylemlerini görmeniz gerekir.

Eylemlerin herhangi birine çağrı göndermek için, aboneliğinize özel belirli bir anahtara ihtiyacınız var. Bu anahtarı bulmak için yeniden Video Indexer APIs – Production sayfasına dönüp, Try it’i tıklayın. Sonraki sayfaya geçtiğinde, aşağıdaki Headers bölümüne kaydırıp, Ocp-Apim-Subscription-Key yazısını bulun. Göz simgesine tıkladığınızda anahtarınızı göreceksiniz.

Hem anahtar adını (Ocp-Apim-Subscription-Key) hem anahtarın kendisini kopyalayın; Postman için ikisine de ihtiyacınız olacak.

Tüm Videolarda Arama Çağrısı Yürütme

Postman’a dönüp, test etmek istediğiniz eylem çağrısına gidin. Bu örnekte arama ile başlayacağız; bu, API ile tipik bir kullanıcı etkileşimi olacak. Tam olarak, hesabınızdaki tüm genele açık videolar ve örnek videolarda anahtar sözcükle bir arama gösteriyoruz. Arama, istek URL’si ile yapılan bir HTTP GET çağrısıdır https://videobreakdown.azure-api.net/Breakdowns/Api/Partner/Breakdowns/Search

Headers’a gidin, key yazan yere anahtar adını (Ocp-Apim-Subscription-Key), value yazan yere anahtarın kendisini girin. Her seferinde yeniden girmemek için Postman’da anahtarı ve değeri Header Preset olarak belirleyebilirsiniz. Bunu yapmaya değer; çünkü hem zamandan kazandırır hem de ayarlaması kolaydır!

Eylemin parametrelerini ayarlamak için Params’a tıklayarak ayarlamak istediğiniz parametrelerin değerlerini belirleyin. Değişmeyen parametreleri kaldırmak için parametrenin sağ köşesine gidip x’i seçin.

Bu arama örneğinde dili “English” ve searchInPublicAccount değerini “true” olarak belirliyorum. Ayrıca değiştirmediğim bütün parametreleri temizliyorum. Sorgu için, tüm videolarda aratmak istediğiniz sözcüğü girin. Bu örnekte, “Azure” anahtar sözcüğünü aratalım.

Send’e bastığınızda, aramanın sonuçlarıyla birlikte bir JSON yanıtı alacaksınız.

Aramanın JSON yanıtı, sorgu teriminizi içeren videoları ve sonuçlardaki her bir videonun ilgili zaman aralıklarını döndüren bir results bölümünü içerir. Bu bölüm, her bir öğesinin bir sonuç videosu olduğu; ayrıca temel bilgiler, sosyal beğenmeler, görüntülenme sayısı ve başlama saatleriyle birlikte arama eşleştirmelerinin yer aldığı bir dizidir.

Aşağıda aramanın JSON yanıtında görmeyi bekleyebileceklerinizden bazılarının özetini bulacaksınız.

Arama için JSON Yanıtı

  • Sonuçlar (Dizi – her bir öğe aşağıdaki bilgileri içerir)
    • Temel video ve kullanıcı bilgileri
      • accountId
      • id
      • name
      • description
      • userName
      • createTime
      • privacyMode
      • state
    • social
      • likes
      • views
    • searchMatches (Dizi – her bir öğe aşağıdaki bilgileri içerir)
      • startTime
      • type (eşleşmenin ses tabanlı çevriyazıdan mı yoksa OCR’dan mı geldiğini kullanıcıya gösterir)
      • text

Bunu, hesabınıza kendinize ait birkaç video yükleyip, işleyerek de test etmeniz gerekir. Oturumunuz açıksa bunu Video Indexer Preview sitesinde ya da Postman’da Video Indexer API’ından gelen Upload HTTP POST çağrısını kullanarak yapabilirsiniz. Yalnız kendi hesabınızdaki videolarda aratmak için arama isteklerinizi searchInPublicAccount için “false” yapın. Sorgu için sizin videolarınıza daha uygun bir anahtar sözcük belirleyin; gizliliği videonuzun ayarlarına göre “Genel” ya da “Özel” olarak ayarlayın.

Şimdi, bir aramanın sonuçlarını alıp, o videodan genişletilmiş öngörü çıkarmayı göstereceğim.

Bir Videoda Döküm Çağrısı Yürütme

Aramanızda dönen ilk sonucun id’sini alın.

Şimdi döküm eylemine gidin. Döküm, istek URL’si ile yapılan HTTP GET çağrısıdır https://videobreakdown.azure-api.net/Breakdowns/Api/Partner/Breakdowns/:id

Abonelik anahtar adını ve anahtarınızı bir daha girmeniz gerekecektir. Ayarlarınızı anahtarınızla önceden tanımladıysanız yalnızca seçmeniz yeterlidir.

Params düğmesine tıklayıp, id parametresi için arama sonucunda gelen id’yi girin. Döküm dilini “English” olarak belirleyip, Send’e tıklayın.

Şimdi döküm isteği için JSON yanıtını görmeniz gerekir.

Döküm için gelen JSON yanıtı videoya ve videoyu yükleyen hesaba dair genel bilgileri, ayrıca summarizedInsightsbreakdowns ve social adlı üç bölümü içerir.

summarizedInsights bölümünde videodaki yüzler, konular ve ses efektlerine dair ayrı ayrı derlenmiş bilgiler, yanı sıra her birinin göründüğü farklı zaman aralıkları yer alır. Bu bölüm ayrıca tüm video için olumlu, olumsuz, nötr duyarlılık bilgilerini ve her birinin zaman aralığını verir.

Breakdowns bölümü, summarizedInsights’ın daha genişletilmiş bir sürümüdür. Burada çeviriyazı bloklarını, ses efektleri kategorilerini ve içerik denetimi sağlayan bilgileri bulacaksınız. breakdowns bölümü ayrıca videodaki konular, yüzler ve ses katılımcıları hakkında daha fazla bilgi sağlar.

breakdowns içindeki transcriptBlocks bölümü videonun zaman çizelgesi görevini görür. Her bir zaman bloku için satırlar, OCR, yüzler gibi bilgileri bulacaksınız. social bölümü, beğenmeler ve görüntüleme sayısı hakkında bilgi verir.

Aşağıda dökümün JSON yanıtında görmeyi bekleyebileceklerinizden bazılarının özetini bulacaksınız.

Döküm için JSON Yanıtı

  • Temel video ve kullanıcı bilgileri
    • Bu bölüm, videonun adı, sahibi, kimliği gibi bilgileri kapsamlı olarak verir.
  • summarizedInsights
    • faces
    • topics
    • sentiments
    • audio effects
  • breakdowns
    • video hakkında genel bilgi
      • accountID
      • id
      • state
      • processingProgress
      • externalURL
    • insights
      • trancsriptBlocks
      • topics
      • faces
      • contentModeration
      • audioEffectsCategories
    • social
      • likes
      • views

Döküm için JSON yanıtı hakkında daha fazla bilgiyi burada bulabilirsiniz.

Şimdi elinizde veriler var, artık videolarınız hakkında daha fazla öngörüye sahip olma yolunda ilerliyorsunuz; daha fazla yenilik yapma fırsatınız var. Kendi içeriklerinizle birkaç örnek daha deneyin!

Daha fazla bilgi için lütfen Video Indexer Documentation’a bakın.

Video Indexer hakkında güncel haberleri almak için bizi Twitter’dan (@Video_Indexer) izleyin.

Sorularınız ya da yardıma ihtiyacınız olursa, bize visupport@microsoft.com adresinden ulaşabilirsiniz.