Share via

A Speech szolgáltatás használata privát végponton keresztül

  • Cikk

Az Azure Private Link lehetővé teszi, hogy privát végpont használatával csatlakozzon az Azure-szolgáltatásokhoz. A privát végpont egy privát IP-cím, amely csak egy adott virtuális hálózaton és alhálózaton belül érhető el.

Ez a cikk bemutatja, hogyan állíthatja be és használhatja a Private Linket és a privát végpontokat a Speech szolgáltatással. Ez a cikk ezután ismerteti, hogyan távolíthatja el később a privát végpontokat, de továbbra is használhatja a Speech-erőforrást.

Feljegyzés

Mielőtt továbblép, tekintse át , hogyan használhat virtuális hálózatokat az Azure AI-szolgáltatásokkal.

A Speech-erőforrás privát végpontokhoz való beállításához a következő feladatok végrehajtására van szükség:

  1. Egyéni tartománynév létrehozása
  2. Privát végpontok bekapcsolása
  3. Meglévő alkalmazások és megoldások módosítása

Privát végpontok és virtuális hálózati szolgáltatásvégpontok

Az Azure privát végpontokat és virtuális hálózati szolgáltatásvégpontokat biztosít a privát Azure-gerinchálózaton keresztüli forgalomhoz. Az ilyen végponttípusok célja és mögöttes technológiái hasonlóak. Vannak azonban különbségek a két technológia között. Javasoljuk, hogy a hálózat megtervezése előtt ismerje meg mindkettő előnyeit és hátrányait.

Ha eldönti, hogy melyik technológiát szeretné használni, érdemes megfontolnia néhány dolgot:

  • Mindkét technológia biztosítja, hogy a virtuális hálózat és a Speech-erőforrás közötti forgalom ne haladhasson át a nyilvános interneten.
  • A privát végpont dedikált privát IP-címet biztosít a Speech-erőforráshoz. Ez az IP-cím csak egy adott virtuális hálózaton és alhálózaton belül érhető el. Teljes mértékben szabályozhatja az IP-címhez való hozzáférést a hálózati infrastruktúrán belül.
  • A virtuális hálózati szolgáltatásvégpontok nem biztosítanak dedikált privát IP-címet a Speech-erőforráshoz. Ehelyett beágyazzák a Speech-erőforrásnak küldött összes csomagot, és közvetlenül az Azure gerinchálózatán keresztül kézbesítik őket.
  • Mindkét technológia támogatja a helyszíni forgatókönyveket. Alapértelmezés szerint a virtuális hálózati szolgáltatásvégpontok használatakor a virtuális hálózatokhoz védett Azure-szolgáltatási erőforrások nem érhetőek el a helyszíni hálózatokról. De ezt a viselkedést megváltoztathatja.
  • A virtuális hálózati szolgáltatásvégpontokat gyakran használják a Speech-erőforrás hozzáférésének korlátozására azon virtuális hálózatok alapján, amelyekből a forgalom származik.
  • Az Azure AI-szolgáltatások esetében a virtuális hálózati szolgáltatásvégpont engedélyezése kényszeríti az Összes Azure AI-szolgáltatási erőforrás forgalmát a privát gerinchálózaton. Ehhez explicit hálózati hozzáférési konfigurációra van szükség. (További információ: Virtuális hálózatok és a Speech-erőforrás hálózati beállításainak konfigurálása.) A privát végpontok nem rendelkeznek ezzel a korlátozásokkal, és nagyobb rugalmasságot biztosítanak a hálózati konfigurációhoz. Az egyik erőforrást a privát gerinchálózaton, a másikat pedig a nyilvános interneten keresztül érheti el ugyanazon virtuális hálózat ugyanazon alhálózatával.
  • A privát végpontok többletköltséggel járnak. A virtuális hálózati szolgáltatásvégpontok ingyenesek.
  • A privát végpontok további DNS-konfigurációt igényelnek.
  • Egy Speech-erőforrás egyszerre használható privát végpontokkal és virtuális hálózati szolgáltatásvégpontokkal is.

Javasoljuk, hogy próbálja ki mindkét végponttípust, mielőtt döntést hoz az éles kialakításról.

További információkért tekintse meg az alábbi erőforrásokat:

Ez a cikk a Privát végpontok Speech szolgáltatással való használatát ismerteti. A VNet-szolgáltatásvégpontok használatát itt ismertetjük.

Egyéni tartománynév létrehozása

Figyelemfelhívás

