Professzionális hangmodell üzembe helyezése végpontként

Cikk
10/16/2024

Miután sikeresen létrehozta és betanította a hangmodellt , üzembe kell helyeznie egy egyéni neurális hangvégponton.

Feljegyzés

Akár 50 végpontot is létrehozhat egy standard (S0) Speech-erőforrással, mindegyik saját egyéni neurális hanggal.

Az egyéni neurális hang használatához meg kell adnia a hangmodell nevét, az egyéni URI-t közvetlenül egy HTTP-kérelemben kell használnia, és ugyanazt a Speech-erőforrást kell használnia a szöveg beszédszolgáltatáshoz való hitelesítésének továbbításához.

Üzembehelyezési végpont hozzáadása

Egyéni neurális hangvégpont létrehozása:

Jelentkezzen be a Speech Studióba.
Válassza az Egyéni hang>: A projekt neve> Üzembe helyezési modell>üzembe helyezése modell.
Válasszon ki egy hangmodellt, amelyet ehhez a végponthoz szeretne társítani.
Adja meg az egyéni végpont nevét és leírását .
Válassza ki a végponttípust a forgatókönyvnek megfelelően. Ha az erőforrás támogatott régióban található, a végponttípus alapértelmezett beállítása a Nagy teljesítmény. Ellenkező esetben, ha az erőforrás nem támogatott régióban található, az egyetlen elérhető lehetőség a Gyors folytatás.
- Nagy teljesítmény: Valós idejű és nagy mennyiségű szintéziskéréssel, például beszélgetési AI-vel, call-center robotokkal rendelkező forgatókönyvekhez optimalizálva. A végpont üzembe helyezése vagy folytatása körülbelül 5 percet vesz igénybe. Azokról a régiókról, ahol a nagy teljesítményű végponttípus támogatott, a régiók táblában található lábjegyzetekben talál további információt.
- Gyors folytatás: Hangtartalom-létrehozási forgatókönyvekhez optimalizálva, ritkábban előforduló szintéziskérésekkel. Egy végpont egyszerű és gyors üzembe helyezése vagy folytatása egy perc alatt. A Gyors folytatás végponttípus minden olyan régióban támogatott, ahol a beszédhez szöveg érhető el.
Válassza az Üzembe helyezés lehetőséget a végpont létrehozásához.

A végpont üzembe helyezése után a végpont neve hivatkozásként jelenik meg. A hivatkozásra kattintva megjelenítheti a végpontra vonatkozó információkat, például a végpontkulcsot, a végpont URL-címét és a mintakódot. Ha az üzembe helyezés állapota sikeres, a végpont használatra kész.

Alkalmazásbeállítások

A REST API-kérésparaméterekként használt alkalmazásbeállítások a Speech Studióban a Modell üzembe helyezése lapon érhetők el.

A végpontkulcs azt a Speech erőforráskulcsot jeleníti meg, amelyhez a végpont társítva van. Használja a végpontkulcsot a kérés fejlécének Ocp-Apim-Subscription-Key értékeként.
A végpont URL-címe megjeleníti a szolgáltatásrégiót. A szolgáltatásrégió kérési voice.speech.microsoft.com paramétereként használja a fenti értéket. Használja például, eastus ha a végpont URL-címe .https://eastus.voice.speech.microsoft.com/cognitiveservices/v1
A végpont URL-címe megjeleníti a végpont azonosítóját. Használja a lekérdezési paraméterhez ?deploymentId= hozzáfűzött értéket a végpontazonosító-kérelem paraméterének értékeként.

Egyéni hang használata

Az egyéni végpont funkcionálisan megegyezik a szövegfelolvasási kérelmekhez használt szabványos végpontokkal.

Az egyik különbség az, hogy meg kell adni az EndpointId egyéni hang használatát a Speech SDK-val. A szöveggel kezdheti a beszéd gyorsútmutatóját , majd frissítheti a kódot a EndpointId következővel: és SpeechSynthesisVoiceName. További információ: egyéni végpont használata.

Ha egyéni hangot szeretne használni a Speech Synthesis Markup Language (SSML) használatával, adja meg a modell nevét hangnévként. Ez a példa a YourCustomVoiceName hangot használja.

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

Váltás új hangmodellre a termékben

Miután frissítette a hangmodellt a legújabb motorverzióra, vagy ha új hangra szeretne váltani a termékben, újra kell üzembe helyeznie az új hangmodellt egy új végpontra. Az új hangmodell ismételt üzembe helyezése a meglévő végponton nem támogatott. Az üzembe helyezés után váltsa át a forgalmat az újonnan létrehozott végpontra. Javasoljuk, hogy először egy tesztkörnyezet új végpontjának adja át a forgalmat, hogy a forgalom megfelelően működjön, majd az éles környezetben az új végpontra kerüljön. Az áttűnés során meg kell őriznie a régi végpontot. Ha az áttűnés során problémák merülnek fel az új végponttal kapcsolatban, váltson vissza a régi végpontra. Ha a forgalom körülbelül 24 órán keresztül jól működik az új végponton (ajánlott érték), törölheti a régi végpontot.

Feljegyzés

Ha a hangnév megváltozott, és beszédszintézis-korrektúranyelvet (SSML) használ, mindenképpen használja az új hangnevet az SSML-ben.

Végpont felfüggesztése és folytatása

Felfüggeszthet vagy folytathat egy végpontot, hogy korlátozza a használaton nem lévő erőforrások költését és megőrzését. A végpont felfüggesztése alatt nem számítunk fel díjat. A végpont folytatásakor továbbra is ugyanazt a végponti URL-címet használhatja az alkalmazásban a beszédszintézishez.

Feljegyzés

