Nasazení profesionálního hlasového modelu jako koncového bodu

Po úspěšném vytvoření a vyladění profesionálního hlasového modelu ho nasadíte do vlastního koncového bodu hlasu.

Poznámka:

S prostředkem služby Speech úrovně Standard (S0) můžete vytvořit až 50 koncových bodů, z nichž každý má vlastní hlas.

Pokud chcete použít jemně vyladěný profesionální hlas, musíte zadat název hlasového modelu, použít vlastní URI přímo v požadavku HTTP a použít stejný prostředek služby Speech pro autentizaci služby převodu textu na řeč.

Přidání koncového bodu nasazení

Vytvoření profesionálního hlasového koncového bodu:

Pokud chcete nasadit koncový bod, postupujte takto:

1. Přihlaste se k portálu Microsoft Foundry (Classic).
2. V levém podokně vyberte Jemné ladění a pak vyberte Vyladění služby AI.
3. Vyberte profesionální úlohu jemného ladění hlasu (podle názvu modelu), kterou jste zahájili podle popisu v článku o vytvoření profesionálního hlasu.
4. Vyberte Nasadit model>.
5. Vyberte hlasový model, který chcete přidružit k tomuto koncovému bodu, a pak vyberte Další.
6. Zadejte název koncového bodu a popis vlastního koncového bodu.
7. Podle vašeho scénáře vyberte typ koncového bodu. Pokud je váš prostředek v podporované oblasti, výchozí nastavení pro typ koncového bodu je Vysoký výkon. Jinak platí, že pokud je prostředek v nepodporované oblasti, jedinou dostupnou možností je Rychlé obnovení.
   • Vysoký výkon: Optimalizováno pro scénáře s požadavky na syntézu v reálném čase a vysokou objemovou syntézou, jako jsou konverzační AI, roboti call-center. Nasazení nebo obnovení koncového bodu trvá přibližně 5 minut. Informace o oblastech, kde je podporovaný typ koncového bodu s vysokým výkonem , najdete v tabulce oblastí poznámky pod čarou.
   • Rychlé obnovení: Optimalizované pro scénáře vytváření zvukového obsahu s méně častými požadavky na syntézu. Snadné a rychlé nasazení nebo obnovení koncového bodu za minutu Typ koncového bodu rychlého obnovování je podporován ve všech oblastech kde je k dispozici převod textu na řeč.
8. Vyberte Další.
9. Zaškrtnutím políčka přijměte podmínky použití a pak vyberte Další.
10. Zkontrolujte nastavení a výběrem políčka přijměte náklady na hostování modelu.
11. Vyberte Nasadit a vytvořte koncový bod.

Po nasazení koncového bodu se jeho název změní na odkaz. Výběrem odkazu zobrazíte informace specifické pro váš koncový bod, jako je klíč koncového bodu, adresa URL koncového bodu a ukázkový kód. Když je stav nasazení úspěšný, koncový bod je připravený k použití.

Testování vlastního hlasu

Po nasazení vlastního koncového bodu hlasu si můžete vyzkoušet vlastní hlas přímo na portálu.

1. Vyberte Nasadit model>.
2. Vyberte Testovací koncový bod.

Použití vlastního hlasu

Vlastní koncový bod je funkčně identický se standardním koncovým bodem, který se používá pro požadavky na převod textu na řeč.

Jedním z rozdílů je to, že EndpointId je nutné zadat použití vlastního hlasu prostřednictvím sady Speech SDK. Můžete začít pomocí rychlého startu k přeměně textu na řeč a poté aktualizovat kód pomocí EndpointId a SpeechSynthesisVoiceName. Další informace najdete v tématu Použití vlastního koncového bodu.

Pokud chcete použít vlastní hlas prostřednictvím jazyka SSML (Speech Synthesis Markup Language), zadejte název modelu jako hlasový název. Tento příklad používá YourCustomVoiceName hlas.

<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>

Přepnutí na nový hlasový model ve vašem produktu