Az egyéni tartománynévvel rendelkező Speech-erőforrások más módon használják a Speech szolgáltatást. Előfordulhat, hogy mindkét esetben módosítania kell az alkalmazás kódját: privát végponttal és privát végpont nélkül.

Az alábbi lépéseket követve egyéni altartománynevet hozhat létre az Azure AI-szolgáltatásokhoz a Speech-erőforráshoz.

Figyelemfelhívás

Egyéni tartománynév bekapcsolásakor a művelet nem vonható vissza. A regionális névre csak úgy lehet visszatérni, ha létrehozunk egy új Speech-erőforrást.

Ha a Speech-erőforrás számos társított egyéni modellel és projekttel rendelkezik a Speech Studióban, javasoljuk, hogy tesztelje a konfigurációt egy teszterőforrással, mielőtt módosítaná az éles környezetben használt erőforrást.

Ha egyéni tartománynevet szeretne létrehozni az Azure Portalon, kövesse az alábbi lépéseket:

  1. Nyissa meg az Azure Portalt, és jelentkezzen be Azure-fiókjába.

  2. Válassza ki a szükséges Speech-erőforrást.

  3. A bal oldali panel Erőforrás-kezelés csoportjában válassza a Hálózatkezelés lehetőséget.

  4. A Tűzfalak és virtuális hálózatok lapon válassza az Egyéni tartománynév létrehozása lehetőséget. Megjelenik egy új jobb oldali panel, amely útmutatást tartalmaz az erőforrás egyedi egyéni altartományának létrehozásához.

  5. Az Egyéni tartománynév létrehozása panelen adjon meg egy egyéni tartománynevet. A teljes egyéni tartomány a következőképpen fog kinézni: https://{your custom name}.cognitiveservices.azure.com.

    Ne feledje, hogy az egyéni tartománynév létrehozása után az nem módosítható.

    Miután megadta az egyéni tartománynevet, válassza a Mentés lehetőséget.

  6. A művelet befejezése után az Erőforrás-kezelés csoportban válassza a Kulcsok és végpont lehetőséget. Győződjön meg arról, hogy az erőforrás új végpontneve a következő módon indul el: https://{your custom name}.cognitiveservices.azure.com.

Privát végpontok bekapcsolása

Javasoljuk, hogy a virtuális hálózathoz csatolt privát DNS-zónát használja a privát végpontokhoz szükséges frissítésekkel. A kiépítési folyamat során létrehozhat egy privát DNS-zónát. Ha saját DNS-kiszolgálót használ, előfordulhat, hogy módosítania kell a DNS-konfigurációt is.

Döntse el a DNS-stratégiát, mielőtt privát végpontokat épít ki egy éles Speech-erőforráshoz. Tesztelje a DNS-módosításokat, különösen akkor, ha saját DNS-kiszolgálót használ.

A következő cikkek egyikével hozhat létre privát végpontokat. Ezek a cikkek egy webalkalmazást használnak mintaerőforrásként, hogy privát végpontokon keresztül elérhetővé tegyék őket.

Használja ezeket a paramétereket a választott cikkben szereplő paraméterek helyett:

Beállítás Érték
Erőforrás típusa Microsoft.CognitiveServices/accounts
Erőforrás <a beszéd-erőforrás neve>
Célzott alerőforrás Számla

DNS privát végpontokhoz: Tekintse át az Azure AI-szolgáltatások erőforrásaiban található privát végpontok DNS-ének általános alapelveit. Ezután ellenőrizze, hogy a DNS-konfiguráció megfelelően működik-e az alábbi szakaszokban leírt ellenőrzések végrehajtásával.

DNS feloldása a virtuális hálózatról

Ez az ellenőrzés kötelező.

Kövesse az alábbi lépéseket az egyéni DNS-bejegyzés virtuális hálózatból való teszteléséhez:

  1. Jelentkezzen be egy olyan virtuális gépre, amely abban a virtuális hálózaton található, amelyhez a privát végpontot csatlakoztatta.

  2. Nyisson meg egy Windows-parancssort vagy egy Bash-rendszerhéjat, futtassa nslookup, és győződjön meg arról, hogy az sikeresen feloldja az erőforrás egyéni tartománynevét.

    C:\>nslookup my-private-link-speech.cognitiveservices.azure.com
Server:  UnKnown
Address:  168.63.129.16

Non-authoritative answer:
Name:    my-private-link-speech.privatelink.cognitiveservices.azure.com
Address:  172.28.0.10
Aliases:  my-private-link-speech.cognitiveservices.azure.com

  3. Ellenőrizze, hogy az IP-cím megegyezik-e a privát végpont IP-címével.

