Zet uw professionele spraakmodel in als eindpunt

Nadat u uw professionele spraakmodel hebt gemaakt en afgestemd , implementeert u het op een aangepast spraakeindpunt.

Notitie

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

Als u uw afgestemde professionele stem wilt gebruiken, moet u de naam van het spraakmodel opgeven, de aangepaste URI rechtstreeks in een HTTP-aanvraag gebruiken en dezelfde Spraak-resource gebruiken om de verificatie van de tekst door te geven aan de spraakservice.

Een implementatie-eindpunt toevoegen

Een professioneel spraakeindpunt maken:

Voer de volgende stappen uit om een eindpunt te implementeren:

  1. Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).

  2. Selecteer Build in het menu rechtsboven.

  3. Selecteer in het linkerdeelvenster Fijnafstemmen.

  4. Selecteer het tabblad AI-services en selecteer vervolgens de naam van het nauwkeurig afgestemde model dat u wilt implementeren.

  5. Selecteer Op de pagina met modeldetails de optie Implementeren in de rechterbovenhoek om het deelvenster Implementeren te openen.

  6. Vul in het deelvenster Implementeren de volgende instellingen in:

    • Implementatienaam: Voer een naam in voor de implementatie.
    • Eindpunttype: Selecteer Hoge prestaties of Snel hervatten op basis van uw scenario. Als uw resource zich in een ondersteunde regio bevindt, is de standaardinstelling Hoge prestaties. Anders is alleen Snel hervatten beschikbaar.
      • Hoge prestaties: geoptimaliseerd voor scenario's met realtime- en hoogvolumesyntheseaanvragen, zoals conversationele AI of 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 voor snel hervatten wordt ondersteund in alle regio's waar tekst naar spraak beschikbaar is.
    • Schakel het selectievakje in om de gebruiksvoorwaarden te accepteren.
    • Selecteer het selectievakje om de kosten voor het hosten van het model te erkennen.

  7. Selecteer Implementeren om uw eindpunt te maken.

Nadat uw eindpunt is geïmplementeerd, wordt het weergegeven op het tabblad Implementaties van de pagina met modeldetails. Selecteer de naam van de implementatie om eindpuntdetails weer te geven, zoals de eindpuntsleutel, de eindpunt-URL en voorbeeldcode. Wanneer de status Geslaagd is, is het eindpunt gereed voor gebruik.

Uw aangepaste stem testen

Zodra uw aangepaste spraakeindpunt is geïmplementeerd, kunt u uw aangepaste stem rechtstreeks in de portal uitproberen.

  1. Selecteer Model implementeren.>Model implementeren.
  2. Selecteer Test-eindpunt.

Schermopname van een pagina om een eindpunt te testen.

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 verloopt op het nieuwe eindpunt, wat de aanbevolen periode is, kunt u uw oude eindpunt verwijderen.

Notitie

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

Een eindpunt pauzeren en hervatten

U kunt een eindpunt onderbreken of hervatten om uitgaven te beperken en resources te besparen die niet worden gebruikt. Er worden geen kosten in rekening gebracht terwijl het eindpunt is gepauzeerd. 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 hervatten operatie duurt ongeveer even lang als een nieuwe implementatie.

In deze sectie wordt beschreven hoe u een aangepast spraakeindpunt kunt onderbreken of hervatten in de Microsoft Foundry-portal.

Eindpunt onderbreken

Uw eindpunt onderbreken en deactiveren:

  1. Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).
  2. Selecteer Build in het menu rechtsboven.
  3. Selecteer in het linkerdeelvenster Fijnafstemmen.
  4. Selecteer het tabblad AI-services en selecteer vervolgens de naam van het nauwkeurig afgestemde model.
  5. Selecteer op de pagina met modeldetails het tabblad Implementaties .
  6. Selecteer het eindpunt dat u wilt onderbreken en selecteer Vervolgens Onderbreken.
  7. Selecteer Onderbreken in het dialoogvenster dat wordt weergegeven. Nadat het eindpunt is onderbroken, verandert de status van Geslaagd in Onderbroken.

