Hızlı Başlangıç: API'yi kullanma

Önemli

Azure Media Services kullanımdan kaldırma duyurusu nedeniyle Azure AI Video Indexer, Azure AI Video Indexer özelliklerinde yapılan ayarlamaları duyurur. Bunun Azure AI Video Indexer hesabınız için ne anlama geldiğini anlamak için bkz . Azure Media Service 'in (AMS) kullanımdan kaldırılmasıyla ilgili değişiklikler. AMS'yi kullanımdan kaldırmaya hazırlanma: VI güncelleştirme ve geçiş kılavuzuna bakın.

Azure AI Video Indexer, Microsoft tarafından sunulan çeşitli ses ve video yapay zeka (AI) teknolojilerini tek bir tümleşik hizmette birleştirerek geliştirmeyi kolaylaştırır. Azure AI Video Indexer, geliştiricilerin bulut platformlarının ölçeği, küresel erişimi, kullanılabilirliği ve güvenilirliği konusunda endişelenmeden medya yapay zeka teknolojilerini kullanmaya odaklanmasını sağlamak için tasarlanmıştır. DOSYALARıNıZı karşıya yüklemek, ayrıntılı video içgörüleri almak, eklenebilir içgörülerin URL'lerini, oynatıcı pencere öğelerini ve daha fazlasını almak için API'yi kullanabilirsiniz.

Azure AI Video Indexer web sitesini ilk kez ziyaret ettiğinizde, sizin için otomatik olarak bir deneme hesabı oluşturulur. Deneme hesabıyla, bazı ücretsiz dizin oluşturma dakikaları alırsınız. Daha sonra ücretli bir hesap ekleyebilirsiniz. Ücretli seçenekle, dizine alınan dakikalar için ödeme alırsınız. Kullanılabilir hesaplar (deneme ve ücretli seçenekler) hakkında ayrıntılı bilgi için bkz . Azure AI Video Indexer hesap türleri.

Bu makalede Azure AI Video Indexer API'sinin nasıl kullanılacağı gösterilmektedir.

Önkoşullar

Medya dosyasını karşıya yükleyin. bunun iki yolu vardır:

1. Seçtiğiniz URL'ye bir medya dosyası yükleyin (önerilen). Genel ağ konumu kullanabilirsiniz. Dosyayı karşıya yükledikten sonra, dosyayı kopyalayıp tarayıcınızın konum çubuğuna yapıştırarak AVI'nin erişip erişemeyeceğini de kontrol edebilirsiniz. Medya dosyasını yürütebiliyorsanız vi de bu dosyaya erişebilir. Azure Depolama Blobu kullanarak depolama konumunun güvenliğini sağlamak istiyorsanız dosyayı karşıya yükleyin ve bir SAS URL'si alın. Dosyanız için güvenli bir URL alma hakkında daha fazla bilgi için bkz. SAS URL'lerini Azure Blob Depolama. Bu URL, dosyanızı dizin oluşturmak üzere Azure AI Video Indexer'a kopyalamak için kullanılır.

2. Video dosyasına istek gövdesinde bir bayt dizisi gönderin. Bir medya dosyasını istek gövdesine bayt dizisi olarak yükleme hakkında daha fazla bilgi için bkz . .NET ile blob yükleme.

Not

Saniyede 10 istek ve dakikada en fazla 120 istek içeren bir API isteği sınırı vardır.

API'ye abone olma

Önemli

• Azure AI Video Indexer'a kaydolduğunda kullandığınız e-postanın aynısını kullanmanız gerekir.
• Kişisel Google ve Microsoft (Outlook/Live) hesapları yalnızca deneme hesapları için kullanılabilir. Azure'a bağlı hesaplar Için Entra Kimliği gerekir.
• E-posta başına yalnızca bir etkin hesap olabilir. Bir kullanıcı LinkedIn için ve daha sonra Google için ile user@gmail.comuser@gmail.com oturum açmaya çalışırsa, ikinci kullanıcı kullanıcının zaten var olduğunu belirten bir hata sayfası görüntüler.
• Anahtarlar korunmalıdır. Anahtarlar yalnızca sunucu kodunuz tarafından kullanılmalıdır. İstemci tarafında (.js, .html vb.) kullanılamamalıdır.