DNS feloldása más hálózatokból

Ezt az ellenőrzést csak akkor végezze el, ha az erőforrás Hálózat szakaszában bekapcsolta a Minden hálózat vagy a Kijelölt hálózatok és privát végpontok hozzáférési lehetőséget.

Ha csak egy privát végpont használatával szeretné elérni az erőforrást, kihagyhatja ezt a szakaszt.

  1. Jelentkezzen be egy hálózathoz csatlakoztatott számítógépre, amely számára engedélyezett az erőforrás elérése.

  2. Nyisson meg egy Windows-parancssort vagy Bash-rendszerhéjat, futtassa nslookup, és győződjön meg arról, hogy az sikeresen feloldja az erőforrás egyéni tartománynevét.

    C:\>nslookup my-private-link-speech.cognitiveservices.azure.com
Server:  UnKnown
Address:  fe80::1

Non-authoritative answer:
Name:    vnetproxyv1-weu-prod.westeurope.cloudapp.azure.com
Address:  13.69.67.71
Aliases:  my-private-link-speech.cognitiveservices.azure.com
          my-private-link-speech.privatelink.cognitiveservices.azure.com
          westeurope.prod.vnet.cog.trafficmanager.net

Feljegyzés

A feloldott IP-cím egy virtuális hálózati proxyvégpontra mutat, amely a Speech-erőforrás privát végpontjának küldi a hálózati forgalmat. Az egyéni tartománynévvel rendelkező, de privát végpontok nélküli erőforrások viselkedése eltérő lesz. A részletekért tekintse meg ezt a szakaszt .

Alkalmazás módosítása speech-erőforrás magánvégponttal való használatához

Egy egyéni tartománnyal rendelkező Speech-erőforrás más módon kommunikál a Speech szolgáltatással. Ez igaz az egyéni tartományalapú Speech-erőforrásra privát végpontokkal és anélkül is. Az ebben a szakaszban található információk mindkét forgatókönyvre vonatkoznak.

Az ebben a szakaszban található utasításokat követve módosíthatja a meglévő alkalmazásokat és megoldásokat, hogy egyéni tartománynévvel és privát végponttal rendelkező Speech-erőforrást használjon.

Egy egyéni tartománynévvel és egy privát végponttal rendelkező Speech-erőforrás más módon használja a Speech szolgáltatást. Ez a szakasz bemutatja, hogyan használhat ilyen erőforrást a Speech service REST API-kkal és a Speech SDK-val.

Feljegyzés

Az egyéni tartománynevet használó privát végpontokat nem tartalmazó Speech-erőforrások speciális módon használják a Speech szolgáltatást. Ez eltér a privát végpontot használó Speech-erőforrás forgatókönyvétől. Ez azért fontos, mert később dönthet úgy, hogy eltávolítja a privát végpontokat. A cikk későbbi részében további információt talál a Speech-erőforrás magánvégpontok nélküli alkalmazásának módosításáról.

Beszéderőforrás egyéni tartománynévvel és privát végponttal: Használat REST API-kkal

Ebben a szakaszban a Speech-erőforrás DNS-neve (egyéni tartomány) mintaként használjuk my-private-link-speech.cognitiveservices.azure.com .

A Speech service REST API-kkal rendelkezik a beszéd és a szövegközötti beszédhez. Fontolja meg a privát végpontot engedélyező forgatókönyv alábbi információinak használatát.

A szövegfelolvasás két REST API-val rendelkezik. Minden API más célt szolgál, különböző végpontokat használ, és más megközelítést igényel, amikor a privát végpont-kompatibilis forgatókönyvben használja.

A Speech to text REST API-k a következők:

A Speech to text REST API használata a rövid hanghoz és a Text to speech REST API a privát végpont forgatókönyvében ugyanaz. Ez egyenértékű a cikk későbbi részében ismertetett Speech SDK-esetével .

A speech to text REST API más végpontkészletet használ, ezért más megközelítést igényel a privát végpont-kompatibilis forgatókönyvhöz.

A következő alszakaszok mindkét esetet ismertetik.

Beszéd szöveggé REST API

A Speech-erőforrások általában az Azure AI-szolgáltatások regionális végpontjait használják a Speech to text REST API-val való kommunikációhoz. Ezek az erőforrások a következő elnevezési formátummal rendelkeznek:

{region}.api.cognitive.microsoft.com.

Ez egy mintakérés URL-címe:

https://westeurope.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions

Feljegyzés

