Delen via

Uw professionele spraakmodel implementeren als eindpunt

  • Artikel

Nadat u uw spraakmodel hebt gemaakt en getraind , implementeert u het naar een aangepast neuraal spraakeindpunt.

Notitie

U kunt maximaal 50 eindpunten maken met een standaard (S0) Spraakresource, elk met een eigen aangepaste neurale stem.

Als u uw aangepaste neurale spraak wilt gebruiken, moet u de naam van het spraakmodel opgeven, de aangepaste URI rechtstreeks in een HTTP-aanvraag gebruiken en dezelfde spraakresource gebruiken om de verificatie van de tekst naar spraakservice door te geven.

Een implementatie-eindpunt toevoegen

Een aangepast neurale spraakeindpunt maken:

  1. Meld u aan bij Speech Studio.

  2. Selecteer Aangepaste stem> Uw projectnaam> Model implementeren model> implementeren.

  3. Selecteer een spraakmodel dat u aan dit eindpunt wilt koppelen.

  4. Voer een naam en beschrijving in voor uw aangepaste eindpunt.

  5. Selecteer Eindpunttype op basis van uw scenario. Als uw resource zich in een ondersteunde regio bevindt, is de standaardinstelling voor het eindpunttype Hoge prestaties. Als de resource zich in een niet-ondersteunde regio bevindt, is de enige beschikbare optie Snel hervatten.

    • Hoge prestaties: geoptimaliseerd voor scenario's met realtime- en hoogvolumesyntheseaanvragen, zoals conversationele AI, callcenterbots. Het duurt ongeveer 5 minuten om een eindpunt te implementeren of te hervatten. Zie de voetnoten in de tabel regio's waarin het eindpunttype Hoge prestaties wordt ondersteund.
    • Snel hervatten: geoptimaliseerd voor scenario's voor het maken van audio-inhoud met minder frequente syntheseaanvragen. Eenvoudig en snel een eindpunt binnen een minuut implementeren of hervatten. Het eindpunttype Snel hervatten wordt ondersteund in alle regio's waar tekst naar spraak beschikbaar is.

  6. Selecteer Implementeren om uw eindpunt te maken.

Nadat het eindpunt is geïmplementeerd, wordt de naam van het eindpunt weergegeven als een koppeling. Selecteer de koppeling om informatie weer te geven die specifiek is voor uw eindpunt, zoals de eindpuntsleutel, de eindpunt-URL en voorbeeldcode. Wanneer de status van de implementatie is geslaagd, is het eindpunt gereed voor gebruik.

Toepassingsinstellingen

De toepassingsinstellingen die u als REST API-aanvraagparameters gebruikt, zijn beschikbaar op het tabblad Model implementeren in Speech Studio.

Schermopname van aangepaste instellingen voor eindpunt-apps in Speech Studio.

  • De eindpuntsleutel toont de Spraak-resourcesleutel waarmee het eindpunt is gekoppeld. Gebruik de eindpuntsleutel als de waarde van de Ocp-Apim-Subscription-Key aanvraagheader.
  • De eindpunt-URL toont uw serviceregio. Gebruik de waarde die voorafgaat als voice.speech.microsoft.com de aanvraagparameter voor de serviceregio. Gebruik bijvoorbeeld eastus als de eindpunt-URL .https://eastus.voice.speech.microsoft.com/cognitiveservices/v1
  • De eindpunt-URL toont uw eindpunt-id. Gebruik de waarde die aan de ?deploymentId= queryparameter is toegevoegd als de waarde van de aanvraagparameter voor de eindpunt-id.

Uw aangepaste stem gebruiken

Het aangepaste eindpunt is functioneel identiek aan het standaardeindpunt dat wordt gebruikt voor tekst-naar-spraakaanvragen.

Een verschil is dat het EndpointId moet worden opgegeven om de aangepaste stem te gebruiken via de Speech SDK. U kunt beginnen met de snelstartgids voor tekst naar spraak en vervolgens de code bijwerken met de EndpointId en SpeechSynthesisVoiceName. Zie Een aangepast eindpunt gebruiken voor meer informatie.

