Gunakan layanan Ucapan melalui titik akhir privat

Azure Private Link memungkinkan Anda terhubung ke layanan di Azure menggunakan titik akhir privat. Titik akhir pribadi adalah alamat IP privat yang hanya dapat diakses dalam jaringan virtual dan subnet tertentu.

Artikel ini menjelaskan cara menyiapkan dan menggunakan Private Link dan titik akhir privat dengan layanan Ucapan. Artikel ini kemudian menjelaskan cara menghapus titik akhir privat nanti, tetapi masih menggunakan sumber daya Ucapan.

Catatan

Sebelum melanjutkan, tinjau cara menggunakan jaringan virtual dengan layanan Azure AI.

Menyiapkan sumber daya Ucapan untuk skenario titik akhir privat memerlukan tugas berikut:

1. Buat nama domain kustom
2. Aktifkan titik akhir privat
3. Menyesuaikan aplikasi dan solusi yang ada

Titik akhir privat dan titik akhir layanan Jaringan Virtual

Azure menyediakan titik akhir privat dan titik akhir layanan Jaringan Virtual untuk lalu lintas yang disalurkan melalui jaringan tulang punggung Azure privat. Tujuan dan teknologi yang mendasari jenis titik akhir ini serupa. Tetapi ada perbedaan antara kedua teknologi tersebut. Kami menyarankan Anda belajar tentang pro dan kontra dari keduanya sebelum Anda merancang jaringan Anda.

Ada beberapa hal yang perlu dipertimbangkan ketika Anda memutuskan teknologi mana yang akan digunakan:

• Kedua teknologi memastikan bahwa lalu lintas antara jaringan virtual dan sumber daya Ucapan tidak melakukan perjalanan melalui internet publik.
• Titik akhir pribadi menyediakan alamat IP privat khusus untuk sumber daya Ucapan Anda. Alamat IP ini hanya dapat diakses dalam jaringan dan subnet virtual tertentu. Anda memiliki kontrol penuh atas akses ke alamat IP ini dalam infrastruktur jaringan Anda.
• Titik akhir layanan Jaringan Virtual tidak menyediakan alamat IP privat khusus untuk sumber daya Ucapan. Sebaliknya, mereka merangkum semua paket yang dikirim ke sumber daya Ucapan dan mengirimkannya langsung melalui jaringan backbone Azure.
• Kedua teknologi mendukung skenario lokal. Secara default, ketika mereka menggunakan titik akhir layanan Jaringan Virtual, sumber daya layanan Azure yang diamankan ke jaringan virtual tidak dapat dijangkau dari jaringan lokal. Namun Anda dapat mengubah perilaku tersebut.
• Titik akhir layanan Jaringan Virtual sering digunakan untuk membatasi akses untuk sumber daya Ucapan berdasarkan jaringan virtual dari mana lalu lintas berasal.
• Untuk layanan Azure AI, mengaktifkan titik akhir layanan Virtual Network memaksa lalu lintas untuk semua sumber daya layanan Azure AI melalui jaringan backbone privat. Itu membutuhkan konfigurasi akses jaringan eksplisit. (Untuk informasi selengkapnya, lihat Mengonfigurasi jaringan virtual dan pengaturan Jaringan sumber daya Pidato.) Titik akhir privat tidak memiliki batasan ini dan memberikan lebih banyak fleksibilitas untuk konfigurasi jaringan Anda. Anda dapat mengakses satu sumber daya melalui tulang punggung privat dan yang lain melalui internet publik dengan menggunakan subnet yang sama dari jaringan virtual yang sama.
• Titik akhir privat dikenakan biaya tambahan. Titik akhir layanan Jaringan Virtual gratis.
• Titik akhir privat memerlukan konfigurasi DNS ekstra.
• Satu sumber daya Ucapan dapat bekerja secara bersamaan dengan titik akhir privat dan titik akhir layanan Jaringan Virtual.

Sebaiknya coba kedua jenis titik akhir sebelum memutuskan desain produksi Anda.

Untuk informasi selengkapnya, lihat sumber daya berikut:

• Azure Private Link dan dokumentasi titik akhir privat
• Dokumentasi titik akhir layanan Jaringan Virtual

Artikel ini menjelaskan penggunaan titik akhir privat dengan layanan Ucapan. Penggunaan titik akhir layanan VNet dijelaskan di sini.

Buat nama domain kustom

Perhatian

Sumber daya Ucapan dengan nama domain kustom yang diaktifkan menggunakan cara berbeda untuk berinteraksi dengan layanan Ucapan. Anda mungkin harus menyesuaikan kode aplikasi untuk kedua skenario berikut: dengan titik akhir privat dan tanpa titik akhir privat.

Ikuti langkah-langkah ini untuk membuat nama subdomain kustom untuk layanan Azure AI untuk sumber daya Ucapan Anda.

Perhatian