Ez a cikk a 21Vianet-végpontok által üzemeltetett Azure Government és Microsoft Azure esetében jelenik meg.

Miután bekapcsolt egy egyéni tartományt egy Speech-erőforráshoz (amely a privát végpontokhoz szükséges), az erőforrás az alábbi DNS-névmintát fogja használni az alapszintű REST API-végponthoz:

{your custom name}.cognitiveservices.azure.com

Ez azt jelenti, hogy a példánkban a REST API-végpont neve a következő:

my-private-link-speech.cognitiveservices.azure.com

A mintakérés URL-címét pedig a következőre kell konvertálni:

https://my-private-link-speech.cognitiveservices.azure.com/speechtotext/v3.1/transcriptions

Ennek az URL-címnek elérhetőnek kell lennie a virtuális hálózatról a magánvégpont csatolásával (a megfelelő DNS-feloldással).

Miután bekapcsolt egy egyéni tartománynevet egy Speech-erőforráshoz, általában az összes kérelem URL-címében szereplő gazdagépnevet az új egyéni tartomány gazdagépnevére cseréli. A kérés minden más része (például a korábbi példában szereplő elérési út /speechtotext/v3.1/transcriptions ) változatlan marad.

Tipp.

Egyes ügyfelek olyan alkalmazásokat fejlesztenek, amelyek a regionális végpont DNS-nevének régió részét használják (például a kérés elküldéséhez az adott Azure-régióban üzembe helyezett Speech-erőforrásnak).

A Speech-erőforrás egyéni tartománya nem tartalmaz információt arról a régióról, ahol az erőforrás üzembe lett helyezve. Így a korábban ismertetett alkalmazáslogika nem fog működni, ezért módosítani kell.

Beszéd szöveggé REST API rövid hanghoz és Szövegről beszédre REST API

A speech to text REST API rövid hanghoz és a Text to speech REST API két végponttípust használ:

Feljegyzés

Ez a cikk a 21Vianet-végpontok által üzemeltetett Azure Government és Azure esetében jelenik meg.

A speciális végpontok részletes leírását és url-címének átalakítását egy privát végponttal kompatibilis Speech-erőforrás esetében ebben az alszakaszban találja a Speech SDK-val való használatról. Ugyanez az SDK-hoz leírt elv vonatkozik a Speech to text REST API-ra a rövid hanghoz és a Text to Speech REST API-hoz.

Ismerkedjen meg az előző bekezdésben említett alszakasz anyagával, és tekintse meg a következő példát. A példa a Text to speech REST API-t írja le. A Speech to text REST API használata a rövid hanghoz teljes mértékben egyenértékű.

Feljegyzés

Ha a Speech to text REST API-t használja rövid hang- és szövegfelolvasási REST API-val privát végponti forgatókönyvekben, használja a Ocp-Apim-Subscription-Key fejlécen áthaladó erőforráskulcsot. (További információ: Beszéd a szöveghez REST API rövid hanghoz és szövegről beszédre REST API)

Az engedélyezési jogkivonat használata és a speciális végpontnak a Authorization fejlécen keresztül történő átadása csak akkor működik, ha bekapcsolta a Speech-erőforrás Hálózatkezelés szakaszában a Minden hálózat hozzáférési lehetőséget. Más esetekben vagy hibaüzenet ForbiddenBadRequest jelenik meg egy engedélyezési jogkivonat beszerzésekor.

Szövegről beszédre – REST API-használati példa

Nyugat-Európát azure-mintarégióként és my-private-link-speech.cognitiveservices.azure.com speech-erőforrás DNS-neveként (egyéni tartományként) használjuk. A példánkban szereplő egyéni tartománynév my-private-link-speech.cognitiveservices.azure.com a nyugat-európai régióban létrehozott Speech-erőforráshoz tartozik.

A régióban támogatott hangok listájának lekéréséhez hajtsa végre a következő kérést:

https://westeurope.tts.speech.microsoft.com/cognitiveservices/voices/list

További részleteket a Text to speech REST API dokumentációjában talál.

A privát végpont-kompatibilis Speech-erőforrás esetében módosítani kell ugyanannak a műveletnek a végponti URL-címét. Ugyanez a kérés a következőképpen néz ki:

https://my-private-link-speech.cognitiveservices.azure.com/tts/cognitiveservices/voices/list

A Speech SDK végponti URL-címének összeállítása alszakaszában talál részletes magyarázatot.

Speech-erőforrás egyéni tartománynévvel és privát végponttal: Használat a Speech SDK-val