Po aktualizaci hlasového modelu na nejnovější verzi modulu nebo pokud chcete přepnout na nový hlas v produktu, musíte nový hlasový model znovu nasadit do nového koncového bodu. Opětovné nasazení nového hlasového modelu ve stávajícím koncovém bodu se nepodporuje. Po nasazení přepněte provoz na nově vytvořený koncový bod. Nejprve doporučujeme přenést provoz do nového koncového bodu v testovacím prostředí, abyste měli jistotu, že provoz funguje dobře, a pak přenos do nového koncového bodu v produkčním prostředí. Během přechodu je potřeba zachovat starý koncový bod. Pokud během přechodu dojde k nějakým problémům s novým koncovým bodem, můžete přepnout zpět na starý koncový bod. Pokud provoz běží dobře na novém koncovém bodu přibližně 24 hodin (doporučená hodnota), můžete starý koncový bod odstranit.

Poznámka:

Pokud se změní vaše hlasové jméno a používáte jazyk SSML (Speech Synthesis Markup Language), nezapomeňte v SSML použít nový název hlasu.

Pozastavení a obnovení koncového bodu

Koncový bod můžete pozastavit nebo obnovit, abyste omezili útratu a ušetřili prostředky, které se nepoužívají. Během pozastavení koncového bodu se vám nebudou účtovat poplatky. Když obnovíte koncový bod, můžete ve své aplikaci dál používat stejnou adresu URL koncového bodu k syntetizaci řeči.

Poznámka:

Operace pozastavení se dokončí téměř okamžitě. Operace obnovení se dokončí přibližně ve stejném čase jako nové nasazení.

Tato část popisuje, jak pozastavit nebo obnovit vlastní hlasový koncový bod na portálu Microsoft Foundry.

Pozastavení koncového bodu

Chcete-li pozastavit a deaktivovat váš koncový bod:

1. Přihlaste se k portálu Microsoft Foundry (Classic).

2. V levém podokně vyberte Jemné ladění a pak vyberte Vyladění služby AI.

3. Vyberte profesionální úlohu jemného ladění hlasu (podle názvu modelu), kterou jste zahájili podle popisu v článku o vytvoření profesionálního hlasu.

4. Vyberte Nasadit model.

5. Vyberte koncový bod, který chcete pozastavit, a pak vyberte Pozastavit.

   

6. V zobrazeném dialogovém okně vyberte Pozastavit. Po pozastavení koncového bodu se stav změní z Úspěšné na Pozastaveno.

Obnovení koncového bodu

1. Pokud chcete obnovit a aktivovat koncový bod, vyberte Pokračovat na kartě Nasadit model na portálu Microsoft Foundry.
2. V zobrazeném dialogovém okně vyberte Odeslat. Po úspěšné aktivaci koncového bodu se stav změní z Pozastaveno na Úspěšné.

Další kroky

• Další informace o vlastním hlasu najdete v přehledu.
• Další informace o vlastním avataru najdete v přehledu.

Po úspěšném vytvoření a vytrénování hlasového modelu ho nasadíte do vlastního koncového bodu hlasu.

Poznámka:

S prostředkem služby Speech úrovně Standard (S0) můžete vytvořit až 50 koncových bodů, z nichž každý má vlastní hlas.

Pokud chcete použít vlastní hlas, musíte zadat název hlasového modelu, použít vlastní identifikátor URI přímo v požadavku HTTP a pomocí stejného prostředku služby Speech předávat ověřování textu do služby Speech.

Přidání koncového bodu nasazení

Vytvořte vlastní koncový bod hlasu:

1. Přihlaste se do Speech Studio.

2. Vyberte Vlastní hlas> Název vašeho projektu >Nasadit model>Nasadit model.

3. Vyberte hlasový model, který chcete přidružit k tomuto koncovému bodu.

4. Zadejte název a popis vlastního koncového bodu.

