Aracılığıyla paylaş

Azure AI Video Indexer API'siyle Dil modelini özelleştirme

  • Makale

Ö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, altyapının uyum sağlamasını istediğiniz etki alanından uyarlama metni (yani etki alanından metin) yükleyerek konuşma tanımayı özelleştirmek için özel Dil modelleri oluşturmanıza olanak tanır. Modelinizi eğittikten sonra uyarlama metninde görünen yeni sözcükler tanınacaktır.

Özel Dil modelleri için ayrıntılı bir genel bakış ve en iyi yöntemler için bkz . Azure AI Video Indexer ile Dil modelini özelleştirme.

Bu makalede açıklandığı gibi, hesabınızda özel Dil modelleri oluşturmak ve düzenlemek için Azure AI Video Indexer API'lerini kullanabilirsiniz. Azure AI Video Indexer web sitesini kullanarak Dil modelini özelleştirme bölümünde açıklandığı gibi web sitesini de kullanabilirsiniz.

Dil modeli oluşturma

Dil modeli oluşturma API'si, belirtilen hesapta yeni bir özel Dil modeli oluşturur. Bu çağrıda Dil modeli için dosyaları karşıya yükleyebilirsiniz. Alternatif olarak, dil modelini burada oluşturabilir ve daha sonra Dil modelini güncelleştirerek modelin dosyalarını karşıya yükleyebilirsiniz.

Not

Dosyalarının içeriğini öğrenmek için modeli etkinleştirilmiş dosyalarıyla eğitmeye devam etmeniz gerekir. Bir dili eğiterek ilgili yönergeler sonraki bölümde yer almaktadır.

Dil modeline eklenecek dosyaları karşıya yüklemek için, yukarıdaki gerekli parametreler için değer sağlamaya ek olarak FormData kullanarak gövdeye dosya yüklemeniz gerekir. Bu görevi gerçekleştirmenin iki yolu vardır:

  • Anahtar, dosya adıdır ve değer txt dosyasıdır.
  • Anahtar, dosya adıdır ve değer txt dosyasının URL'sidir.

Response

Yanıt, bu örnek JSON çıktısının biçimini izleyerek modelin dosyalarının her birinde meta verilerle birlikte yeni oluşturulan Dil modeline ilişkin meta veriler sağlar:

{
    "id": "dfae5745-6f1d-4edd-b224-42e1ab57a891",
    "name": "TestModel",
    "language": "En-US",
    "state": "None",
    "languageModelId": "00000000-0000-0000-0000-000000000000",
    "files": [
    {
        "id": "25be7c0e-b6a6-4f48-b981-497e920a0bc9",
        "name": "hellofile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-28T11:55:34.6733333"
    },
    {
        "id": "33025f5b-2354-485e-a50c-4e6b76345ca7",
        "name": "worldfile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-28T11:55:34.86"
    }
    ]
}

Dil modelini eğitin

Dil modeli eğit api'si, belirtilen hesapta dil modelinde karşıya yüklenen ve etkinleştirilen dosyalardaki içeriklerle özel bir Dil modeli eğiter.

Not

Önce Dil modelini oluşturmanız ve dosyalarını karşıya yüklemeniz gerekir. Dil modelini oluştururken veya Dil modelini güncelleştirerek dosyaları karşıya yükleyebilirsiniz.

Response

Yanıt, bu örnek JSON çıktısının biçimini izleyerek modelin dosyalarının her birinde meta verilerin yanı sıra yeni eğitilen Dil modelinde meta veriler sağlar:

{
    "id": "41464adf-e432-42b1-8e09-f52905d7e29d",
    "name": "TestModel",
    "language": "En-US",
    "state": "Waiting",
    "languageModelId": "531e5745-681d-4e1d-b124-12e5ab57a891",
    "files": [
    {
        "id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
        "name": "RenamedFile",
        "enable": false,
        "creator": "John Doe",
        "creationTime": "2018-04-27T20:10:10.5233333"
    },
    {
        "id": "9ac35b4b-1381-49c4-9fe4-8234bfdd0f50",
        "name": "hellofile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-27T20:10:10.68"
    }
    ]
}

Döndürülenid, dil modellerini ayırt etmek için kullanılan benzersiz bir kimlikken, languageModelId hem dizine video yüklemek hem de video API'lerini yeniden dizine almak için kullanılır (Azure AI Video Indexer karşıya yükleme/reindex API'lerinde de bilinirlinguisticModelId).

Dil modelini silme

Dil modeli silme API'si, belirtilen hesaptan özel bir Dil modelini siler. Silinen Dil modelini kullanan tüm videolar, siz videoyu yeniden dizinleyene kadar aynı dizini tutar. Videoyu yeniden dizine eklerseniz videoya yeni bir Dil modeli atayabilirsiniz. Aksi takdirde Azure AI Video Indexer, videoyu yeniden dizine almak için varsayılan modelini kullanır.

Response

Dil modeli başarıyla silindiğinde döndürülen içerik yoktur.

Dil modelini güncelleştirme

Dil modeli API'sini güncelleştirme, belirtilen hesaptaki özel bir Dil kişisi modelini güncelleştirir.

Not

Dil modelini zaten oluşturmuş olmanız gerekir. Model altındaki tüm dosyaları etkinleştirmek veya devre dışı bırakmak, Dil modelinin adını güncelleştirmek ve dil modeline eklenecek dosyaları karşıya yüklemek için bu çağrıyı kullanabilirsiniz.

