Özel konuşma modeli dağıtma

  • Makale

Bu makalede, özel konuşma modeli için uç nokta dağıtmayı öğreneceksiniz. Toplu transkripsiyon dışında, özel konuşma modeli kullanmak için özel bir uç nokta dağıtmanız gerekir.

İpucu

Batch transkripsiyon API'siyle özel konuşma kullanmak için barındırılan dağıtım uç noktası gerekmez. Özel konuşma modeli yalnızca toplu transkripsiyon için kullanılıyorsa kaynakları tasarruf edebilirsiniz. Daha fazla bilgi için bkz . Konuşma hizmeti fiyatlandırması.

Temel veya özel model için uç nokta dağıtabilir ve daha sonra daha iyi eğitilmiş bir model kullanmak için uç noktayı güncelleştirebilirsiniz .

Not

Konuşma kaynakları tarafından F0 kullanılan uç noktalar yedi gün sonra silinir.

Dağıtım uç noktası ekleme

Özel uç nokta oluşturmak için şu adımları izleyin:

  1. Speech Studio'da oturum açın.

  2. Özel konuşma Projenizin adı> Modelleri dağıt'ı seçin.>

    Bu ilk uç noktanızsa tabloda listelenen uç nokta olmadığını fark edeceksiniz. Bir uç nokta oluşturduktan sonra bu sayfayı kullanarak dağıtılan her uç noktayı izlersiniz.

  3. Yeni uç nokta sihirbazını başlatmak için Modeli dağıt'ı seçin.

  4. Yeni uç nokta sayfasında, özel uç noktanız için bir ad ve açıklama girin.

  5. Uç noktayla ilişkilendirmek istediğiniz özel modeli seçin.

  6. İsteğe bağlı olarak, uç nokta trafiğinin ses ve tanılama günlüğünü etkinleştirmek için kutuyu işaretleyebilirsiniz.

    Günlüğe kaydetmeyi etkinleştirmek için onay kutusunu gösteren Yeni uç nokta sayfasının ekran görüntüsü.

  7. Uç noktayı kaydetmek ve dağıtmak için Ekle'yi seçin.

Modelleri dağıtın ana sayfasında, yeni uç noktayla ilgili ayrıntılar bir tabloda görüntülenir; örneğin ad, açıklama, durum ve son kullanma tarihi. Özel modellerinizi kullanan yeni bir uç noktanın örneğini oluşturmak 30 dakika kadar sürebilir. Dağıtımın durumu Başarılı olarak değiştiğinde uç nokta kullanıma hazırdır.

Önemli

Modelin son kullanma tarihini not alın. Bu, konuşma tanıma için özel modelinizi kullanabileceğiniz son tarihtir. Daha fazla bilgi için bkz . Model ve uç nokta yaşam döngüsü.

Uç nokta anahtarı, uç nokta URL'si ve örnek kod gibi ona özgü bilgileri görüntülemek için uç nokta bağlantısını seçin.

Uç nokta oluşturmak ve modeli dağıtmak için komutunu kullanın spx csr endpoint create . İstek parametrelerini aşağıdaki yönergelere göre oluşturun:

  • parametresini project var olan bir projenin kimliğine ayarlayın. Bu, Speech Studio'da uç noktayı da görüntüleyebilmeniz ve yönetebilmeniz için önerilir. Kullanılabilir projeleri almak için komutunu çalıştırabilirsiniz spx csr project list .
  • Gerekli model parametreyi uç noktaya dağıtılmasını istediğiniz modelin kimliğine ayarlayın.
  • Gerekli language parametreyi ayarlayın. Uç nokta yerel ayarı modelin yerel ayarıyla eşleşmelidir. Yerel ayar daha sonra değiştirilemez. Konuşma CLI language parametresi, JSON isteğindeki ve yanıttaki özelliğine karşılık gelir locale .
  • Gerekli name parametreyi ayarlayın. Bu, Speech Studio'da görüntülenen addır. Konuşma CLI name parametresi, JSON isteğindeki ve yanıttaki özelliğine karşılık gelir displayName .
  • İsteğe bağlı olarak parametresini logging ayarlayabilirsiniz. Uç nokta trafiğinin ses ve tanılama günlüğünü etkinleştirmek için bunu enabled olarak ayarlayın. Varsayılan değer: false.

Aşağıda bir uç nokta oluşturmak ve model dağıtmak için örnek bir Konuşma CLI komutu verilmişti:

spx csr endpoint create --api-version v3.1 --project YourProjectId --model YourModelId --name "My Endpoint" --description "My Endpoint Description" --language "en-US"