Als u een aangepaste stem wilt gebruiken via Speech Synthesis Markup Language (SSML), geeft u de modelnaam op als de spraaknaam. In dit voorbeeld wordt de YourCustomVoiceName stem gebruikt.

<speak version="1.0" xmlns="http://www.w3.org/2001/10/synthesis" xml:lang="en-US">
    <voice name="YourCustomVoiceName">
        This is the text that is spoken. 
    </voice>
</speak>

Overschakelen naar een nieuw spraakmodel in uw product

Nadat u uw spraakmodel hebt bijgewerkt naar de nieuwste engineversie of als u wilt overschakelen naar een nieuwe stem in uw product, moet u het nieuwe spraakmodel opnieuw implementeren naar een nieuw eindpunt. Het opnieuw implementeren van een nieuw spraakmodel op uw bestaande eindpunt wordt niet ondersteund. Na de implementatie schakelt u het verkeer over naar het zojuist gemaakte eindpunt. U wordt aangeraden het verkeer eerst over te dragen naar het nieuwe eindpunt in een testomgeving om ervoor te zorgen dat het verkeer goed werkt en vervolgens over te dragen naar het nieuwe eindpunt in de productieomgeving. Tijdens de overgang moet u het oude eindpunt behouden. Als er tijdens de overgang problemen zijn met het nieuwe eindpunt, kunt u teruggaan naar uw oude eindpunt. Als het verkeer ongeveer 24 uur goed wordt uitgevoerd op het nieuwe eindpunt (aanbevolen waarde), kunt u uw oude eindpunt verwijderen.

Notitie

Als uw stemnaam is gewijzigd en u Speech Synthesis Markup Language (SSML) gebruikt, moet u de nieuwe stemnaam in SSML gebruiken.

Een eindpunt onderbreken en hervatten

U kunt een eindpunt onderbreken of hervatten om de uitgaven te beperken en resources te besparen die niet worden gebruikt. Er worden geen kosten in rekening gebracht terwijl het eindpunt is onderbroken. Wanneer u een eindpunt hervat, kunt u dezelfde eindpunt-URL in uw toepassing blijven gebruiken om spraak te synthetiseren.

Notitie

De onderbrekingsbewerking wordt bijna onmiddellijk voltooid. De cv-bewerking wordt ongeveer dezelfde tijd voltooid als een nieuwe implementatie.

In deze sectie wordt beschreven hoe u een aangepast neurale spraakeindpunt in de Speech Studio-portal onderbreekt of hervat.

Eindpunt onderbreken

  1. Als u uw eindpunt wilt onderbreken en deactiveren, selecteert u Onderbreken op het tabblad Model implementeren in Speech Studio.

    Schermopname van de optie Eindpunt onderbreken selecteren.

  2. Selecteer Verzenden in het dialoogvenster dat wordt weergegeven. Nadat het eindpunt is onderbroken, wordt in Speech Studio de melding over het onderbroken eindpunt weergegeven.

Eindpunt hervatten

  1. Als u uw eindpunt wilt hervatten en activeren, selecteert u Hervatten op het tabblad Model implementeren in Speech Studio.

    Schermopname van de optie Eindpunt hervatten selecteren.

  2. Selecteer Verzenden in het dialoogvenster dat wordt weergegeven. Nadat u het eindpunt opnieuw hebt geactiveerd, wordt de status gewijzigd van Onderbroken in Geslaagd.

Volgende stappen

  • Meer informatie over aangepaste neurale spraak vindt u in het overzicht.
  • Meer informatie over Speech Studio vindt u in het overzicht.

Nadat u uw spraakmodel hebt gemaakt en getraind , implementeert u het naar een aangepast neuraal spraakeindpunt.

Notitie

U kunt maximaal 50 eindpunten maken met een standaard (S0) Spraakresource, elk met een eigen aangepaste neurale stem.

Een implementatie-eindpunt toevoegen