5. Podle vašeho scénáře vyberte typ koncového bodu. Pokud je váš prostředek v podporované oblasti, výchozí nastavení pro typ koncového bodu je Vysoký výkon. Jinak platí, že pokud je prostředek v nepodporované oblasti, jedinou dostupnou možností je rychlé obnovení.

   • Vysoký výkon: Optimalizováno pro scénáře s požadavky na syntézu v reálném čase a vysokou objemovou syntézou, jako jsou konverzační AI, roboti call-center. Nasazení nebo obnovení koncového bodu trvá přibližně 5 minut. Informace o oblastech, kde je podporovaný typ koncového bodu s vysokým výkonem , najdete v tabulce oblastí poznámky pod čarou.
   • Rychlý životopis: Optimalizováno pro scénáře vytváření zvukového obsahu s méně častými požadavky na syntézu. Snadné a rychlé nasazení nebo obnovení koncového bodu za minutu Typ koncového bodu Rychlé obnovení je podporován ve všech oblastech, kde je dostupný převod textu na řeč.

6. Vyberte Nasadit a vytvořte koncový bod.

Po nasazení koncového bodu se jeho název změní na odkaz. Výběrem odkazu zobrazíte informace specifické pro váš koncový bod, jako je klíč koncového bodu, adresa URL koncového bodu a ukázkový kód. Když je stav nasazení úspěšný, koncový bod je připravený k použití.

Testování vlastního hlasu

Po nasazení vlastního koncového bodu hlasu si můžete vyzkoušet vlastní hlas přímo na portálu.

1. Vyberte Nasadit model>.
2. Vyberte Testovací koncový bod.

Nastavení aplikace

Nastavení aplikace, které použijete jako parametry požadavku rozhraní REST API, jsou k dispozici na kartě Nasazení modelu v sadě Speech Studio.

• Klíč koncového bodu ukazuje klíč prostředku Speech, s nímž je koncový bod spojen. Jako hodnotu hlavičky požadavku použijte klíč koncového bodu Ocp-Apim-Subscription-Key.
• Adresa URL koncového bodu zobrazuje vaši oblast služby. Použijte hodnotu, která předchází voice.speech.microsoft.com jako parametr požadavku na oblast služby. Například použijte eastus , pokud je https://eastus.voice.speech.microsoft.com/cognitiveservices/v1adresa URL koncového bodu .
• Adresa URL koncového bodu zobrazuje ID koncového bodu. Jako hodnotu parametru požadavku ID koncového bodu použijte hodnotu připojenou k parametru ?deploymentId= dotazu.

Použití vlastního hlasu

Vlastní koncový bod je funkčně identický se standardním koncovým bodem, který se používá pro požadavky na převod textu na řeč.

Jedním z rozdílů je to, že EndpointId je nutné zadat použití vlastního hlasu prostřednictvím sady Speech SDK. Můžete začít pomocí rychlého startu k přeměně textu na řeč a poté aktualizovat kód pomocí EndpointId a SpeechSynthesisVoiceName. Další informace najdete v tématu Použití vlastního koncového bodu.

Pokud chcete použít vlastní hlas prostřednictvím jazyka SSML (Speech Synthesis Markup Language), zadejte název modelu jako hlasový název. Tento příklad používá YourCustomVoiceName hlas.

<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>

Přepnutí na nový hlasový model ve vašem produktu

Po aktualizaci hlasového modelu na nejnovější verzi modulu nebo pokud chcete přepnout na nový hlas ve vašem produktu, musíte nový hlasový model znovu nasadit do nového koncového bodu. Opětovné nasazení nového hlasového modelu ve stávajícím koncovém bodu se nepodporuje. Po nasazení přepněte provoz na nově vytvořený koncový bod. Nejprve doporučujeme přenést provoz do nového koncového bodu v testovacím prostředí, abyste měli jistotu, že provoz funguje dobře, a pak přenos do nového koncového bodu v produkčním prostředí. Během přechodu je potřeba zachovat starý koncový bod. Pokud během přechodu dojde k nějakým problémům s novým koncovým bodem, můžete přepnout zpět na starý koncový bod. Pokud provoz běží dobře na novém koncovém bodu přibližně 24 hodin (doporučená hodnota), můžete starý koncový bod odstranit.

Poznámka:

Pokud se změní vaše hlasové jméno a používáte jazyk SSML (Speech Synthesis Markup Language), nezapomeňte v SSML použít nový název hlasu.

