Distribuera en anpassad talmodell

  • Artikel

I den här artikeln får du lära dig hur du distribuerar en slutpunkt för en anpassad talmodell. Förutom batch-transkription måste du distribuera en anpassad slutpunkt för att använda en anpassad talmodell.

Dricks

En värdbaserad distributionsslutpunkt krävs inte för att använda anpassat tal med Batch-transkriptions-API:et. Du kan spara resurser om den anpassade talmodellen endast används för batch-transkription. Mer information finns i Priser för Speech-tjänsten.

Du kan distribuera en slutpunkt för en bas eller anpassad modell och sedan uppdatera slutpunkten senare för att använda en bättre tränad modell.

Kommentar

Slutpunkter som används av F0 Speech-resurser tas bort efter sju dagar.

Lägga till en distributionsslutpunkt

Följ dessa steg för att skapa en anpassad slutpunkt:

  1. Logga in på Speech Studio.

  2. Välj Anpassat tal> Projektnamnet >Distribuera modeller.

    Om det här är din första slutpunkt ser du att det inte finns några slutpunkter i tabellen. När du har skapat en slutpunkt använder du den här sidan för att spåra varje distribuerad slutpunkt.

  3. Välj Distribuera modell för att starta den nya slutpunktsguiden.

  4. På sidan Ny slutpunkt anger du ett namn och en beskrivning för din anpassade slutpunkt.

  5. Välj den anpassade modell som du vill associera med slutpunkten.

  6. Du kan också markera kryssrutan för att aktivera ljud- och diagnostikloggning av slutpunktens trafik.

    Skärmbild av sidan Ny slutpunkt som visar kryssrutan för att aktivera loggning.

  7. Välj Lägg till för att spara och distribuera slutpunkten.

På huvudsidan Distribuera modeller visas information om den nya slutpunkten i en tabell, till exempel namn, beskrivning, status och förfallodatum. Det kan ta upp till 30 minuter att instansiera en ny slutpunkt som använder dina anpassade modeller. När statusen för distributionen ändras till Lyckades är slutpunkten redo att användas.

Viktigt!

Anteckna modellens förfallodatum. Det här är det sista datumet som du kan använda din anpassade modell för taligenkänning. Mer information finns i Livscykel för modell och slutpunkt.

Välj slutpunktslänken för att visa information som är specifik för den, till exempel slutpunktsnyckeln, slutpunkts-URL:en och exempelkoden.

Om du vill skapa en slutpunkt och distribuera en modell använder du spx csr endpoint create kommandot . Skapa begärandeparametrarna enligt följande instruktioner:

  • Ange parametern project till ID för ett befintligt projekt. Detta rekommenderas så att du även kan visa och hantera slutpunkten i Speech Studio. Du kan köra spx csr project list kommandot för att hämta tillgängliga projekt.
  • Ange den obligatoriska model parametern till ID för den modell som du vill distribuera till slutpunkten.
  • Ange den obligatoriska language parametern. Slutpunktsspråket måste matcha modellens nationella inställningar. Språkvarianten kan inte ändras senare. Parametern Speech CLI language motsvarar locale egenskapen i JSON-begäran och -svaret.
  • Ange den obligatoriska name parametern. Det här är namnet som visas i Speech Studio. Parametern Speech CLI name motsvarar displayName egenskapen i JSON-begäran och -svaret.
  • Du kan också ange parametern logging . Ange detta för enabled att aktivera ljud- och diagnostikloggning av slutpunktens trafik. Standardvärdet är false.

Här är ett exempel på ett Speech CLI-kommando för att skapa en slutpunkt och distribuera en modell:

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

Du bör få en svarstext i följande format:

{
  "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"
}

Egenskapen på den översta nivån self i svarstexten är slutpunktens URI. Använd den här URI:n för att få information om slutpunktens projekt, modell och loggar. Du kan också använda den här URI:n för att uppdatera slutpunkten.

För Hjälp med Speech CLI med slutpunkter kör du följande kommando:

spx help csr endpoint

Om du vill skapa en slutpunkt och distribuera en modell använder du den Endpoints_Create åtgärden för REST-API:et Tal till text. Skapa begärandetexten enligt följande instruktioner:

  • project Ange egenskapen till URI för ett befintligt projekt. Detta rekommenderas så att du även kan visa och hantera slutpunkten i Speech Studio. Du kan göra en Projects_List begäran om att få tillgängliga projekt.
  • Ange den obligatoriska model egenskapen till URI:n för den modell som du vill distribuera till slutpunkten.
  • Ange den obligatoriska locale egenskapen. Slutpunktsspråket måste matcha modellens nationella inställningar. Språkvarianten kan inte ändras senare.
  • Ange den obligatoriska displayName egenskapen. Det här är namnet som visas i Speech Studio.
  • Du kan också ange egenskapen i loggingEnabledproperties. Ange detta för true att aktivera ljud- och diagnostikloggning av slutpunktens trafik. Standardvärdet är false.