Als u een eindpunt wilt maken, gebruikt u de Endpoints_Create bewerking van de aangepaste spraak-API. Bouw de aanvraagbody volgens de volgende instructies:

  • Stel de vereiste projectId eigenschap in. Zie Een project maken.
  • Stel de vereiste modelId eigenschap in. Zie hoe u een spraakmodel traint.
  • Stel de vereiste description eigenschap in. De beschrijving kan later worden gewijzigd.

Maak een HTTP PUT-aanvraag met behulp van de URI, zoals wordt weergegeven in het volgende Endpoints_Create voorbeeld.

  • Vervang door YourResourceKey uw Spraak-resourcesleutel.
  • Vervang door YourResourceRegion uw spraakresourceregio.
  • Vervang door EndpointId een eindpunt-id van uw keuze. De id moet een GUID zijn en moet uniek zijn binnen uw Speech-resource. De id wordt gebruikt in de URI van het project en kan later niet meer worden gewijzigd.
curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "Content-Type: application/json" -d '{
  "description": "Endpoint for Jessica voice",
  "projectId": "ProjectId",
  "modelId": "JessicaModelId",
} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/EndpointId?api-version=2024-02-01-preview"

U ontvangt een antwoordtekst in de volgende indeling:

{
  "id": "9f50c644-2121-40e9-9ea7-544e48bfe3cb",
  "description": "Endpoint for Jessica voice",
  "projectId": "ProjectId",
  "modelId": "JessicaModelId",
  "properties": {
    "kind": "HighPerformance"
  },
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

De antwoordheader bevat de Operation-Location eigenschap. Gebruik deze URI voor meer informatie over de Endpoints_Create-bewerking . Hier volgt een voorbeeld van de antwoordheader:

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2024-02-01-preview
Operation-Id: 284b7e37-f42d-4054-8fa9-08523c3de345

U gebruikt het eindpunt Operation-Location in volgende API-aanvragen om een eindpunt te onderbreken en te hervatten en een eindpunt te verwijderen.

Uw aangepaste stem gebruiken

Als u uw aangepaste neurale spraak wilt gebruiken, moet u de naam van het spraakmodel opgeven, de aangepaste URI rechtstreeks in een HTTP-aanvraag gebruiken en dezelfde spraakresource gebruiken om de verificatie van de tekst naar spraakservice door te geven.

Het aangepaste eindpunt is functioneel identiek aan het standaardeindpunt dat wordt gebruikt voor tekst-naar-spraakaanvragen.

Een verschil is dat het EndpointId moet worden opgegeven om de aangepaste stem te gebruiken via de Speech SDK. U kunt beginnen met de snelstartgids voor tekst naar spraak en vervolgens de code bijwerken met de EndpointId en SpeechSynthesisVoiceName. Zie Een aangepast eindpunt gebruiken voor meer informatie.

Als u een aangepaste stem wilt gebruiken via Speech Synthesis Markup Language (SSML), geeft u de modelnaam op als de spraaknaam. In dit voorbeeld wordt de YourCustomVoiceName stem gebruikt.

<speak version="1.0" xmlns="http://www.w3.org/2001/10/synthesis" xml:lang="en-US">
    <voice name="YourCustomVoiceName">
        This is the text that is spoken. 
    </voice>
</speak>

Een eindpunt onderbreken

U kunt een eindpunt onderbreken of hervatten om de uitgaven te beperken en resources te besparen die niet worden gebruikt. Er worden geen kosten in rekening gebracht terwijl het eindpunt is onderbroken. Wanneer u een eindpunt hervat, kunt u dezelfde eindpunt-URL in uw toepassing blijven gebruiken om spraak te synthetiseren.

Als u een eindpunt wilt onderbreken, gebruikt u de Endpoints_Suspend bewerking van de aangepaste spraak-API.

Maak een HTTP POST-aanvraag met behulp van de URI, zoals wordt weergegeven in het volgende Endpoints_Suspend voorbeeld.

  • Vervang door YourResourceKey uw Spraak-resourcesleutel.
  • Vervang door YourResourceRegion uw spraakresourceregio.
  • Vervang door YourEndpointId de eindpunt-id die u hebt ontvangen toen u het eindpunt maakte.
curl -v -X POST "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId:suspend?api-version=2024-02-01-preview" -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "content-type: application/json" -H "content-length: 0"

U ontvangt een antwoordtekst in de volgende indeling:

{
  "id": "9f50c644-2121-40e9-9ea7-544e48bfe3cb",
  "description": "Endpoint for Jessica voice",
  "projectId": "ProjectId",
  "modelId": "JessicaModelId",
  "properties": {
    "kind": "HighPerformance"
  },
  "status": "Disabling",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Een eindpunt hervatten

Als u een eindpunt wilt hervatten, gebruikt u de Endpoints_Resume bewerking van de aangepaste spraak-API.

Maak een HTTP POST-aanvraag met behulp van de URI, zoals wordt weergegeven in het volgende Endpoints_Resume voorbeeld.

  • Vervang door YourResourceKey uw Spraak-resourcesleutel.
  • Vervang door YourResourceRegion uw spraakresourceregio.
  • Vervang door YourEndpointId de eindpunt-id die u hebt ontvangen toen u het eindpunt maakte.
curl -v -X POST "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId:resume?api-version=2024-02-01-preview" -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "content-type: application/json" -H "content-length: 0"

U ontvangt een antwoordtekst in de volgende indeling:

{
  "id": "9f50c644-2121-40e9-9ea7-544e48bfe3cb",
  "description": "Endpoint for Jessica voice",
  "projectId": "ProjectId",
  "modelId": "JessicaModelId",
  "properties": {
    "kind": "HighPerformance"
  },
  "status": "Running",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Een eindpunt verwijderen

Als u een eindpunt wilt verwijderen, gebruikt u de Endpoints_Delete bewerking van de aangepaste spraak-API.

Maak een HTTP DELETE-aanvraag met behulp van de URI, zoals wordt weergegeven in het volgende Endpoints_Delete voorbeeld.

  • Vervang door YourResourceKey uw Spraak-resourcesleutel.
  • Vervang door YourResourceRegion uw spraakresourceregio.
  • Vervang door YourEndpointId de eindpunt-id die u hebt ontvangen toen u het eindpunt maakte.
curl -v -X DELETE "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId?api-version=2024-02-01-preview" -H "Ocp-Apim-Subscription-Key: YourResourceKey"

U ontvangt een antwoordheader met statuscode 204.

Overschakelen naar een nieuw spraakmodel in uw product

Nadat u uw spraakmodel hebt bijgewerkt naar de nieuwste engineversie of als u wilt overschakelen naar een nieuwe stem in uw product, moet u het nieuwe spraakmodel opnieuw implementeren naar een nieuw eindpunt. Het opnieuw implementeren van een nieuw spraakmodel op uw bestaande eindpunt wordt niet ondersteund. Na de implementatie schakelt u het verkeer over naar het zojuist gemaakte eindpunt. U wordt aangeraden het verkeer eerst over te dragen naar het nieuwe eindpunt in een testomgeving om ervoor te zorgen dat het verkeer goed werkt en vervolgens over te dragen naar het nieuwe eindpunt in de productieomgeving. Tijdens de overgang moet u het oude eindpunt behouden. Als er tijdens de overgang problemen zijn met het nieuwe eindpunt, kunt u teruggaan naar uw oude eindpunt. Als het verkeer ongeveer 24 uur goed wordt uitgevoerd op het nieuwe eindpunt (aanbevolen waarde), kunt u uw oude eindpunt verwijderen.

Notitie

Als uw stemnaam is gewijzigd en u Speech Synthesis Markup Language (SSML) gebruikt, moet u de nieuwe stemnaam in SSML gebruiken.

Volgende stappen

  • Meer informatie over aangepaste neurale spraak vindt u in het overzicht.
  • Meer informatie over Speech Studio vindt u in het overzicht.