Ha a Speech SDK-t egyéni tartománynévvel és privát végponttal kompatibilis Speech-erőforrásokkal használja, át kell tekintenie és valószínűleg módosítania kell az alkalmazás kódját.

Ebben a szakaszban a Speech-erőforrás DNS-neve (egyéni tartomány) mintaként használjuk my-private-link-speech.cognitiveservices.azure.com .

Végpont URL-címének létrehozása

Általában SDK-forgatókönyvekben (és a speech to text REST API-ban a rövid hang- és szövegfelolvasási REST API-forgatókönyvekben) a Speech-erőforrások a dedikált regionális végpontokat használják a különböző szolgáltatásajánlatokhoz. A végpontok DNS-névformátuma a következő:

{region}.{speech service offering}.speech.microsoft.com

Példa DNS-név:

westeurope.stt.speech.microsoft.com

A régió (a DNS-név első eleme) összes lehetséges értéke szerepel a Speech service által támogatott régiókban. (Lásd ezt a cikket a 21Vianet-végpontok által üzemeltetett Azure Government és Azure esetében.) Az alábbi táblázat a Speech szolgáltatásajánlat lehetséges értékeit mutatja be (a DNS-név második eleme):

DNS-névérték Beszédszolgáltatás-ajánlat
commands Egyéni parancsok
convai Értekezlet átirata
s2s Beszédfordítás
stt Beszéd szöveggé
tts Szövegfelolvasás
voice Egyéni hang

A korábbi példa (westeurope.stt.speech.microsoft.com) tehát a "Speech to text" végpontot jelöli Nyugat-Európában.

A privát végpontok speciális proxyn keresztül kommunikálnak a Speech szolgáltatással. Emiatt módosítania kell a végpontkapcsolat URL-címeit.

A "standard" végpont URL-címe a következőképpen néz ki:

{region}.{speech service offering}.speech.microsoft.com/{URL path}

A privát végpont URL-címe a következőképpen néz ki:

{your custom name}.cognitiveservices.azure.com/{speech service offering}/{URL path}

1. példa. Egy alkalmazás a következő URL-cím használatával kommunikál (a nyugat-európai egyesült államokbeli angol nyelv alapmodelljének beszédfelismerése):

wss://westeurope.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?language=en-US

Ha a Speech-erőforrás my-private-link-speech.cognitiveservices.azure.comegyéni tartományneve esetén a privát végpontot használó forgatókönyvben szeretné használni, a következő módon kell módosítania az URL-címet:

wss://my-private-link-speech.cognitiveservices.azure.com/stt/speech/recognition/conversation/cognitiveservices/v1?language=en-US

Figyelje meg a részleteket:

  • A gazdagép nevét westeurope.stt.speech.microsoft.com az egyéni tartomány gazdagépneve my-private-link-speech.cognitiveservices.azure.comváltja fel.
  • Az eredeti DNS-név (stt) második eleme lesz az URL-elérési út első eleme, és megelőzi az eredeti elérési utat. Így az eredeti URL-cím /speech/recognition/conversation/cognitiveservices/v1?language=en-US lesz /stt/speech/recognition/conversation/cognitiveservices/v1?language=en-US.

2. példa. Egy alkalmazás a következő URL-cím használatával szintetizálja a beszédet Nyugat-Európában:

wss://westeurope.tts.speech.microsoft.com/cognitiveservices/websocket/v1

Az alábbi egyenértékű URL-cím egy privát végpontot használ, ahol a Speech-erőforrás egyéni tartományneve a következő my-private-link-speech.cognitiveservices.azure.com:

wss://my-private-link-speech.cognitiveservices.azure.com/tts/cognitiveservices/websocket/v1

Az 1. példában ugyanez az elv érvényesül, de a legfontosabb elem ezúttal a tts.

Alkalmazások módosítása

