Een aangepast spraakmodel implementeren

In dit artikel leert u hoe u een eindpunt implementeert voor een aangepast spraakmodel. Behalve voor batchtranscriptie moet u een aangepast eindpunt implementeren om een aangepast spraakmodel te gebruiken.

Tip

Een gehost implementatie-eindpunt is niet vereist voor het gebruik van aangepaste spraak met de Batch-transcriptie-API. U kunt resources besparen als het aangepaste spraakmodel alleen wordt gebruikt voor batchtranscriptie. Zie prijzen voor de Speech-service voor meer informatie.

U kunt een eindpunt voor een basis- of aangepast model implementeren en het eindpunt later bijwerken om een beter getraind model te gebruiken.

Notitie

Eindpunten die door F0 Spraakresources worden gebruikt, worden na zeven dagen verwijderd.

Een implementatie-eindpunt toevoegen

Voer de volgende stappen uit om een aangepast eindpunt te maken:

1. Meld u aan bij Speech Studio.

2. Selecteer Aangepaste spraak> Uw projectnaam >Modellen implementeren.

   Als dit uw eerste eindpunt is, ziet u dat er geen eindpunten in de tabel worden vermeld. Nadat u een eindpunt hebt gemaakt, kunt u op deze pagina alle geïmplementeerde eindpunten bijhouden.

3. Selecteer Model implementeren om de wizard nieuw eindpunt te starten.

4. Voer op de pagina Nieuw eindpunt een naam en beschrijving in voor uw aangepaste eindpunt.

5. Selecteer het aangepaste model dat u aan het eindpunt wilt koppelen.

6. U kunt desgewenst het selectievakje inschakelen om audio- en diagnostische logboekregistratie van het verkeer van het eindpunt in te schakelen.

   

7. Selecteer Toevoegen om het eindpunt op te slaan en te implementeren.

Op de hoofdpagina Modellen implementeren worden details over het nieuwe eindpunt weergegeven in een tabel, zoals naam, beschrijving, status en vervaldatum. Het kan tot 30 minuten duren voordat er een nieuw eindpunt wordt gemaakt dat gebruikmaakt van uw aangepaste modellen. Wanneer de status van de implementatie is gewijzigd in Geslaagd, is het eindpunt gereed voor gebruik.

Belangrijk

Noteer de vervaldatum van het model. Dit is de laatste datum waarop u uw aangepaste model kunt gebruiken voor spraakherkenning. Zie model- en eindpuntlevenscyclus voor meer informatie.

Selecteer de eindpuntkoppeling om informatie weer te geven die specifiek is voor het eindpunt, zoals de eindpuntsleutel, de eindpunt-URL en voorbeeldcode.

Gebruik de spx csr endpoint create opdracht om een eindpunt te maken en een model te implementeren. Bouw de aanvraagparameters volgens de volgende instructies:

• Stel de project parameter in op de id van een bestaand project. Dit wordt aanbevolen zodat u het eindpunt ook kunt bekijken en beheren in Speech Studio. U kunt de spx csr project list opdracht uitvoeren om beschikbare projecten op te halen.
• Stel de vereiste model parameter in op de id van het model dat u wilt implementeren op het eindpunt.
• Stel de vereiste language parameter in. De landinstelling van het eindpunt moet overeenkomen met de landinstelling van het model. De landinstelling kan later niet meer worden gewijzigd. De speech CLI-parameter language komt overeen met de locale eigenschap in de JSON-aanvraag en het antwoord.
• Stel de vereiste name parameter in. Dit is de naam die wordt weergegeven in Speech Studio. De speech CLI-parameter name komt overeen met de displayName eigenschap in de JSON-aanvraag en het antwoord.
• U kunt de logging parameter desgewenst instellen. Stel dit in om enabled audio- en diagnostische logboekregistratie van het verkeer van het eindpunt in te schakelen. De standaardwaarde is false.

Hier volgt een voorbeeld van een Speech CLI-opdracht om een eindpunt te maken en een model te implementeren:

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