Pozastavení a obnovení koncového bodu

Koncový bod můžete pozastavit nebo obnovit, abyste omezili útratu a ušetřili prostředky, které se nepoužívají. Během pozastavení koncového bodu se vám nebudou účtovat poplatky. Když obnovíte koncový bod, můžete ve své aplikaci dál používat stejnou adresu URL koncového bodu k syntetizaci řeči.

Poznámka:

Operace pozastavení se dokončí téměř okamžitě. Operace obnovení se dokončí přibližně ve stejné době jako nové nasazení.

Tato část popisuje, jak pozastavit nebo obnovit vlastní koncový bod hlasu na portálu Speech Studio.

Pozastavení koncového bodu

1. Pokud chcete koncový bod pozastavit a deaktivovat, vyberte možnost Pozastavit na kartě Nasadit model v nástroji Speech Studio.

   

2. V zobrazeném dialogovém okně vyberte Odeslat. Po pozastavení koncového bodu se v nástroji Speech Studio zobrazí oznámení o úspěšném pozastavení koncového bodu .

Obnovení koncového bodu

1. Pokud chcete obnovit a aktivovat koncový bod, vyberte Pokračovat na kartě Nasadit model v nástroji Speech Studio.

   

2. V zobrazeném dialogovém okně vyberte Odeslat. Po úspěšné aktivaci koncového bodu se stav změní z Pozastaveno na Úspěšné.

Další kroky

• Další informace o vlastním hlasu najdete v přehledu.
• Další informace o sadě Speech Studio najdete v přehledu.

Po úspěšném vytvoření a vytrénování hlasového modelu ho nasadíte do vlastního koncového bodu hlasu.

Poznámka:

S prostředkem služby Speech úrovně Standard (S0) můžete vytvořit až 50 koncových bodů, z nichž každý má vlastní hlas.

Přidání koncového bodu nasazení

Pokud chcete vytvořit koncový bod, použijte Endpoints_Create operaci vlastního hlasového rozhraní API. Sestavte tělo požadavku podle následujících pokynů:

• Nastavte požadovanou projectId vlastnost. Viz vytvoření projektu.
• Nastavte požadovanou modelId vlastnost. Podívejte se na trénování hlasového modelu.
• Nastavte požadovanou description vlastnost. Popis lze později změnit.

Vytvořte požadavek HTTP PUT pomocí URI, jak je uvedeno v následujícím příkladu Endpoints_Create.

• Nahraďte YourResourceKey klíčem ke zdroji Speech.
• Nahraďte YourResourceRegion regionem služby Speech.
• Nahraďte EndpointId ID koncového bodu podle svého výběru. ID musí být identifikátor GUID a musí být v rámci vašeho prostředku služby Speech jedinečný. ID se použije v identifikátoru URI projektu a nebude možné ho později změnit.

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=2026-01-01"

Měl by se zobrazit text odpovědi v následujícím formátu:

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

Hlavička odpovědi obsahuje Operation-Location vlastnost. Pomocí tohoto identifikátoru URI získáte podrobnosti o operaci Endpoints_Create . Tady je příklad hlavičky odpovědi:

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/aaaabbbb-0000-cccc-1111-dddd2222eeee?api-version=2026-01-01
Operation-Id: aaaabbbb-0000-cccc-1111-dddd2222eeee

Koncový bod Operation-Location použijete v následných požadavcích rozhraní API k pozastavení a obnovení koncového bodu a odstranění koncového bodu.

Použití vlastního hlasu

Pokud chcete použít vlastní hlas, musíte zadat název hlasového modelu, použít vlastní identifikátor URI přímo v požadavku HTTP a pomocí stejného prostředku služby Speech předávat ověřování textu do služby Speech.

Vlastní koncový bod je funkčně identický se standardním koncovým bodem, který se používá pro požadavky na převod textu na řeč.

Jedním z rozdílů je to, že EndpointId je nutné zadat použití vlastního hlasu prostřednictvím sady Speech SDK. Můžete začít pomocí rychlého startu k přeměně textu na řeč a poté aktualizovat kód pomocí EndpointId a SpeechSynthesisVoiceName. Další informace najdete v tématu Použití vlastního koncového bodu.