Aşağıdaki biçimde bir yanıt gövdesi almanız gerekir:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/d40f2eb8-1abf-4f72-9008-a5ae8add82a4"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T15:27:51Z",
  "status": "NotStarted",
  "createdDateTime": "2022-05-19T15:27:51Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

Yanıt gövdesindeki en üst düzey self özellik uç noktanın URI'sini oluşturur. Uç noktanın projesi, modeli ve günlükleriyle ilgili ayrıntıları almak için bu URI'yi kullanın. Uç noktayı güncelleştirmek için de bu URI'yi kullanırsınız.

Uç noktalarla ilgili Konuşma CLI'sı yardımı için aşağıdaki komutu çalıştırın:

spx help csr endpoint

Uç nokta oluşturmak ve modeli dağıtmak için Konuşmadan metne dönüştürme REST API'sinin Endpoints_Create işlemini kullanın. İstek gövdesini aşağıdaki yönergelere göre oluşturun:

  • project özelliğini mevcut bir projenin URI'sine ayarlayın. Bu, Speech Studio'da uç noktayı da görüntüleyebilmeniz ve yönetebilmeniz için önerilir. Kullanılabilir projeleri almak için Projects_List isteğinde bulunabilirsiniz.
  • Gerekli model özelliği uç noktaya dağıtılmasını istediğiniz modelin URI'sine ayarlayın.
  • Gerekli locale özelliği ayarlayın. Uç nokta yerel ayarı modelin yerel ayarıyla eşleşmelidir. Yerel ayar daha sonra değiştirilemez.
  • Gerekli displayName özelliği ayarlayın. Bu, Speech Studio'da görüntülenen addır.
  • İsteğe bağlı olarak, özelliğini içinde propertiesayarlayabilirsinizloggingEnabled. Uç nokta trafiğinin ses ve tanılama günlüğünü etkinleştirmek için bunu true olarak ayarlayın. Varsayılan değer: false.

Aşağıdaki Endpoints_Create örnekte gösterildiği gibi URI kullanarak bir HTTP POST isteği oluşturun. değerini Konuşma kaynak anahtarınız ile değiştirin YourSubscriptionKey , değerini Konuşma kaynağı bölgenizle değiştirin YourServiceRegion ve istek gövdesi özelliklerini daha önce açıklandığı gibi ayarlayın.

curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/d40f2eb8-1abf-4f72-9008-a5ae8add82a4"
  },
  "properties": {
    "loggingEnabled": true
  },
  "displayName": "My Endpoint",
  "description": "My Endpoint Description",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
  },
  "locale": "en-US",
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints"

Aşağıdaki biçimde bir yanıt gövdesi almanız gerekir:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/d40f2eb8-1abf-4f72-9008-a5ae8add82a4"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T15:27:51Z",
  "status": "NotStarted",
  "createdDateTime": "2022-05-19T15:27:51Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

Yanıt gövdesindeki en üst düzey self özellik uç noktanın URI'sini oluşturur. Uç noktanın projesi, modeli ve günlükleriyle ilgili ayrıntıları almak için bu URI'yi kullanın. Uç noktayı güncelleştirmek veya silmek için de bu URI'yi kullanırsınız.

Modeli değiştirme ve uç noktayı yeniden dağıtma

Uç nokta, aynı Konuşma kaynağı tarafından oluşturulan başka bir modeli kullanacak şekilde güncelleştirilebilir. Daha önce belirtildiği gibi, modelin süresi dolmadan önce uç noktanın modelini güncelleştirmeniz gerekir.

Yeni bir model kullanmak ve özel uç noktayı yeniden dağıtmak için:

  1. Speech Studio'da oturum açın.
  2. Özel konuşma Projenizin adı> Modelleri dağıt'ı seçin.>
  3. Uç nokta bağlantısını ada göre seçin ve ardından Modeli değiştir'i seçin.
  4. Uç noktanın kullanmasını istediğiniz yeni modeli seçin.
  5. Uç noktayı kaydetmek ve yeniden dağıtmak için Bitti'yi seçin.

Özel uç noktayı yeni bir modelle yeniden dağıtmak için komutunu kullanın spx csr model update . İstek parametrelerini aşağıdaki yönergelere göre oluşturun:

  • Gerekli endpoint parametreyi dağıtılmasını istediğiniz uç noktanın kimliğine ayarlayın.
  • Gerekli model parametreyi uç noktaya dağıtılmasını istediğiniz modelin kimliğine ayarlayın.

Özel uç noktayı yeni bir modelle yeniden dağıtan örnek bir Konuşma CLI komutu aşağıda verilmiştir:

spx csr endpoint update --api-version v3.1 --endpoint YourEndpointId --model YourModelId

Aşağıdaki biçimde bir yanıt gövdesi almanız gerekir:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/639d5280-8995-40cc-9329-051fd0fddd46"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T23:01:34Z",
  "status": "NotStarted",
  "createdDateTime": "2022-05-19T15:41:27Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Updated Endpoint Description"
}

Uç noktalarla ilgili Konuşma CLI'sı yardımı için aşağıdaki komutu çalıştırın:

spx help csr endpoint

Özel uç noktayı yeni bir modelle yeniden dağıtmak için Konuşmayı metne dönüştürme REST API'sinin Endpoints_Update işlemini kullanın. İstek gövdesini aşağıdaki yönergelere göre oluşturun:

  • model özelliğini uç noktaya dağıtılmasını istediğiniz modelin URI'sine ayarlayın.

Aşağıdaki örnekte gösterildiği gibi URI'yi kullanarak bir HTTP PATCH isteği oluşturun. değerini YourSubscriptionKey Konuşma kaynak anahtarınızla değiştirin, değerini YourServiceRegion Konuşma kaynağı bölgenizle değiştirin, değerini uç nokta kimliğiniz ile değiştirin YourEndpointId ve istek gövdesi özelliklerini daha önce açıklandığı gibi ayarlayın.

curl -v -X PATCH -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
  }
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/YourEndpointId"

Aşağıdaki biçimde bir yanıt gövdesi almanız gerekir:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/639d5280-8995-40cc-9329-051fd0fddd46"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T23:01:34Z",
  "status": "NotStarted",
  "createdDateTime": "2022-05-19T15:41:27Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Updated Endpoint Description"
}

Yeniden dağıtma işleminin tamamlanması birkaç dakika sürer. Bu arada uç noktanız hizmet kesintisi olmadan önceki modeli kullanır.

Günlük verilerini görüntüleme

Günlük verileri, uç noktayı oluştururken yapılandırdıysanız dışarı aktarılabilir.

Uç nokta günlüklerini indirmek için:

  1. Speech Studio'da oturum açın.
  2. Özel konuşma Projenizin adı> Modelleri dağıt'ı seçin.>
  3. Uç nokta adına göre bağlantıyı seçin.
  4. İçerik günlüğü altında Günlüğü indir'i seçin.

Bir uç noktanın günlüklerini almak için komutunu kullanın spx csr endpoint list . İstek parametrelerini aşağıdaki yönergelere göre oluşturun:

  • Gerekli endpoint parametreyi günlükleri almak istediğiniz uç noktanın kimliğine ayarlayın.

Bir uç noktanın günlüklerini alan örnek bir Konuşma CLI komutu aşağıda verilmişti:

spx csr endpoint list --api-version v3.1 --endpoint YourEndpointId

Her günlük dosyasının daha fazla ayrıntı içeren konumları yanıt gövdesinde döndürülür.

Bir uç noktanın günlüklerini almak için konuşmayı metne dönüştürme REST API'sinin Endpoints_Get işlemini kullanarak başlayın.

Aşağıdaki örnekte gösterildiği gibi URI'yi kullanarak bir HTTP GET isteği oluşturun. değerini YourEndpointId uç nokta kimliğiniz ile değiştirin, değerini YourSubscriptionKey Konuşma kaynak anahtarınızla değiştirin ve yerine YourServiceRegion Konuşma kaynağı bölgenizi yazın.

curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/YourEndpointId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"

Aşağıdaki biçimde bir yanıt gövdesi almanız gerekir:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/2f78cdb7-58ac-4bd9-9bc6-170e31483b26"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T23:41:05Z",
  "status": "Succeeded",
  "createdDateTime": "2022-05-19T23:41:05Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Updated Endpoint Description"
}

Önceki yanıt gövdesinden "günlükler" URI'sini kullanarak bir HTTP GET isteği oluşturun. değerini YourEndpointId uç nokta kimliğiniz ile değiştirin, değerini YourSubscriptionKey Konuşma kaynak anahtarınızla değiştirin ve yerine YourServiceRegion Konuşma kaynağı bölgenizi yazın.

curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/YourEndpointId/files/logs" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"

Her günlük dosyasının daha fazla ayrıntı içeren konumları yanıt gövdesinde döndürülür.

Günlük verileri Microsoft'a ait depolamada 30 gün boyunca kullanılabilir ve ardından kaldırılır. Kendi depolama hesabınız Azure AI hizmetleri aboneliğine bağlıysa günlük verileri otomatik olarak silinmez.

Sonraki adımlar