Gör en HTTP POST-begäran med hjälp av URI:n enligt följande Endpoints_Create exempel. Ersätt YourSubscriptionKey med din Speech-resursnyckel, ersätt YourServiceRegion med resursregionen Speech och ange egenskaperna för begärandetexten enligt beskrivningen ovan.

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"

Du bör få en svarstext i följande format:

{
  "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"
}

Egenskapen på den översta nivån self i svarstexten är slutpunktens URI. Använd den här URI:n för att få information om slutpunktens projekt, modell och loggar. Du använder också den här URI:n för att uppdatera eller ta bort slutpunkten.

Ändra modell och distribuera om slutpunkten

En slutpunkt kan uppdateras för att använda en annan modell som har skapats av samma Speech-resurs. Som tidigare nämnts måste du uppdatera slutpunktens modell innan modellen upphör att gälla.

Så här använder du en ny modell och distribuerar om den anpassade slutpunkten:

  1. Logga in på Speech Studio.
  2. Välj Anpassat tal> Projektnamnet >Distribuera modeller.
  3. Välj länken till en slutpunkt efter namn och välj sedan Ändra modell.
  4. Välj den nya modell som du vill att slutpunkten ska använda.
  5. Välj Klar för att spara och distribuera slutpunkten igen.

Om du vill distribuera om den anpassade slutpunkten med en ny modell använder du spx csr model update kommandot . Skapa begärandeparametrarna enligt följande instruktioner:

  • Ange den obligatoriska endpoint parametern till ID:t för slutpunkten som du vill distribuera.
  • Ange den obligatoriska model parametern till ID för den modell som du vill distribuera till slutpunkten.

Här är ett exempel på ett Speech CLI-kommando som distribuerar om den anpassade slutpunkten med en ny modell:

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

Du bör få en svarstext i följande format:

{
  "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"
}

För Hjälp med Speech CLI med slutpunkter kör du följande kommando:

spx help csr endpoint

Om du vill distribuera om den anpassade slutpunkten med en ny modell använder du den Endpoints_Update åtgärden för REST-API:et Tal till text. Skapa begärandetexten enligt följande instruktioner:

  • model Ange egenskapen till URI:n för den modell som du vill distribuera till slutpunkten.

Gör en HTTP PATCH-begäran med hjälp av URI:n enligt följande exempel. Ersätt YourSubscriptionKey med din Speech-resursnyckel, ersätt YourServiceRegion med resursregionen Speech, ersätt YourEndpointId med ditt slutpunkts-ID och ange egenskaperna för begärandetexten enligt beskrivningen ovan.

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"

Du bör få en svarstext i följande format:

{
  "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"
}

Omdistributionen tar flera minuter att slutföra. Under tiden använder slutpunkten den tidigare modellen utan avbrott i tjänsten.

Visa loggningsdata

Loggningsdata är tillgängliga för export om du konfigurerade dem när du skapade slutpunkten.

Så här laddar du ned slutpunktsloggarna:

  1. Logga in på Speech Studio.
  2. Välj Anpassat tal> Projektnamnet >Distribuera modeller.
  3. Välj länken efter slutpunktsnamn.
  4. Under Innehållsloggning väljer du Ladda ned logg.

Använd kommandot för att hämta loggar för en slutpunkt spx csr endpoint list . Skapa begärandeparametrarna enligt följande instruktioner:

  • Ange den obligatoriska endpoint parametern till ID:t för slutpunkten som du vill hämta loggar.

Här är ett exempel på ett Speech CLI-kommando som hämtar loggar för en slutpunkt:

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

Platserna för varje loggfil med mer information returneras i svarstexten.

Om du vill hämta loggar för en slutpunkt börjar du med att använda Endpoints_Get-åtgärden i REST API:et tal till text.

Gör en HTTP GET-begäran med hjälp av URI:n enligt följande exempel. Ersätt YourEndpointId med ditt slutpunkts-ID, ersätt YourSubscriptionKey med din Speech-resursnyckel och ersätt YourServiceRegion med din Speech-resursregion.

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

Du bör få en svarstext i följande format:

{
  "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"
}

Gör en HTTP GET-begäran med hjälp av URI:n "loggar" från föregående svarstext. Ersätt YourEndpointId med ditt slutpunkts-ID, ersätt YourSubscriptionKey med din Speech-resursnyckel och ersätt YourServiceRegion med din Speech-resursregion.

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

Platserna för varje loggfil med mer information returneras i svarstexten.

Loggningsdata är tillgängliga på Microsoft-ägd lagring i 30 dagar och tas sedan bort. Om ditt eget lagringskonto är länkat till Azure AI-tjänstprenumerationen tas loggningsdata inte bort automatiskt.

Nästa steg