A kód módosításához kövesse az alábbi lépéseket:

  1. Az alkalmazásvégpont URL-címének meghatározása:

    • Kapcsolja be az alkalmazás naplózását, és futtassa a naplótevékenységhez.
    • A naplófájlban keresse meg a következőt SPEECH-ConnectionUrl: . Az egyező sorokban a value paraméter tartalmazza az alkalmazás által a Speech szolgáltatás eléréséhez használt teljes URL-címet.

    Példa:

    (114917): 41ms SPX_DBG_TRACE_VERBOSE:  property_bag_impl.cpp:138 ISpxPropertyBagImpl::LogPropertyAndValue: this=0x0000028FE4809D78; name='SPEECH-ConnectionUrl'; value='wss://westeurope.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?traffictype=spx&language=en-US'

    Az ebben a példában használt URL-cím tehát a következő:

    wss://westeurope.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?language=en-US

  2. Hozzon létre egy példányt SpeechConfig egy teljes végpont URL-címével:

    1. Módosítsa a meghatározott végpontot a korábbi Végpont URL-címének összeállítása szakaszban leírtak szerint.

    2. Módosítsa a példány SpeechConfiglétrehozásának módját. Az alkalmazás valószínűleg a következőhöz hasonlót használ:

      var config = SpeechConfig.FromSubscription(speechKey, azureRegion);

      Ez a példa nem működik privát végpont-kompatibilis Speech-erőforrás esetében az előző szakaszokban ismertetett állomásnév- és URL-változások miatt. Ha egy privát végponttal kompatibilis erőforrás kulcsával módosítás nélkül próbálja futtatni a meglévő alkalmazást, hitelesítési hiba (401) jelenik meg.

      A működéshez módosítsa az osztály példányosításának módját, és használja az SpeechConfig "from endpoint"/"with endpoint" inicializálást. Tegyük fel, hogy a következő két változó van definiálva:

      • speechKey tartalmazza a privát végpont-kompatibilis Speech-erőforrás kulcsát.
      • endPoint tartalmazza a teljes módosított végpont URL-címét (a megfelelő programozási nyelv által megkövetelt típus használatával). A példánkban ennek a változónak a következőket kell tartalmaznia: 
        wss://my-private-link-speech.cognitiveservices.azure.com/stt/speech/recognition/conversation/cognitiveservices/v1?language=en-US

      Példány létrehozása SpeechConfig :

      var config = SpeechConfig.FromEndpoint(endPoint, speechKey);

      auto config = SpeechConfig::FromEndpoint(endPoint, speechKey);

      SpeechConfig config = SpeechConfig.fromEndpoint(endPoint, speechKey);

      import azure.cognitiveservices.speech as speechsdk
config = speechsdk.SpeechConfig(endpoint=endPoint, subscription=speechKey)

      SPXSpeechConfiguration *config = [[SPXSpeechConfiguration alloc] initWithEndpoint:endPoint subscription:speechKey];

      import * as sdk from "microsoft.cognitiveservices.speech.sdk";
config: sdk.SpeechConfig = sdk.SpeechConfig.fromEndpoint(new URL(endPoint), speechKey);

Tipp.

A végpont URI-jában megadott lekérdezési paraméterek nem változnak, még akkor sem, ha más API-k állítják be őket. Ha például a felismerési nyelv az URI-ban lekérdezési paraméterként language=en-USvan definiálva, és a megfelelő tulajdonságon keresztül is be van állítva ru-RU , akkor az URI nyelvi beállítását használja a rendszer. A tényleges nyelv ezután en-US.

A végpont URI-ban beállított paraméterek mindig elsőbbséget élveznek. Más API-k csak olyan paramétereket bírálhatnak felül, amelyek nincsenek megadva a végpont URI-jában.

A módosítás után az alkalmazásnak a privát végponttal kompatibilis Speech-erőforrásokkal kell működnie. Dolgozunk a privát végponti forgatókönyvek zökkenőmentesebb támogatásán.

A Speech Studio használata

A Speech Studio egy webportál, amelyen az Azure AI Speech szolgáltatás létrehozása és integrálása az alkalmazásban eszközökkel történik. Amikor Speech Studio-projektekben dolgozik, a rendszer az Ön nevében hálózati kapcsolatokat és API-hívásokat kezdeményez a megfelelő Speech-erőforráshoz. A privát végpontok, a virtuális hálózati szolgáltatásvégpontok és más hálózati biztonsági beállítások használata korlátozhatja a Speech Studio funkcióinak rendelkezésre állását. A Speech Studiót általában olyan funkciók használatakor használja, mint az egyéni beszéd, az egyéni neurális hang és a hangtartalmak létrehozása.

A Speech Studio webportál elérése virtuális hálózatról

A Speech Studio Azure-beli virtuális hálózaton belüli virtuális gépről való használatához engedélyeznie kell a kimenő kapcsolatokat a virtuális hálózathoz szükséges szolgáltatáscímkék készletével. Részletek itt.

A Speech-erőforrásvégpont elérése nem egyenlő a Speech Studio webes portálhoz való hozzáféréssel. A Speech Studio webes portálhoz való hozzáférés privát vagy virtuális hálózati szolgáltatásvégpontokon keresztül nem támogatott.