Saat Anda mengaktifkan nama domain kustom, operasi tersebut tidak dapat dibatalkan. Satu-satunya cara untuk kembali ke nama regional adalah dengan membuat sumber Ucapan baru.

Jika sumber daya Ucapan Anda memiliki banyak model dan proyek kustom terkait yang dibuat melalui Speech Studio, sebaiknya coba konfigurasi dengan sumber daya pengujian sebelum Anda mengubah sumber daya yang digunakan dalam produksi.

Portal Azure

Untuk membuat nama domain kustom dengan menggunakan portal Azure, ikuti langkah-langkah berikut:

1. Buka portal Azure dan masuk ke akun Azure Anda.

2. Pilih sumber Ucapan yang diperlukan.

3. Di grup Pengelolaan Sumber Daya di panel kiri, pilih Jaringan.

4. Pada tab Firewalls dan jaringan virtual, pilih Buat Nama Domain Kustom. Panel kanan baru muncul dengan petunjuk untuk membuat subdomain kustom yang unik untuk sumber daya Anda.

5. Di panel Buat Nama Domain Kustom, masukkan nama domain kustom. Domain kustom lengkap Anda akan terlihat seperti: https://{your custom name}.cognitiveservices.azure.com.

   Ingatlah bahwa setelah Anda membuat nama domain kustom, nama itu tidak dapat diubah.

   Setelah Anda memasukkan nama domain kustom, pilih Simpan.

6. Setelah operasi selesai, dalam grup Pengelolaan sumber daya, pilih Kunci dan Titik Akhir. Konfirmasikan bahwa nama titik akhir baru sumber daya Anda dimulai dengan cara ini: https://{your custom name}.cognitiveservices.azure.com.

PowerShell

Untuk membuat nama domain kustom dengan menggunakan PowerShell, konfirmasikan bahwa komputer Anda memiliki PowerShell versi 7.x atau yang lebih baru dengan modul Azure PowerShell versi 5.1.0 atau yang lebih baru. Untuk melihat versi alat ini, ikuti langkah-langkah berikut:

1. Di jendela PowerShell, masukkan:

   $PSVersionTable

   Konfirmasikan bahwa nilai PSVersion adalah 7.x atau lebih baru. Untuk meningkatkan versi PowerShell, ikuti petunjuk di Memasang berbagai versi PowerShell.

2. Di jendela PowerShell, masukkan:

   Get-Module -ListAvailable Az

   Jika tidak ada yang muncul, atau jika versi modul Azure PowerShell lebih awal dari 5.1.0, ikuti petunjuk di Memasang modul Azure PowerShell untuk meningkatkan.

Sebelum Anda melanjutkan, jalankan Connect-AzAccount untuk membuat sambungan dengan Azure.

Verifikasi bahwa nama domain kustom tersedia

Periksa apakah domain kustom yang ingin Anda gunakan tersedia. Kode berikut mengonfirmasi bahwa domain tersedia dengan menggunakan operasi Periksa Ketersediaan Domain di REST API layanan Azure AI.

Catatan

Kode berikut tidak akan berfungsi di Azure Cloud Shell.

$subscriptionId = "Your Azure subscription Id"
$subdomainName = "custom domain name"

# Select the Azure subscription that contains the Speech resource.
# You can skip this step if your Azure account has only one active subscription.
Set-AzContext -SubscriptionId $subscriptionId

# Prepare the OAuth token to use in the request to the Azure AI services REST API.
$Context = Get-AzContext
$AccessToken = (Get-AzAccessToken -TenantId $Context.Tenant.Id).Token
$token = ConvertTo-SecureString -String $AccessToken -AsPlainText -Force

# Prepare and send the request to the Azure AI services REST API.
$uri = "https://management.azure.com/subscriptions/" + $subscriptionId + `
    "/providers/Microsoft.CognitiveServices/checkDomainAvailability?api-version=2017-04-18"
$body = @{
subdomainName = $subdomainName
type = "Microsoft.CognitiveServices/accounts"
}
$jsonBody = $body | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri $uri -ContentType "application/json" -Authentication Bearer `
    -Token $token -Body $jsonBody | Format-List

Jika nama yang diinginkan tersedia, Anda akan melihat respons seperti ini:

isSubdomainAvailable : True
reason               :
type                 :
subdomainName        : my-custom-name

Jika nama sudah diambil, maka Anda akan melihat respons berikut:

isSubdomainAvailable : False
reason               : Sub domain name 'my-custom-name' is already used. Please pick a different name.
type                 :
subdomainName        : my-custom-name

Buat nama domain kustom Anda

Untuk mengaktifkan nama domain kustom untuk sumber daya Ucapan yang dipilih, gunakan cmdlet Set-AzCognitiveServicesAccount.

Perhatian

Setelah kode berikut berhasil dijalankan, Anda akan membuat nama domain kustom untuk sumber daya Ucapan Anda. Ingatlah bahwa nama ini tidak dapat diubah.

$resourceGroup = "Resource group name where Speech resource is located"
$speechResourceName = "Your Speech resource name"
$subdomainName = "custom domain name"