U ontvangt een antwoordtekst in de volgende indeling:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/9e240dc1-3d2d-4ac9-98ec-1be05ba0e9dd"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2024-07-15T16:29:36Z",
  "status": "NotStarted",
  "createdDateTime": "2024-07-15T16:29:36Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

De eigenschap op het hoogste niveau self in de antwoordtekst is de URI van het eindpunt. Gebruik deze URI voor meer informatie over het project, het model en de logboeken van het eindpunt. U gebruikt deze URI ook om het eindpunt bij te werken.

Voer de volgende opdracht uit voor Speech CLI-hulp bij eindpunten:

spx help csr endpoint

Als u een eindpunt wilt maken en een model wilt implementeren, gebruikt u de Endpoints_Create bewerking van de REST API voor spraak naar tekst. Bouw de aanvraagbody volgens de volgende instructies:

• Stel de project eigenschap in op de URI van een bestaand project. Dit wordt aanbevolen zodat u het eindpunt ook kunt bekijken en beheren in Speech Studio. U kunt een Projects_List aanvraag indienen om beschikbare projecten op te halen.
• Stel de vereiste model eigenschap in op de URI van het model dat u wilt implementeren op het eindpunt.
• Stel de vereiste locale eigenschap in. De landinstelling van het eindpunt moet overeenkomen met de landinstelling van het model. De landinstelling kan later niet meer worden gewijzigd.
• Stel de vereiste displayName eigenschap in. Dit is de naam die wordt weergegeven in Speech Studio.
• U kunt desgewenst de loggingEnabled eigenschap instellen in properties. Stel dit in om true audio- en diagnostische logboekregistratie van het verkeer van het eindpunt in te schakelen. De standaardwaarde is false.

Maak een HTTP POST-aanvraag met behulp van de URI, zoals wordt weergegeven in het volgende Endpoints_Create voorbeeld. Vervang door YourSubscriptionKey de spraakresourcesleutel, vervang deze door YourServiceRegion uw spraakresourceregio en stel de eigenschappen van de aanvraagbody in zoals eerder beschreven.

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.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "properties": {
    "loggingEnabled": true
  },
  "displayName": "My Endpoint",
  "description": "My Endpoint Description",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
  },
  "locale": "en-US",
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints"

U ontvangt een antwoordtekst in de volgende indeling:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/9e240dc1-3d2d-4ac9-98ec-1be05ba0e9dd"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2024-07-15T16:29:36Z",
  "status": "NotStarted",
  "createdDateTime": "2024-07-15T16:29:36Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

De eigenschap op het hoogste niveau self in de antwoordtekst is de URI van het eindpunt. Gebruik deze URI voor meer informatie over het project, het model en de logboeken van het eindpunt. U gebruikt deze URI ook om het eindpunt bij te werken of te verwijderen.

Model wijzigen en eindpunt opnieuw implementeren

Een eindpunt kan worden bijgewerkt om een ander model te gebruiken dat is gemaakt door dezelfde Speech-resource. Zoals eerder vermeld, moet u het model van het eindpunt bijwerken voordat het model verloopt.

Een nieuw model gebruiken en het aangepaste eindpunt opnieuw implementeren:

1. Meld u aan bij Speech Studio.
2. Selecteer Aangepaste spraak> Uw projectnaam >Modellen implementeren.
3. Selecteer de koppeling naar een eindpunt op naam en selecteer vervolgens Model wijzigen.
4. Selecteer het nieuwe model dat u wilt gebruiken voor het eindpunt.
5. Selecteer Gereed om het eindpunt op te slaan en opnieuw te implementeren.

Gebruik de spx csr model update opdracht om het aangepaste eindpunt opnieuw te implementeren met een nieuw model. Bouw de aanvraagparameters volgens de volgende instructies:

• Stel de vereiste endpoint parameter in op de id van het eindpunt dat u wilt implementeren.
• Stel de vereiste model parameter in op de id van het model dat u wilt implementeren op het eindpunt.

Hier volgt een voorbeeld van een Speech CLI-opdracht waarmee het aangepaste eindpunt opnieuw wordt geïmplementeerd met een nieuw model:

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