Dil modeline eklenecek dosyaları karşıya yüklemek için, yukarıdaki gerekli parametreler için değer sağlamaya ek olarak FormData kullanarak gövdeye dosya yüklemeniz gerekir. Bu görevi gerçekleştirmenin iki yolu vardır:

  • Anahtar, dosya adıdır ve değer txt dosyasıdır.
  • Anahtar, dosya adıdır ve değer txt dosyasının URL'sidir.

Response

Yanıt, bu örnek JSON çıktısının biçimini izleyerek modelin dosyalarının her birinde meta verilerin yanı sıra yeni eğitilen Dil modelinde meta veriler sağlar:

{
    "id": "41464adf-e432-42b1-8e09-f52905d7e29d",
    "name": "TestModel",
    "language": "En-US",
    "state": "Waiting",
    "languageModelId": "531e5745-681d-4e1d-b124-12e5ab57a891",
    "files": [
    {
        "id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
        "name": "RenamedFile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-27T20:10:10.5233333"
    },
    {
        "id": "9ac35b4b-1381-49c4-9fe4-8234bfdd0f50",
        "name": "hellofile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-27T20:10:10.68"
    }
    ]
}

id Dosyanın içeriğini indirmek için yanıtta döndürülen dosyaların öğesini kullanın.

Dil modelinden dosya güncelleştirme

Bir dosyayı güncelleştirme, belirtilen hesaptaki özel dil modelindeki bir dosyanın adını ve enable durumunu güncelleştirmenize olanak tanır.

Response

Yanıt, aşağıdaki örnek JSON çıktısının biçimini izleyerek güncelleştirdiğiniz dosyada meta veriler sağlar.

{
  "id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
  "name": "RenamedFile",
  "enable": false,
  "creator": "John Doe",
  "creationTime": "2018-04-27T20:10:10.5233333"
}

id Yanıtta döndürülen dosyanın içeriğini indirmek için dosyasını kullanın.

Belirli bir Dil modelini alma

Get API'si belirtilen hesapta belirtilen Dil modeliyle ilgili dil ve Dil modelindeki dosyalar gibi bilgileri döndürür.

Response

Yanıt, bu örnek JSON çıktısının biçimini izleyerek modelin dosyalarının her birinde meta verilerle birlikte belirtilen Dil modelinde meta veriler sağlar:

{
    "id": "dfae5745-6f1d-4edd-b224-42e1ab57a891",
    "name": "TestModel",
    "language": "En-US",
    "state": "None",
    "languageModelId": "00000000-0000-0000-0000-000000000000",
    "files": [
    {
        "id": "25be7c0e-b6a6-4f48-b981-497e920a0bc9",
        "name": "hellofile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-28T11:55:34.6733333"
    },
    {
        "id": "33025f5b-2354-485e-a50c-4e6b76345ca7",
        "name": "worldfile",
        "enable": true,
        "creator": "John Doe",
        "creationTime": "2018-04-28T11:55:34.86"
    }
    ]
}

id Yanıtta döndürülen dosyanın içeriğini indirmek için dosyasını kullanın.

Tüm Dil modellerini edinin

Tüm API'yi al, listedeki belirtilen hesaptaki tüm özel Dil modellerini döndürür.

Response

Yanıt, hesabınızdaki tüm Dil modellerinin ve bu örnek JSON çıkışının biçimini izleyen meta verilerinin ve dosyalarının listesini sağlar:

[
    {
        "id": "dfae5745-6f1d-4edd-b224-42e1ab57a891",
        "name": "TestModel",
        "language": "En-US",
        "state": "None",
        "languageModelId": "00000000-0000-0000-0000-000000000000",
        "files": [
        {
            "id": "25be7c0e-b6a6-4f48-b981-497e920a0bc9",
            "name": "hellofile",
            "enable": true,
            "creator": "John Doe",
            "creationTime": "2018-04-28T11:55:34.6733333"
        },
        {
            "id": "33025f5b-2354-485e-a50c-4e6b76345ca7",
            "name": "worldfile",
            "enable": true,
            "creator": "John Doe",
            "creationTime": "2018-04-28T11:55:34.86"
        }
        ]
    },
    {
        "id": "dfae5745-6f1d-4edd-b224-42e1ab57a892",
        "name": "AnotherTestModel",
        "language": "En-US",
        "state": "None",
        "languageModelId": "00000000-0000-0000-0000-000000000001",
        "files": []
    }
]

Dil modelinden dosya silme

Silme API'si belirtilen hesabın belirtilen Dil modelinden belirtilen dosyayı siler.

Response

Dosya Dil modelinden başarıyla silindiğinde döndürülen içerik yoktur.

Dil modelinden dosya üzerinde meta veri alma

Dosya API'sinin get meta verileri, hesabınızda seçilen Dil modelinden belirtilen dosyadaki ve meta verilerinin içeriğini döndürür.

Response

Yanıt, dosyanın içeriğini ve meta verilerini şu örneğe benzer şekilde JSON biçiminde sağlar:

{
    "content": "hello\r\nworld",
    "id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
    "name": "Hello",
    "enable": true,
    "creator": "John Doe",
    "creationTime": "2018-04-27T20:10:10.5233333"
}

Not

Bu örnek dosyanın içeriği, iki ayrı satırda "merhaba" ve dünya" sözcükleridir.

Dil modelinden dosya indirme

Dosya indirme API'si, belirtilen hesaptaki belirtilen Dil modelinden belirtilen dosyanın içeriğini içeren bir metin dosyası indirir. Bu metin dosyası, başlangıçta karşıya yüklenen metin dosyasının içeriğiyle eşleşmelidir.

Response

Yanıt, dosyanın içeriğini JSON biçiminde içeren bir metin dosyasının indirilmesidir.