# Select the Azure subscription that contains the Speech resource.
# You can skip this step if your Azure account has only one active subscription.
$subscriptionId = "Your Azure subscription Id"
Set-AzContext -SubscriptionId $subscriptionId

# Set the custom domain name to the selected resource.
# WARNING: THIS CANNOT BE CHANGED OR UNDONE!
Set-AzCognitiveServicesAccount -ResourceGroupName $resourceGroup `
    -Name $speechResourceName -CustomSubdomainName $subdomainName

Azure CLI

Prasyarat

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Artikel ini memerlukan Azure CLI versi terbaru. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terpasang.

Verifikasi bahwa nama domain kustom tersedia

Periksa apakah domain kustom yang ingin Anda gunakan gratis. Gunakan metode Periksa Ketersediaan Domain dari REST API layanan Azure AI.

Salin blok kode berikut, masukkan nama domain kustom pilihan Anda, dan simpan ke file subdomain.json.

{
    "subdomainName": "custom domain name",
    "type": "Microsoft.CognitiveServices/accounts"
}

Salin file ke folder Anda saat ini atau unggah ke Azure Cloud Shell dan jalankan perintah berikut. Ganti xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx dengan ID langganan Azure Anda.

az rest --method post --url "https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.CognitiveServices/checkDomainAvailability?api-version=2017-04-18" --body @subdomain.json

Jika nama yang diinginkan tersedia, Anda akan melihat respons seperti ini:

{
  "isSubdomainAvailable": true,
  "reason": null,
  "subdomainName": "my-custom-name",
  "type": null
}

Jika nama sudah diambil, maka Anda akan melihat respons berikut:

{
  "isSubdomainAvailable": false,
  "reason": "Sub domain name 'my-custom-name' is already used. Please pick a different name.",
  "subdomainName": "my-custom-name",
  "type": null
}

Aktifkan nama domain kustom

Untuk menggunakan nama domain kustom dengan sumber Ucapan yang dipilih, gunakan perintah az cognitiveservices account update.

(Jika akun Azure Anda hanya memiliki satu langganan aktif, Anda dapat melewati langkah ini.) Pilih langganan Azure yang berisi sumber daya Ucapan. Ganti xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx dengan ID langganan Azure Anda.

az account set --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Setel nama domain kustom ke sumber daya yang dipilih. Ganti nilai parameter sampel dengan yang sebenarnya dan jalankan perintah berikut.

Perhatian

Setelah berhasil menjalankan perintah berikut, Anda akan membuat nama domain kustom untuk sumber daya Ucapan Anda. Ingatlah bahwa nama ini tidak dapat diubah.

az cognitiveservices account update --name my-speech-resource-name --resource-group my-resource-group-name --custom-domain my-custom-name

Aktifkan titik akhir privat

Sebaiknya gunakan zona DNS privat yang dilampirkan ke jaringan virtual dengan pembaruan yang diperlukan untuk titik akhir privat. Anda dapat membuat zona DNS privat selama proses penyediaan. Jika Anda menggunakan server DNS Anda sendiri, Anda mungkin juga perlu mengubah konfigurasi DNS Anda.

Tentukan strategi DNS sebelum Anda menyediakan titik akhir privat untuk sumber daya Ucapan produksi. Dan uji perubahan DNS Anda, terutama jika Anda menggunakan server DNS Anda sendiri.

Gunakan salah satu artikel berikut untuk membuat titik akhir privat. Artikel ini menggunakan aplikasi web sebagai contoh sumber daya yang tersedia melalui titik akhir privat.

• Buat titik akhir privat dengan menggunakan portal Azure
• Buat titik akhir privat dengan menggunakan Azure PowerShell
• Buat titik akhir privat dengan menggunakan Azure CLI

Gunakan parameter ini sebagai ganti parameter di artikel yang Anda pilih:

Pengaturan	Nilai
Jenis Sumber Daya	Microsoft.CognitiveServices/accounts
Sumber daya	<your-speech-resource-name>
Sub-sumber daya target	akun

DNS untuk titik akhir privat: Tinjau prinsip umum DNS untuk titik akhir privat di sumber daya layanan Azure AI. Kemudian konfirmasikan bahwa konfigurasi DNS Anda berfungsi dengan benar dengan melakukan pemeriksaan yang dijelaskan di bagian berikut.

Selesaikan DNS dari jaringan virtual

Pemeriksaan ini wajib.

Ikuti langkah-langkah ini untuk menguji entri DNS kustom dari jaringan virtual Anda:

1. Masuk ke komputer virtual yang terletak di jaringan virtual tempat Anda melampirkan titik akhir privat Anda.

2. Buka prompt perintah Windows atau shell Bash, jalankan nslookup, dan konfirmasikan bahwa itu berhasil menyelesaikan nama domain kustom sumber daya Anda.

   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. Konfirmasikan bahwa alamat IP cocok dengan alamat IP titik akhir privat Anda.

Selesaikan DNS dari jaringan lain

Lakukan pemeriksaan ini hanya jika Anda telah mengaktifkan opsi Semua jaringan atau opsi akses Jaringan Terpilih dan Titik Akhir Privat di bagian Jaringan sumber daya Anda.

Jika Anda berencana untuk mengakses sumber daya dengan hanya menggunakan titik akhir privat, Anda dapat melewati bagian ini.

1. Masuk ke komputer yang dilampirkan ke jaringan yang diizinkan untuk mengakses sumber daya.

2. Buka prompt perintah Windows atau shell Bash, jalankan nslookup, dan konfirmasikan bahwa itu berhasil menyelesaikan nama domain kustom sumber daya Anda.

   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
   

Catatan

Alamat IP yang diselesaikan menunjuk ke titik akhir proksi jaringan virtual, yang mengirimkan lalu lintas jaringan ke titik akhir privat untuk sumber daya Ucapan. Perilakunya akan berbeda untuk sumber daya dengan nama domain kustom tetapi tanpa titik akhir privat. Lihat bagian ini untuk detailnya.

Sesuaikan aplikasi untuk menggunakan sumber Ucapan dengan titik akhir privat

Sumber daya Ucapan dengan domain kustom berinteraksi dengan layanan Ucapan dengan cara yang berbeda. Hal ini berlaku untuk sumber daya Ucapan dengan domain kustom dengan dan tanpa titik akhir privat. Informasi di bagian ini berlaku untuk kedua skenario.

Ikuti instruksi di bagian ini untuk menyesuaikan aplikasi dan solusi yang ada untuk menggunakan sumber daya Ucapan dengan nama domain kustom dan titik akhir privat yang diaktifkan.

Sumber daya Ucapan dengan nama domain kustom dan titik akhir privat diaktifkan menggunakan cara yang berbeda untuk berinteraksi dengan layanan Ucapan. Bagian ini menjelaskan cara menggunakan sumber daya tersebut dengan REST API layanan Ucapan dan Speech SDK.

Catatan

Sumber daya Ucapan tanpa titik akhir privat yang menggunakan nama domain kustom juga memiliki cara khusus untuk berinteraksi dengan layanan Ucapan. Cara ini berbeda dari skenario sumber daya Ucapan yang menggunakan titik akhir privat. Ini penting untuk dipertimbangkan karena Anda dapat memutuskan untuk menghapus titik akhir privat nanti. Lihat Menyesuaikan aplikasi untuk menggunakan sumber Spech tanpa titik akhir privat nanti di artikel ini.

Sumber daya Speech dengan nama domain kustom dan titik akhir privat: Penggunaan dengan REST API

Kami menggunakan my-private-link-speech.cognitiveservices.azure.com sebagai contoh nama DNS sumber daya Ucapan (domain kustom) untuk bagian ini.

Layanan ucapan memiliki REST API untuk Ucapan ke teks dan Teks ke ucapan. Pertimbangkan informasi berikut untuk skenario yang mendukung titik akhir privat.

Ucapan ke teks memiliki dua REST API. Setiap API memiliki tujuan yang berbeda, menggunakan titik akhir yang berbeda, dan memerlukan pendekatan yang berbeda saat Anda menggunakannya dalam skenario yang mendukung titik akhir privat.

REST API Ucapan ke teks adalah:

• REST API ucapan ke teks, yang digunakan untuk transkripsi Batch dan ucapan kustom.
• REST API ucapan ke teks untuk audio pendek, yang digunakan untuk ucapan real time ke teks.

Penggunaan REST API Ucapan ke teks untuk audio pendek dan REST API Teks ke ucapan dalam skenario titik akhir privat sama. Ini setara dengan Speech SDK case yang dijelaskan nanti di artikel ini.

REST API ucapan ke teks menggunakan serangkaian titik akhir yang berbeda, sehingga memerlukan pendekatan yang berbeda untuk skenario yang diaktifkan titik akhir privat.

Subbagian berikutnya menjelaskan kedua kasus tersebut.

REST API ucapan ke teks

Biasanya, sumber daya Ucapan menggunakan titik akhir regional layanan Azure AI untuk berkomunikasi dengan REST API Ucapan ke teks. Sumber daya ini memiliki format penamaan berikut:

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

Ini adalah contoh URL permintaan:

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

Catatan

Lihat artikel ini untuk Azure Government dan Microsoft Azure yang dioperasikan oleh titik akhir 21Vianet.

Setelah Anda mengaktifkan domain kustom untuk sumber daya Ucapan (yang diperlukan untuk titik akhir privat), sumber daya tersebut akan menggunakan pola nama DNS berikut untuk titik akhir REST API dasar:

{your custom name}.cognitiveservices.azure.com

Itu berarti bahwa dalam contoh kami, nama titik akhir REST API adalah:

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

Dan contoh URL permintaan perlu dikonversi menjadi:

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

URL ini harus dapat dijangkau dari jaringan virtual dengan titik akhir privat terpasang (resolusi DNS yang benar disediakan).

Setelah Anda mengaktifkan nama domain kustom untuk sumber Ucapan, Anda biasanya mengganti nama host di semua URL permintaan dengan nama host domain kustom baru. Semua bagian lain dari permintaan (seperti jalur /speechtotext/v3.1/transcriptions pada contoh sebelumnya) tetap sama.

Tip

Beberapa pelanggan mengembangkan aplikasi yang menggunakan bagian wilayah dari nama DNS titik akhir wilayah (misalnya, untuk mengirim permintaan ke sumber ucapan yang disebarkan di wilayah Azure tertentu).

Domain kustom untuk sumber daya Ucapan berisi tidak ada informasi tentang wilayah tempat sumber daya disebarkan. Jadi logika aplikasi yang dijelaskan sebelumnya tidak akan berfungsi dan perlu diubah.

REST API ucapan ke teks untuk audio pendek dan REST API Teks ke ucapan

REST API Ucapan ke teks untuk audio pendek dan REST API Teks ke ucapan menggunakan dua jenis titik akhir:

• Titik akhir regional layanan Azure AI untuk berkomunikasi dengan REST API layanan Azure AI untuk mendapatkan token otorisasi
• Titik akhir khusus untuk semua operasi lainnya

Catatan

Lihat artikel ini untuk Azure Government dan Azure yang dioperasikan oleh titik akhir 21Vianet.

Uraian mendetail tentang titik akhir khusus dan bagaimana URL-nya harus diubah untuk sumber daya Ucapan yang mendukung titik akhir privat disediakan di subbagian ini tentang penggunaan dengan Speech SDK. Prinsip yang sama yang dijelaskan untuk SDK berlaku untuk REST API Ucapan ke teks untuk audio pendek dan REST API Teks ke ucapan.

Pelajari materi di subbagian yang disebutkan di paragraf sebelumnya dan lihat contoh berikut. Contoh menjelaskan REST API Teks ke ucapan. Penggunaan REST API Ucapan ke teks untuk audio pendek sepenuhnya setara.

Catatan

Saat Anda menggunakan REST API Ucapan ke teks untuk audio pendek dan REST API Teks ke ucapan dalam skenario titik akhir privat, gunakan kunci sumber daya yang diteruskan melalui Ocp-Apim-Subscription-Key header. (Lihat detail untuk REST API ucapan ke teks untuk audio pendek dan REST API Teks ke ucapan)

Menggunakan token otorisasi dan meneruskannya ke titik akhir khusus melalui tajuk Authorization akan berfungsi hanya jika Anda mengaktifkan opsi akses Semua jaringan di Jaringan bagian dari sumber daya Ucapan Anda. Dalam kasus lain, Anda akan mendapatkan kesalahan Forbidden atau BadRequest saat mencoba mendapatkan token otorisasi.

Contoh penggunaan REST API teks ke ucapan

Kami menggunakan Eropa Barat sebagai sampel wilayah Azure dan my-private-link-speech.cognitiveservices.azure.com sebagai contoh nama DNS sumber daya Ucapan (domain kustom). Nama domain kustom my-private-link-speech.cognitiveservices.azure.com dalam contoh kita adalah milik sumber daya Ucapan yang dibuat di kawasan Eropa Barat.

Untuk mendapatkan daftar suara yang didukung di wilayah tersebut, lakukan permintaan berikut:

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

Lihat detail selengkapnya dalam dokumentasi REST API Teks ke ucapan.

Untuk sumber daya Ucapan yang mendukung titik akhir privat, URL titik akhir untuk operasi yang sama perlu dimodifikasi. Permintaan yang sama terlihat seperti ini:

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

Lihat penjelasan mendetail di subbagian Buat URL titik akhir untuk Speech SDK.

Sumber daya ucapan dengan nama domain kustom dan titik akhir privat: Penggunaan dengan SDK Ucapan

Menggunakan Speech SDK dengan nama domain kustom dan sumber daya Ucapan yang mendukung private-endpoint mengharuskan Anda untuk meninjau dan kemungkinan mengubah kode aplikasi Anda.

Kami menggunakan my-private-link-speech.cognitiveservices.azure.com sebagai contoh nama DNS sumber daya Ucapan (domain kustom) untuk bagian ini.

Buat URL titik akhir

Biasanya dalam skenario SDK (dan dalam ucapan ke teks REST API untuk skenario REST API audio dan teks pendek ke ucapan), Sumber daya Ucapan menggunakan titik akhir regional khusus untuk penawaran layanan yang berbeda. Format nama DNS untuk titik akhir ini adalah:

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

Contoh nama DNS adalah:

westeurope.stt.speech.microsoft.com

Semua kemungkinan nilai untuk wilayah (elemen pertama dari nama DNS) tercantum di wilayah yang didukung layanan Ucapan. (Lihat artikel ini untuk Azure Government dan Azure yang dioperasikan oleh titik akhir 21Vianet.) Tabel berikut menyajikan nilai yang mungkin untuk penawaran layanan Ucapan (elemen kedua dari nama DNS):

Nilai nama DNS	Penawaran layanan Ucapan
commands	Perintah Kustom
convai	Transkripsi Rapat
s2s	Terjemahan Ucapan
stt	Ucapan ke Teks
tts	Teks ke ucapan
voice	Suara kustom

Jadi contoh sebelumnya (westeurope.stt.speech.microsoft.com) adalah singkatan dari titik akhir Ucapan ke teks di Eropa Barat.

Titik akhir yang mendukung titik akhir pribadi berkomunikasi dengan layanan Ucapan melalui proksi khusus. Karena itu, Anda harus mengubah URL sambungan titik akhir.

URL titik akhir "standar" terlihat seperti ini:

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

URL titik akhir privat terlihat seperti ini:

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

Contoh 1. Aplikasi berkomunikasi dengan menggunakan URL berikut (pengenalan ucapan menggunakan model dasar untuk bahasa Inggris AS di Eropa Barat):

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

Untuk menggunakannya dalam skenario yang mendukung titik akhir privat ketika nama domain kustom sumber daya Ucapan adalah my-private-link-speech.cognitiveservices.azure.com, Anda harus mengubah URL seperti ini:

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

Perhatikan detailnya:

• Nama host westeurope.stt.speech.microsoft.com diganti dengan nama host domain kustom my-private-link-speech.cognitiveservices.azure.com.
• Elemen kedua dari nama DNS asli (stt) menjadi elemen pertama dari jalur URL dan mendahului jalur asli. Jadi URL /speech/recognition/conversation/cognitiveservices/v1?language=en-US asli menjadi /stt/speech/recognition/conversation/cognitiveservices/v1?language=en-US.

Contoh 2. Aplikasi menggunakan URL berikut untuk mensintesis ucapan di Eropa Barat:

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

URL setara berikut menggunakan titik akhir privat, dengan nama domain kustom sumber daya Ucapan adalah my-private-link-speech.cognitiveservices.azure.com:

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

Prinsip yang sama dalam Contoh 1 diterapkan, tetapi elemen kunci kali ini adalah tts.

Memodifikasi aplikasi

Ikuti langkah-langkah ini untuk mengubah kode Anda:

1. Menentukan URL titik akhir aplikasi:

   • Aktifkan pengelogan untuk aplikasi Anda dan jalankan untuk mencatat aktivitas.
   • Dalam file log, telusuri SPEECH-ConnectionUrl. Dalam baris yang cocok, value parameter berisi URL lengkap yang digunakan aplikasi Anda untuk menjangkau layanan Ucapan.

   Contoh:

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

   Jadi URL yang digunakan aplikasi dalam contoh ini adalah:

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

2. Buat instans SpeechConfig dengan menggunakan URL titik akhir lengkap:

   1. Ubah titik akhir yang Anda tentukan, seperti yang dijelaskan di bagian URL titik akhir Konstruksi sebelumnya.

   2. Ubah cara Anda membuat instans SpeechConfig. Kemungkinan besar, aplikasi Anda menggunakan sesuatu seperti ini:

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

      Contoh ini tidak berfungsi untuk sumber daya Ucapan yang mendukung titik akhir privat karena perubahan nama host dan URL yang kami jelaskan di bagian sebelumnya. Jika Anda mencoba menjalankan aplikasi yang ada tanpa modifikasi dengan menggunakan kunci sumber daya yang mendukung titik akhir privat, Anda mendapatkan kesalahan autentikasi (401).

      Untuk membuatnya berfungsi, ubah cara Anda membuat instans kelas SpeechConfig dan gunakan inisialisasi "dari titik akhir"/"dengan titik akhir". Misalkan kita memiliki dua variabel berikut yang didefinisikan:

      • speechKey berisi kunci sumber daya Ucapan yang mendukung titik akhir privat.
      • endPoint berisi URL titik akhir diubah lengkap (menggunakan jenis yang diperlukan oleh bahasa pemrograman yang sesuai). Dalam contoh kami, variabel ini harus berisi:

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

      Buat contoh 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);
      

Tip

Parameter kueri yang ditentukan dalam URI titik akhir tidak berubah, meskipun diatur oleh API lain. Misalnya, jika bahasa pengenalan didefinisikan dalam URI sebagai parameter kueri language=en-US, dan juga diatur ke ru-RU melalui properti yang sesuai, pengaturan bahasa di URI akan digunakan. Bahasa yang efektif adalah en-US.

Parameter yang diatur dalam URI titik akhir selalu diutamakan. API lain hanya dapat mengganti parameter yang tidak ditentukan dalam URI titik akhir.

Setelah modifikasi ini, aplikasi Anda akan bekerja dengan sumber daya Ucapan yang mendukung titik akhir privat. Kita sedang mengerjakan dukungan yang lebih mulus untuk skenario titik akhir pribadi.

Penggunaan Speech Studio

Speech Studio adalah portal web dengan alat untuk membangun dan mengintegrasikan layanan Azure AI Speech di aplikasi Anda. Saat Anda bekerja di proyek Speech Studio, koneksi jaringan dan panggilan API ke sumber daya Ucapan yang sesuai dibuat atas nama Anda. Bekerja dengan titik akhir privat, titik akhir layanan jaringan virtual, dan opsi keamanan jaringan lainnya dapat membatasi ketersediaan fitur Speech Studio. Anda biasanya menggunakan Speech Studio saat bekerja dengan fitur, seperti ucapan kustom, Suara neural kustom, dan Pembuatan Konten Audio.

Menjangkau portal web Speech Studio dari jaringan Virtual

Untuk menggunakan Speech Studio dari mesin virtual dalam jaringan Virtual Azure, Anda harus mengizinkan koneksi keluar ke kumpulan tag layanan yang diperlukan untuk jaringan virtual ini. Lihat detailnya di sini.

Akses ke titik akhir sumber daya Ucapan tidak sama dengan akses ke portal web Speech Studio. Akses ke portal web Speech Studio melalui titik akhir layanan Virtual Network atau pribadi tidak didukung.

Bekerja dengan proyek Speech Studio

Bagian ini menjelaskan bekerja dengan berbagai jenis proyek Speech Studio untuk berbagai opsi keamanan jaringan sumber daya Ucapan. Sambungan browser web ke Speech Studio diharapkan sudah dilakukan. Pengaturan keamanan jaringan sumber daya Ucapan diatur di portal Azure.

1. Buka portal Azure dan masuk ke akun Azure Anda.
2. Pilih sumber daya Ucapan.
3. Di grup Manajemen Sumber Daya di panel kiri, pilih Jaringan>Firewall dan jaringan virtual.
4. Pilih salah satu opsi dari Semua jaringan, Jaringan yang Dipilih dan Titik Akhir Privat, atau Dinonaktifkan.

Ucapan kustom

Tabel berikut ini menjelaskan aksesibilitas proyek ucapan kustom per Firewall Jaringan>sumber daya Ucapan dan pengaturan keamanan jaringan virtual.

Catatan

Jika Anda hanya mengizinkan titik akhir privat melalui tab Jaringan>Koneksi titik akhir privat, maka Anda tidak dapat menggunakan Speech Studio dengan sumber daya Ucapan. Anda masih dapat menggunakan sumber daya Ucapan di luar Speech Studio.

Pengaturan keamanan jaringan sumber daya ucapan	Aksesibilitas proyek Speech Studio
Semua jaringan	Tanpa batasan
Jaringan Yang Dipilih dan Titik Akhir Privat	Dapat diakses dari alamat IP publik yang diizinkan
Nonaktif	Tidak dapat diakses

Jika Anda memilih Jaringan yang Dipilih dan titik akhir privat, Anda akan melihat tab dengan Jaringan virtual dan opsi konfigurasi akses Firewall. Di bagian Firewall, Anda harus mengizinkan setidaknya satu alamat IP publik dan menggunakan alamat ini untuk sambungan browser dengan Speech Studio.

Jika Anda hanya mengizinkan akses melalui Jaringan virtual, maka pada dasarnya Anda tidak mengizinkan akses ke sumber daya Ucapan melalui Speech Studio. Anda masih dapat menggunakan sumber daya Ucapan di luar Speech Studio.

Untuk menggunakan ucapan kustom tanpa melonggarkan pembatasan akses jaringan pada sumber daya Ucapan produksi Anda, pertimbangkan salah satu solusi ini.

• Buat sumber daya Ucapan lain untuk pengembangan yang dapat digunakan pada jaringan publik. Siapkan model kustom Anda di Speech Studio pada sumber daya pengembangan, lalu salin model ke sumber daya produksi Anda. Lihat permintaan REST Models_CopyTo dengan REST API Ucapan ke teks.
• Anda memiliki opsi untuk tidak menggunakan Speech Studio untuk ucapan kustom. Gunakan REST API Ucapan ke teks untuk semua operasi ucapan kustom.

Pembuatan Konten Suara dan Audio Kustom

Anda dapat menggunakan suara kustom dan proyek Audio Content Creation Speech Studio hanya saat pengaturan keamanan jaringan sumber daya Ucapan adalah Semua jaringan.

Sesuaikan aplikasi untuk menggunakan sumber Privat tanpa titik akhir privat

Dalam artikel ini, kami mencatat beberapa kali bahwa mengaktifkan domain kustom untuk sumber daya Ucapan tidak dapat diubah. Sumber daya semacam itu menggunakan cara berkomunikasi yang berbeda dengan layanan Ucapan, dibandingkan dengan yang menggunakan nama titik akhir regional.

Bagian ini menjelaskan cara menggunakan sumber daya Ucapan dengan nama domain kustom tetapi tanpa titik akhir privat dengan REST API layanan Ucapan dan Speech SDK. Ini mungkin sumber daya yang pernah digunakan dalam skenario titik akhir privat, tetapi kemudian titik akhir privatnya dihapus.

Konfigurasi DNS

Ingat bagaimana nama DNS domain kustom dari sumber daya Ucapan yang mendukung titik akhir privat diselesaikan dari jaringan publik. Dalam hal ini, alamat IP yang diselesaikan menunjuk ke titik akhir proksi untuk jaringan virtual. Titik akhir tersebut digunakan untuk mengirimkan lalu lintas jaringan ke sumber daya layanan Azure AI yang mendukung titik akhir privat.

Namun, bila semua titik akhir privat sumber daya dihapus (atau tepat setelah pengaktifan nama domain kustom), data CNAME sumber daya Ucapan akan disediakan ulang. Sekarang menunjuk ke alamat IP titik akhir regional layanan Azure AI yang sesuai.

Jadi output nslookup perintah terlihat seperti ini:

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

Bandingkan dengan output dari bagian ini.

Sumber daya ucapan dengan nama domain kustom dan tanpa titik akhir privat: Penggunaan dengan API REST

REST API ucapan ke teks

Penggunaan REST API ucapan ke teks sepenuhnya setara dengan kasus sumber daya Ucapan yang mendukung titik akhir privat.

REST API ucapan ke teks untuk audio pendek dan REST API Teks ke ucapan

Dalam hal ini, penggunaan REST API Ucapan ke teks untuk audio pendek dan penggunaan REST API Teks ke ucapan tidak memiliki perbedaan dari kasus umum, dengan satu pengecualian. (Lihat catatan berikut.) Anda harus menggunakan kedua API seperti yang dijelaskan dalam rest API Ucapan ke teks untuk dokumentasi REST API audio pendek dan Teks ke ucapan.

Catatan

Saat Anda menggunakan REST API Ucapan ke teks untuk audio pendek dan REST API Teks ke ucapan dalam skenario domain kustom, gunakan kunci sumber daya Ucapan yang diteruskan melalui Ocp-Apim-Subscription-Key header. (Lihat detail untuk REST API ucapan ke teks untuk audio pendek dan REST API Teks ke ucapan)

Menggunakan token otorisasi dan meneruskannya ke titik akhir khusus melalui tajuk Authorization akan berfungsi hanya jika Anda mengaktifkan opsi akses Semua jaringan di Jaringan bagian dari sumber daya Ucapan Anda. Dalam kasus lain, Anda akan mendapatkan kesalahan Forbidden atau BadRequest saat mencoba mendapatkan token otorisasi.

Sumber daya Ucapan dengan nama domain kustom dan tanpa titik akhir privat: Penggunaan dengan Speech SDK

Menggunakan Speech SDK dengan sumber daya Speech dengan domain khusus yang diaktifkan tanpa endpoint pribadi sama dengan kasus umum seperti yang dijelaskan dalam dokumentasi Speech SDK.

Jika Anda telah memodifikasi kode untuk digunakan dengan sumber daya Ucapan yang mendukung titik akhir privat, pertimbangkan hal berikut.

Di bagian sumber daya Ucapan yang mendukung titik akhir privat, kami menjelaskan cara menentukan URL titik akhir, memodifikasinya, dan membuatnya berfungsi melalui inisialisasi "dari titik akhir"/"dengan titik akhir" dari instans kelas SpeechConfig.

Namun, jika Anda mencoba menjalankan aplikasi yang sama setelah semua titik akhir privat dihapus (memungkinkan beberapa waktu untuk penyediaan ulang data DNS yang sesuai), Anda akan mendapatkan kesalahan layanan internal (404). Alasannya adalah bahwa catatan DNS sekarang menunjuk ke titik akhir layanan Azure AI regional alih-alih proksi jaringan virtual, dan jalur URL seperti /stt/speech/recognition/conversation/cognitiveservices/v1?language=en-US tidak ditemukan di sana.

Anda perlu mengembalikan aplikasi Anda ke instansiasi standar SpeechConfig dengan gaya kode berikut:

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

Penggunaan titik akhir privat dan titik akhir layanan Virtual Network secara bersamaan

Anda dapat menggunakan titik akhir privat dan titik akhir layanan Virtual Network untuk mengakses sumber daya Ucapan yang sama secara bersamaan. Untuk mengaktifkan penggunaan serempak ini, Anda harus menggunakan opsi Titik Akhir Privat dan Jaringan yang Dipilih dalam pengaturan jaringan sumber daya Ucapan di portal Azure. Opsi lain tidak didukung untuk skenario ini.

Harga

Untuk detail harga, lihat Harga Azure Private Link.

Pelajari lebih lanjut

• Gunakan layanan Ucapan melalui titik akhir layanan Virtual Network
• Tautan Privat Azure
• Titik akhir layanan Azure VNet
• Speech SDK
• REST API ucapan ke teks
• REST API teks ke ucapan