A felfüggesztési művelet szinte azonnal befejeződik. A folytatási művelet körülbelül annyi idő alatt fejeződik be, mint egy új üzembe helyezés.

Ez a szakasz bemutatja, hogyan függeszthet fel vagy folytathat egy egyéni neurális hangvégpontot a Speech Studio portálon.

Végpont felfüggesztése

A végpont felfüggesztéséhez és inaktiválásához válassza a Felfüggesztés lehetőséget a Speech Studióban a Modell üzembe helyezése lapon.
A megjelenő párbeszédpanelen válassza a Küldés lehetőséget. A végpont felfüggesztése után a Speech Studio megjeleníti a sikeresen felfüggesztett végpontértesítést .

Végpont folytatása

A végpont folytatásához és aktiválásához válassza az Önéletrajz lehetőséget a Speech Studióban a Modell üzembe helyezése lapon.
A megjelenő párbeszédpanelen válassza a Küldés lehetőséget. Miután sikeresen újraaktiválta a végpontot, az állapot felfüggesztettről sikeresre változik.

Következő lépések

További információ az egyéni neurális hangról az áttekintésben.
További információ a Speech Studióról az áttekintésben.

Miután sikeresen létrehozta és betanította a hangmodellt , üzembe kell helyeznie egy egyéni neurális hangvégponton.

Feljegyzés

Akár 50 végpontot is létrehozhat egy standard (S0) Speech-erőforrással, mindegyik saját egyéni neurális hanggal.

Üzembehelyezési végpont hozzáadása

Végpont létrehozásához használja az egyéni hang API Endpoints_Create műveletét. A kérelem törzsének összeállítása az alábbi utasítások szerint:

Állítsa be a szükséges projectId tulajdonságot. Lásd: projekt létrehozása.
Állítsa be a szükséges modelId tulajdonságot. Lásd hangmodell betanítását.
Állítsa be a szükséges description tulajdonságot. A leírás később módosítható.

Hozzon létre egy HTTP PUT-kérést az URI használatával az alábbi Endpoints_Create példában látható módon.

Cserélje le YourResourceKey a Speech erőforráskulcsot.
Cserélje le YourResourceRegion a Speech erőforrásrégióját.
Cserélje le EndpointId a kívánt végpontazonosítóra. Az azonosítónak GUID azonosítónak kell lennie, és egyedinek kell lennie a Speech-erőforrásban. Az azonosító a projekt URI-jában lesz használva, és később nem módosítható.

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"

A válasz törzsének a következő formátumban kell érkeznie:

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

A válaszfejléc tartalmazza a tulajdonságot Operation-Location . Ezzel az URI-val részletes információkat kaphat a Endpoints_Create műveletről. Íme egy példa a válaszfejlécre:

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

A végpontot Operation-Location a későbbi API-kérelmekben használva felfüggesztheti és folytathatja a végpontot , és törölhet egy végpontot.

Egyéni hang használata

Az egyéni végpont funkcionálisan megegyezik a szövegfelolvasási kérelmekhez használt szabványos végpontokkal.

Ha egyéni hangot szeretne használni a Speech Synthesis Markup Language (SSML) használatával, adja meg a modell nevét hangnévként. Ez a példa a YourCustomVoiceName hangot használja.

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

Végpont felfüggesztése

Egy végpont felfüggesztéséhez használja az egyéni hang API Endpoints_Suspend műveletét.

Hozzon létre egy HTTP POST-kérést az URI használatával az alábbi Endpoints_Suspend példában látható módon.

Cserélje le YourResourceKey a Speech erőforráskulcsot.
Cserélje le YourResourceRegion a Speech erőforrásrégióját.
Cserélje le YourEndpointId a végpont létrehozásakor kapott végpontazonosítóra.

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"

A válasz törzsének a következő formátumban kell érkeznie:

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

Végpont folytatása

A végpont folytatásához használja az egyéni hang API Endpoints_Resume műveletét.

Http POST-kérést készíthet az URI használatával az alábbi Endpoints_Resume példában látható módon.

Cserélje le YourResourceKey a Speech erőforráskulcsot.
Cserélje le YourResourceRegion a Speech erőforrásrégióját.
Cserélje le YourEndpointId a végpont létrehozásakor kapott végpontazonosítóra.

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"

A válasz törzsének a következő formátumban kell érkeznie:

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

Végpont törlése

Végpont törléséhez használja az egyéni hang API Endpoints_Delete műveletét.

Hozzon létre egy HTTP DELETE kérést az URI használatával az alábbi Endpoints_Delete példában látható módon.

Cserélje le YourResourceKey a Speech erőforráskulcsot.
Cserélje le YourResourceRegion a Speech erőforrásrégióját.
Cserélje le YourEndpointId a végpont létrehozásakor kapott végpontazonosítóra.

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"

Kapnia kell egy válaszfejlécet a 204-ben kapott állapotkóddal.

Váltás új hangmodellre a termékben

Feljegyzés

Ha a hangnév megváltozott, és beszédszintézis-korrektúranyelvet (SSML) használ, mindenképpen használja az új hangnevet az SSML-ben.

Következő lépések

További információ az egyéni neurális hangról az áttekintésben.
További információ a Speech Studióról az áttekintésben.

Megosztás a következőn keresztül:

Professzionális hangmodell üzembe helyezése végpontként

Üzembehelyezési végpont hozzáadása

Alkalmazásbeállítások

Egyéni hang használata

Váltás új hangmodellre a termékben

Végpont felfüggesztése és folytatása

Végpont felfüggesztése

Végpont folytatása

Következő lépések

Üzembehelyezési végpont hozzáadása

Egyéni hang használata

Végpont felfüggesztése

Végpont folytatása

Végpont törlése

Váltás új hangmodellre a termékben

Következő lépések

Visszajelzés

További források