Eindpunt hervatten

  1. Als u uw eindpunt wilt hervatten en activeren, selecteert u Hervatten op het tabblad Model implementeren in de Microsoft Foundry-portal.
  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 spraak vindt u in het overzicht.
  • Meer informatie over aangepaste avatars vindt u in het overzicht.

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

Notitie

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

Als u uw aangepaste stem 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 spraakeindpunt maken:

  1. Meld u aan bij Speech Studio.

  2. Selecteer Custom voice>>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 geslaagd is, is het eindpunt gereed voor gebruik.

Uw aangepaste stem testen

Zodra uw aangepaste spraakeindpunt is geïmplementeerd, kunt u uw aangepaste stem rechtstreeks in de portal uitproberen.

  1. Selecteer Model implementeren.>Model implementeren.
  2. Selecteer Test-eindpunt.

Schermopname van een pagina om een eindpunt te testen in Speech Studio.

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 verzoekheader.
  • De eindpunt-URL toont uw serviceregio. Gebruik de waarde die voorafgaat aan voice.speech.microsoft.com als uw 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 verloopt op het nieuwe eindpunt, wat de aanbevolen periode is, 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 pauzeren 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 gepauzeerd. 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 hervattingsbewerking duurt ongeveer even lang als een nieuwe implementatie.

In deze sectie wordt beschreven hoe u een aangepast spraakeindpunt kunt onderbreken of hervatten in de Speech Studio-portal.

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 om het 'resume endpoint' te 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 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 spraakeindpunt.

Notitie

U kunt maximaal 50 eindpunten maken met een standaard (S0) Spraakresource, elk met een eigen aangepaste 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 YourResourceKey door uw Spraak-resourcesleutel.
  • Vervang YourResourceName door de naam van uw Speech-resource.
  • Vervang door EndpointId een eindpunt-id van uw keuze. De ID moet een GUID zijn en moet uniek zijn binnen uw Speech-resources. 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://YourResourceName.cognitiveservices.azure.com/customvoice/endpoints/EndpointId?api-version=2026-01-01"

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://YourResourceName.cognitiveservices.azure.com/customvoice/operations/aaaabbbb-0000-cccc-1111-dddd2222eeee?api-version=2026-01-01
Operation-Id: aaaabbbb-0000-cccc-1111-dddd2222eeee

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 stem 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 gepauzeerd. 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 YourResourceKey door uw Spraak-resourcesleutel.
  • Vervang YourResourceName door de naam van uw Speech-resource.
  • Vervang door YourEndpointId de eindpunt-id die u hebt ontvangen toen u het eindpunt maakte.
curl -v -X POST "https://YourResourceName.cognitiveservices.azure.com/customvoice/endpoints/YourEndpointId:suspend?api-version=2026-01-01" -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"
}

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 YourResourceKey door uw Spraak-resourcesleutel.
  • Vervang YourResourceName door de naam van uw Speech-resource.
  • Vervang door YourEndpointId de eindpunt-id die u hebt ontvangen toen u het eindpunt maakte.
curl -v -X POST "https://YourResourceName.cognitiveservices.azure.com/customvoice/endpoints/YourEndpointId:resume?api-version=2026-01-01" -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 YourResourceKey door uw Spraak-resourcesleutel.
  • Vervang YourResourceName door de naam van uw Speech-resource.
  • Vervang door YourEndpointId de eindpunt-id die u hebt ontvangen toen u het eindpunt maakte.
curl -v -X DELETE "https://YourResourceName.cognitiveservices.azure.com/customvoice/endpoints/YourEndpointId?api-version=2026-01-01" -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 verloopt op het nieuwe eindpunt, wat de aanbevolen periode is, 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 spraak vindt u in het overzicht.
  • Meer informatie over Speech Studio vindt u in het overzicht.
  • Last updated on