Pokud chcete použít vlastní hlas prostřednictvím jazyka SSML (Speech Synthesis Markup Language), zadejte název modelu jako hlasový název. Tento příklad používá YourCustomVoiceName hlas.

<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>

Pozastavte koncový bod

Koncový bod můžete pozastavit nebo obnovit, abyste omezili útratu a ušetřili prostředky, které se nepoužívají. Během pozastavení koncového bodu se vám nebudou účtovat poplatky. Když obnovíte koncový bod, můžete ve své aplikaci dál používat stejnou adresu URL koncového bodu k syntetizaci řeči.

Pokud chcete koncový bod pozastavit, použijte Endpoints_Suspend operaci vlastního hlasového rozhraní API.

Vytvořte požadavek HTTP POST pomocí URI, jak je znázorněno v následujícím příkladu Endpoints_Suspend.

• Nahraďte YourResourceKey klíčem ke zdroji Speech.
• Nahraďte YourResourceRegion regionem služby Speech.
• Nahraďte YourEndpointId ID koncového bodu, které jste obdrželi při vytváření koncového bodu.

curl -v -X POST "https://YourResourceRegion.api.cognitive.microsoft.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"

Měl by se zobrazit text odpovědi v následujícím formátu:

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

Obnovení koncového bodu

Pokud chcete obnovit koncový bod, použijte Endpoints_Resume operaci vlastního hlasového rozhraní API.

Vytvořte požadavek HTTP POST pomocí URI, jak je uvedeno v následujícím příkladu Endpoints_Resume.

• Nahraďte YourResourceKey klíčem ke zdroji Speech.
• Nahraďte YourResourceRegion regionem služby Speech.
• Nahraďte YourEndpointId ID koncového bodu, které jste obdrželi při vytváření koncového bodu.

curl -v -X POST "https://YourResourceRegion.api.cognitive.microsoft.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"

Měl by se zobrazit text odpovědi v následujícím formátu:

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

Odstranění koncového bodu

Pokud chcete koncový bod odstranit, použijte Endpoints_Delete operaci vlastního hlasového rozhraní API.

Proveďte požadavek HTTP DELETE použitím URI, jak ukazuje následující příklad Endpoints_Delete.

• Nahraďte YourResourceKey klíčem ke zdroji Speech.
• Nahraďte YourResourceRegion regionem služby Speech.
• Nahraďte YourEndpointId ID koncového bodu, které jste obdrželi při vytváření koncového bodu.

curl -v -X DELETE "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/endpoints/YourEndpointId?api-version=2026-01-01" -H "Ocp-Apim-Subscription-Key: YourResourceKey"

Měla by se zobrazit hlavička odpovědi se stavovým kódem 204.

Přepnutí na nový hlasový model ve vašem produktu

Po aktualizaci hlasového modelu na nejnovější verzi modulu nebo pokud chcete přepnout na nový hlas ve vašem produktu, musíte nový hlasový model znovu nasadit do nového koncového bodu. Opětovné nasazení nového hlasového modelu ve stávajícím koncovém bodu se nepodporuje. Po nasazení přepněte provoz na nově vytvořený koncový bod. Nejprve doporučujeme přenést provoz do nového koncového bodu v testovacím prostředí, abyste měli jistotu, že provoz funguje dobře, a pak přenos do nového koncového bodu v produkčním prostředí. Během přechodu je potřeba zachovat starý koncový bod. Pokud během přechodu dojde k nějakým problémům s novým koncovým bodem, můžete přepnout zpět na starý koncový bod. Pokud provoz běží dobře na novém koncovém bodu přibližně 24 hodin (doporučená hodnota), můžete starý koncový bod odstranit.

Poznámka:

Pokud se změní vaše hlasové jméno a používáte jazyk SSML (Speech Synthesis Markup Language), nezapomeňte v SSML použít nový název hlasu.

Další kroky

• Další informace o vlastním hlasu najdete v přehledu.
• Další informace o Speech Studio najdete v přehledu.