Speech Studio-projektek használata

Ez a szakasz a Speech-erőforrás különböző hálózati biztonsági beállításainak különböző típusú Speech Studio-projektekkel való használatát ismerteti. A Speech Studióval való webböngésző-kapcsolat várhatóan létrejön. A beszéderőforrás hálózati biztonsági beállításai az Azure Portalon vannak beállítva.

  1. Nyissa meg az Azure Portalt, és jelentkezzen be Azure-fiókjába.
  2. Válassza ki a Speech erőforrást.
  3. A bal oldali panel Erőforrás-kezelés csoportjában válassza a Hálózati>tűzfalak és a virtuális hálózatok lehetőséget.
  4. Válasszon egy lehetőséget a Minden hálózat, a Kijelölt hálózatok és a Privát végpontok lehetőség közül, vagy tiltsa le.

Egyéni beszéd

Az alábbi táblázat az egyéni beszédprojektek akadálymentességét ismerteti a Speech-erőforrás hálózati>tűzfalai és a virtuális hálózatok biztonsági beállításai szerint.

Feljegyzés

Ha csak a privát végpontokat engedélyezi a Hálózatkezelés>privát végpontok kapcsolatok lapon, akkor a Speech Studio nem használható a Speech-erőforrással. A Speech-erőforrást a Speech Studión kívül is használhatja.

Beszéderőforrás hálózati biztonsági beállítása A Speech Studio projekt akadálymentessége
Összes hálózat Nincsenek korlátozások
Kiválasztott hálózatok és privát végpontok Elérhető az engedélyezett nyilvános IP-címekről
Disabled (Letiltva) Nem érhető el

Ha a Kijelölt hálózatok és a privát végpontok lehetőséget választja, megjelenik egy lap a virtuális hálózatok és a tűzfal hozzáférésének konfigurációs beállításaival. A Tűzfal szakaszban engedélyeznie kell legalább egy nyilvános IP-címet, és ezt a címet kell használnia a Speech Studióval való böngészőkapcsolathoz.

Ha csak virtuális hálózaton keresztül engedélyezi a hozzáférést, akkor valójában nem engedélyezi a Speech-erőforrás elérését a Speech Studióban. A Speech-erőforrást a Speech Studión kívül is használhatja.

Ha az egyéni beszédet az éles Speech-erőforrás hálózati hozzáférési korlátozásai nélkül szeretné használni, fontolja meg az alábbi megkerülő megoldások egyikét.

  • Hozzon létre egy másik Speech-erőforrást a nyilvános hálózaton használható fejlesztéshez. Készítse elő az egyéni modellt a Speech Studióban a fejlesztési erőforráson, majd másolja a modellt az éles erőforrásba. Tekintse meg a Models_CopyTo REST-kérést a Speech to text REST API-val.
  • Lehetősége van arra, hogy ne használja a Speech Studiót egyéni beszédhez. A Speech to text REST API használata minden egyéni beszédművelethez.

Egyéni hang- és hangtartalmak létrehozása

Egyéni hang- és hangtartalom-létrehozási Speech Studio-projekteket csak akkor használhat, ha a Speech erőforráshálózat biztonsági beállítása minden hálózat.

Alkalmazás beállítása a Speech-erőforrás magánvégpontok nélküli használatára

Ebben a cikkben többször is megjegyeztük, hogy egy egyéni tartomány engedélyezése egy Speech-erőforráshoz visszafordíthatatlan. Egy ilyen erőforrás más módon kommunikál a Speech szolgáltatással, mint a regionális végpontneveket használók.

Ez a szakasz bemutatja, hogyan használható egy Speech-erőforrás egyéni tartománynévvel, de privát végpontok nélkül a Speech service REST API-kkal és a Speech SDK-val. Ez lehet egy olyan erőforrás, amelyet korábban egy privát végpont forgatókönyvében használtak, de a privát végpontokat törölték.

DNS-konfiguráció

Ne feledje, hogyan oldja fel a privát végponttal kompatibilis Speech-erőforrás egyéni tartomány DNS-nevét a nyilvános hálózatokról. Ebben az esetben az IP-cím egy virtuális hálózat proxyvégpontjára mutat. Ez a végpont a hálózati forgalom magánvégpont-kompatibilis Azure AI-szolgáltatási erőforrásba való továbbítására szolgál.

Ha azonban az összes privát erőforrásvégpont el lesz távolítva (vagy közvetlenül az egyéni tartománynév engedélyezése után), a Speech-erőforrás CNAME rekordja újra meg lesz nyitható. Most a megfelelő Azure AI-szolgáltatások regionális végpontjának IP-címére mutat.