1. Azure AI Video Indexer API geliştirici portalındaoturum açın.
2. Ürünler sekmesini seçerek abone olun. Ardından Yetkilendirme'yi seçin ve abone olun. Yeni kullanıcılar otomatik olarak Yetkilendirme’ye abone edilir.
3. Birincil ve ikincil anahtarları bulun, kopyalayın ve kaydedin. Aboneliğinizi Profilinizde bulabilirsiniz. Birincil ve ikincil anahtarlar Abonelikler bölümündedir.
4. Hem Birincil anahtar hem de İkincil anahtar için Göster bağlantısını seçin. Ortam değişkenleri dosyanızda kullanmaya hazır olana kadar bunları kopyalayıp bir metin düzenleyicisine yapıştırın.

Yetkilendirme API'sini kullanarak erişim belirteci alma

Uygulamanız için her kullanıcıya tam erişim vermek istemezsiniz. VI için çeşitli erişim düzeyleri vardır.

Level	Videoları görüntüleme	Videoları işleme	Projeleri görüntüleme	Projeleri işleme	Hesapları görüntüleme	Hesapları yönetme
Video Okuyucu	✔️
Video Katkıda Bulunanı	✔️	✔️
Proje Okuyucusu	✔️		✔️
Proje Katılımcısı	✔️	✔️	✔️	✔️
Hesap Okuyucusu	✔️		✔️		✔️
Hesap Katkıda Bulunanı	✔️	✔️	✔️	✔️	✔️	✔️

Erişim belirteci isteği oluşturma ve gönderme

İstekteki subscription-id, resource-group-name, vi account-name değerini ve istek gövdesindeki ve permissionType parametresini ihtiyacınız olan erişim düzeyine ayarlayınscope.

Örneğin, bir kullanıcıya projelerle çalışabilmesi ama hesaplarla çalışamaması için erişim sağlamak istiyorsanız, "Katkıda Bulunan" ve scope "Proje" olarak ayarlayınpermissionType. Eğer bir proje için izinleri ayarlarsa, belirtinprojectId.

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.VideoIndexer/accounts/{account-name}/generateAccessToken?api-version=2024-01-01

{
  "permissionType": "Reader",
  "scope": "Project",
  "projectId": "07ec9e38d4"
}

Örnek yanıt

{
  "accessToken": "<jwt token of 1260 characters length>"
}

Kapsam ve izin türlerini ayarlama hakkında daha fazla örnek için vi REST API'sine bakın.

API’yi kullanmaya başlayın

API'yi kullanmaya başlamaya hazırsınız. Her Azure AI Video Indexer REST API'sinin ayrıntılı açıklamasını bulun.

Ortam değişken dosyanızdaki anahtarları kullanma ve erişim belirteçlerini kullanma hakkında ayrıntılı bir örnek için Bkz. Azure AI Video Indexer örneği.

Öneriler

• Belirtilen video için video içgörüleri alan API’yi çağırdığınızda yanıt içeriği olarak ayrıntılı bir JSON çıktısını alırsınız. Bu makalede döndürülen JSON hakkındaki ayrıntılara bakın.
• API tarafından üretilen JSON çıkışı ve SummarizedInsights öğelerini içerirInsights. Kullanmanızı ve kullanmamanızı SummarizedInsights kesinlikle öneririz Insights (geriye dönük uyumluluk için mevcuttur).
• Üretim amacıyla doğrudan artifacts klasöründeki verileri kullanmanızı önermiyoruz. Yapıtlar, dizin oluşturma işleminin ara çıkışlarıdır ve videoları analiz eden çeşitli yapay zeka altyapılarının ham çıkışlarıdır. Yapıt şeması zaman içinde değişebilir.
• Get-Video-Artifact-Download-Url yerineAPI tarafından üretilen içgörüleri ve yapıtları alma bölümünde açıklandığı gibi Video Dizini Al API'sinikullanın.