U ontvangt een antwoordtekst in de volgende indeling:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/9e240dc1-3d2d-4ac9-98ec-1be05ba0e9dd"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2024-07-15T16:30:12Z",
  "status": "Succeeded",
  "createdDateTime": "2024-07-15T16:29:36Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

Voer de volgende opdracht uit voor Speech CLI-hulp bij eindpunten:

spx help csr endpoint

Als u het aangepaste eindpunt opnieuw wilt implementeren met een nieuw model, gebruikt u de Endpoints_Update bewerking van de Rest API voor spraak naar tekst. Bouw de aanvraagbody volgens de volgende instructies:

• Stel de model eigenschap in op de URI van het model dat u wilt implementeren op het eindpunt.

Maak een HTTP PATCH-aanvraag met behulp van de URI, zoals wordt weergegeven in het volgende voorbeeld. Vervang YourSubscriptionKey door uw Spraak-resourcesleutel, vervang door YourServiceRegion uw Spraak-resourceregio, vervang door YourEndpointId uw eindpunt-id en stel de eigenschappen van de aanvraagbody in zoals eerder beschreven.

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.2/models/9e240dc1-3d2d-4ac9-98ec-1be05ba0e9dd"
  },
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/YourEndpointId"

U ontvangt een antwoordtekst in de volgende indeling:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/9e240dc1-3d2d-4ac9-98ec-1be05ba0e9dd"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2024-07-15T16:30:12Z",
  "status": "Succeeded",
  "createdDateTime": "2024-07-15T16:29:36Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

Het opnieuw implementeren duurt enkele minuten. In de tussentijd gebruikt uw eindpunt het vorige model zonder onderbreking van de service.

Logboekregistratiegegevens weergeven

Logboekregistratiegegevens zijn beschikbaar voor export als u deze hebt geconfigureerd tijdens het maken van het eindpunt.

De eindpuntlogboeken downloaden:

1. Meld u aan bij Speech Studio.
2. Selecteer Aangepaste spraak> Uw projectnaam >Modellen implementeren.
3. Selecteer de koppeling op eindpuntnaam.
4. Selecteer Onder Logboekregistratie van inhoud het logboek Downloaden.

Gebruik de spx csr endpoint list opdracht om logboeken voor een eindpunt op te halen. Bouw de aanvraagparameters volgens de volgende instructies:

• Stel de vereiste endpoint parameter in op de id van het eindpunt dat u wilt ophalen uit logboeken.

Hier volgt een voorbeeld van een Speech CLI-opdracht waarmee logboeken voor een eindpunt worden opgeslagen:

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

De locaties van elk logboekbestand met meer details worden geretourneerd in de hoofdtekst van het antwoord.

Als u logboeken voor een eindpunt wilt ophalen, begint u met de Endpoints_Get bewerking van de REST API voor spraak-naar-tekst.

Maak een HTTP GET-aanvraag met behulp van de URI, zoals wordt weergegeven in het volgende voorbeeld. Vervang YourEndpointId door uw eindpunt-id, vervang deze door YourSubscriptionKey uw Spraak-resourcesleutel en vervang deze door YourServiceRegion uw spraakresourceregio.

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

U ontvangt een antwoordtekst in de volgende indeling:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/9e240dc1-3d2d-4ac9-98ec-1be05ba0e9dd"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2024-07-15T16:30:12Z",
  "status": "Succeeded",
  "createdDateTime": "2024-07-15T16:29:36Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

Maak een HTTP GET-aanvraag met behulp van de URI logboeken uit de vorige antwoordtekst. Vervang YourEndpointId door uw eindpunt-id, vervang deze door YourSubscriptionKey uw Spraak-resourcesleutel en vervang deze door YourServiceRegion uw spraakresourceregio.

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

De locaties van elk logboekbestand met meer details worden geretourneerd in de hoofdtekst van het antwoord.

Logboekregistratiegegevens zijn gedurende 30 dagen beschikbaar in de opslag die eigendom is van Microsoft en worden vervolgens verwijderd. Als uw eigen opslagaccount is gekoppeld aan het Azure AI-servicesabonnement, worden de logboekgegevens niet automatisch verwijderd.

Gerelateerde inhoud

• Overzicht van aangepaste spraak
• Levenscyclus van aangepast spraakmodel