A parancs kimenete nslookup így néz ki:

C:\>nslookup my-private-link-speech.cognitiveservices.azure.com
Server:  UnKnown
Address:  fe80::1

Non-authoritative answer:
Name:    apimgmthskquihpkz6d90kmhvnabrx3ms3pdubscpdfk1tsx3a.cloudapp.net
Address:  13.93.122.1
Aliases:  my-private-link-speech.cognitiveservices.azure.com
          westeurope.api.cognitive.microsoft.com
          cognitiveweprod.trafficmanager.net
          cognitiveweprod.azure-api.net
          apimgmttmdjylckcx6clmh2isu2wr38uqzm63s8n4ub2y3e6xs.trafficmanager.net
          cognitiveweprod-westeurope-01.regional.azure-api.net

Hasonlítsa össze a szakasz kimenetével.

Beszéderőforrás egyéni tartománynévvel és privát végpontok nélkül: Használat REST API-kkal

Beszéd szöveggé REST API

A beszéd–szöveg REST API-használat teljes mértékben egyenértékű a privát végponttal kompatibilis Speech-erőforrások esetében.

Beszéd szöveggé REST API rövid hanghoz és Szövegről beszédre REST API

Ebben az esetben a Speech to text REST API rövid hanghoz való használata és a Text to speech REST API használata egyetlen kivétellel nem különbözik az általános esettől. (Lásd a következő megjegyzést.) Mindkét API-t a Speech to text REST API-ban leírtak szerint kell használnia a rövid hanganyagokhoz és a Text to Speech REST API dokumentációjához.

Feljegyzés

Ha a Speech to text REST API-t használja rövid hang- és szövegfelolvasási REST API-val egyéni tartományi forgatókönyvekben, használja a Ocp-Apim-Subscription-Key fejlécen áthaladó Speech erőforráskulcsot. (További információ: Beszéd a szöveghez REST API rövid hanghoz és szövegről beszédre REST API)

Az engedélyezési jogkivonat használata és a speciális végpontnak a Authorization fejlécen keresztül történő átadása csak akkor működik, ha bekapcsolta a Speech-erőforrás Hálózatkezelés szakaszában a Minden hálózat hozzáférési lehetőséget. Más esetekben vagy hibaüzenet ForbiddenBadRequest jelenik meg egy engedélyezési jogkivonat beszerzésekor.

Speech-erőforrás egyéni tartománynévvel és privát végpontok nélkül: Használat a Speech SDK-val

A Speech SDK privát végpontok nélküli egyéni tartományalapú Speech-erőforrásokkal való használata egyenértékű a Speech SDK dokumentációjában ismertetett általános esettel.

Ha módosította a kódját egy privát végponttal kompatibilis Speech-erőforrással való használatra, fontolja meg az alábbiakat.

A privát végponttal kompatibilis Speech-erőforrásokról szóló szakaszban elmagyaráztuk, hogyan határozható meg a végpont URL-címe, hogyan módosítható, és hogyan lehet az osztálypéldány "végpontról"/"végponttal" inicializálásával SpeechConfig működni.

Ha azonban ugyanazt az alkalmazást próbálja futtatni, miután az összes privát végpontot eltávolította (ezzel időt hagyva a megfelelő DNS-rekord újraépítésére), belső szolgáltatáshiba (404) jelenik meg. Ennek az az oka, hogy a DNS-rekord most a regionális Azure AI-szolgáltatások végpontjára mutat a virtuális hálózati proxy helyett, és a hasonló /stt/speech/recognition/conversation/cognitiveservices/v1?language=en-US URL-útvonalak nem találhatók ott.

Vissza kell állítania az alkalmazást a szabványos példányosításra SpeechConfig az alábbi kód stílusában:

var config = SpeechConfig.FromSubscription(speechKey, azureRegion);

Privát végpontok és virtuális hálózati szolgáltatásvégpontok egyidejű használata

Magánvégpontok és virtuális hálózati szolgáltatásvégpontok használatával egyszerre férhet hozzá ugyanahhoz a Speech-erőforráshoz. Az egyidejű használat engedélyezéséhez a Kijelölt hálózatok és privát végpontok lehetőséget kell használnia az Azure Portal Speech-erőforrásának hálózati beállításai között. Ebben a forgatókönyvben más beállítások nem támogatottak.

Díjszabás

A díjszabás részleteiért tekintse meg az Azure Private Link díjszabását.

További információ