Menyebarkan dan menggunakan model suara Anda
Setelah berhasil membuat dan menguji model suara, sebarkan di titik akhir suara neural kustom. Gunakan titik akhir suara neural kustom bukan titik akhir teks ke ucapan yang biasa untuk permintaan dengan REST API. Gunakan Speech Studio untuk membuat titik akhir suara neural kustom. Gunakan REST API untuk menangguhkan atau melanjutkan titik akhir suara neural kustom.
Catatan
Lihat Jenis proyek Suara Neural Kustom untuk mengetahui informasi tentang kemampuan, persyaratan, dan perbedaan antara Suara Neural Kustom Pro dan Suara Neural Kustom Lite. Artikel ini berfokus pada pembuatan Suara Neural Kustom profesional menggunakan proyek Pro.
Membuat dan menggunakan titik akhir suara neural kustom
Untuk membuat titik akhir suara neural kustom:
- Di tab Sebarkan model, pilih Sebarkan model.
- Pilih model suara yang ingin Ada hubungkan dengan titik akhir ini.
- Selanjutnya, masukkan Nama dan Deskripsi untuk titik akhir kustom Anda.
- Terakhir, pilih Sebarkan untuk membuat titik akhir Anda.
Di tabel titik akhir, Anda sekarang melihat entri untuk titik akhir baru. Pembuatan titik akhir baru mungkin memerlukan waktu beberapa menit. Jika status penyebaran Berhasil, titik akhir siap digunakan.
Anda dapat menangguhkan dan melanjutkan titik akhir jika tidak menggunakannya sepanjang waktu. Jika titik akhir diaktifkan kembali setelah ditangguhkan, URL titik akhir akan disimpan sehingga Anda tidak perlu mengubah kode di aplikasi Anda.
Anda juga dapat memperbarui titik akhir ke model baru. Untuk mengubah model, pastikan model baru diberi nama yang sama dengan model yang ingin diperbarui.
Catatan
- Pengguna langganan standar (S0) dapat membuat hingga 50 titik akhir, masing-masing dengan suara neural kustomnya sendiri.
- Untuk menggunakan suara neural kustom, Anda harus menentukan nama model suara, menggunakan URI kustom langsung dalam permintaan HTTP, dan menggunakan langganan yang sama untuk melewati autentikasi layanan teks ke ucapan.
Setelah titik akhir Anda disebarkan, nama titik akhir muncul sebagai tautan. Pilih tautan untuk menampilkan informasi khusus titik akhir, seperti kunci titik akhir, URL titik akhir, dan kode sampel.
Dari segi fungsi, titik akhir kustom sama dengan titik akhir standar yang digunakan untuk permintaan teks ke ucapan. Untuk informasi selengkapnya, lihat Speech SDK atau REST API.
Pembuatan Konten Audio adalah alat yang memungkinkan Anda menyetel output audio menggunakan UI yang mudah dioperasikan.
Menyalin model suara Anda ke proyek lain
Anda dapat menyalin model suara ke proyek lain untuk wilayah yang sama atau wilayah lain. Misalnya, Anda dapat menyalin model suara neural yang dilatih di satu wilayah, ke suatu proyek untuk wilayah lain.
Catatan
Pelatihan suara saraf khusus hanya tersedia di wilayah ini: US Timur, Asia Tenggara, dan UK Selatan. Namun, Anda dapat menyalin model suara neural dari wilayah tersebut ke wilayah lain. Untuk informasi selengkapnya, lihat wilayah untuk suara neural kustom.
Untuk menyalin model suara neural kustom Anda ke proyek lain:
Di tab Latih model, pilih model suara yang ingin disalin, lalu pilih Salin ke proyek.
Pilih Wilayah, Sumber daya Ucapan, dan Proyek tempat Anda ingin menyalin model tersebut. Anda harus memiliki sumber daya ucapan dan proyek di wilayah target, jika tidak, Anda perlu membuatnya terlebih dahulu.
Pilih Kirim untuk menyalin model tersebut.
Pilih Tampilkan model di bawah pesan notifikasi untuk mengetahui keberhasilan penyalinan.
Di tab Latih model, pilih model yang baru disalin, lalu pilih Sebarkan model.
Beralih ke model suara baru di produk Anda
Setelah memperbarui model suara ke versi mesin terbaru, atau jika Anda ingin beralih ke suara baru di produk, Anda perlu menyebarkan ulang model suara baru ke titik akhir baru. Penyebaran ulang model suara baru di titik akhir yang ada tidak didukung. Setelah penyebaran, alihkan lalu lintas ke titik akhir yang baru dibuat. Kami menyarankan agar Anda mentransfer lalu lintas ke titik akhir baru di lingkungan pengujian terlebih dahulu untuk memastikan bahwa lalu lintas berfungsi dengan baik, lalu mentransfer ke titik akhir baru di lingkungan produksi. Selama transisi, Anda perlu menyimpan titik akhir lama. Jika ada beberapa masalah dengan titik akhir baru selama transisi, Anda dapat beralih kembali ke titik akhir lama Anda. Jika lalu lintas telah berjalan dengan baik di titik akhir baru selama sekitar 24 jam (nilai yang disarankan), Anda dapat menghapus titik akhir lama Anda.
Catatan
Jika nama suara Anda diubah dan Anda menggunakan Speech Synthesis Markup Language (SSML), pastikan untuk menggunakan nama suara baru di SSML.
Menangguhkan dan melanjutkan titik akhir
Anda dapat menangguhkan atau melanjutkan titik akhir, untuk membatasi pembelanjaan dan menghemat sumber daya yang tidak digunakan. Anda tidak akan dikenakan biaya saat titik akhir ditangguhkan. Saat melanjutkan titik akhir, Anda dapat menggunakan URL titik akhir yang sama di aplikasi untuk mensintesis ucapan.
Anda dapat menangguhkan dan melanjutkan titik akhir di Speech Studio atau melalui REST API.
Catatan
Operasi suspend akan segera selesai. Operasi resume akan selesai dalam waktu yang sama dengan penyebaran baru.
Menangguhkan dan melanjutkan titik akhir di Speech Studio
Bagian ini menjelaskan cara menangguhkan atau melanjutkan titik akhir suara neural kustom di portal Speech Studio.
Menangguhkan titik akhir
Untuk menangguhkan dan menonaktifkan titik akhir Anda, pilih Tangguhkan dari tab Sebarkan model di Speech Studio.
Dalam kotak dialog yang muncul, pilih Kirim. Setelah titik akhir ditangguhkan, Studio Ucapan akan menampilkan notifikasi titik akhir yang berhasil ditangguhkan.
Melanjutkan titik akhir
Untuk melanjutkan dan mengaktifkan titik akhir Anda, pilih Lanjutkan dari tab Sebarkan model di Speech Studio.
Dalam kotak dialog yang muncul, pilih Kirim. Setelah Anda berhasil mengaktifkan kembali titik akhir, statusnya akan berubah dari Ditangguhkan menjadi Berhasil.
Menangguhkan dan melanjutkan titik akhir melalui REST API
Bagian ini akan menunjukkan kepada Anda cara mendapatkan, menangguhkan, atau melanjutkan titik akhir suara neural kustom melalui REST API.
Pengaturan aplikasi
Setelan aplikasi yang Anda gunakan sebagai REST API parameter permintaan tersedia di tab Sebarkan model di Speech Studio.
- Kunci titik akhir menunjukkan kunci langganan yang dikaitkan dengan titik akhir tersebut. Gunakan kunci titik akhir sebagai nilai header permintaan Anda
Ocp-Apim-Subscription-Key. - URL Titik Akhir menampilkan wilayah layanan Anda. Gunakan nilai yang mendahului
voice.speech.microsoft.comsebagai parameter permintaan wilayah layanan Anda. Misalnya, gunakaneastusjika URL titik akhirnya adalahhttps://eastus.voice.speech.microsoft.com/cognitiveservices/v1. - URL Titik Akhir menunjukkan ID Titik Akhir. Gunakan nilai yang ditambahkan ke parameter kueri
?deploymentId=sebagai nilai parameter permintaan ID titik akhir Anda.
Mendapatkan titik akhir
Dapatkan titik akhir berdasarkan ID titik akhir. Operasi ini menampilkan detail tentang titik akhir seperti ID model, ID proyek, dan status.
Misalnya, Anda mungkin ingin melacak perkembangan status untuk operasi suspend atau resume. Gunakan properti status dalam payload respons untuk menentukan status titik akhir.
Kemungkinan nilai properti status adalah:
| Status | Deskripsi |
|---|---|
NotStarted |
Titik akhir belum disebarkan, dan tidak tersedia untuk sintesis ucapan. |
Running |
Titik akhir sedang dalam proses disebarkan atau dilanjutkan, dan tidak tersedia untuk sintesis ucapan. |
Succeeded |
Titik akhir aktif dan tersedia untuk sintesis ucapan. Titik akhir telah disebarkan atau operasi resume berhasil. |
Failed |
Operasi deploy atau suspend titik akhir gagal. Titik akhir hanya dapat dilihat atau dihapus di Speech Studio. |
Disabling |
Titik akhir sedang dalam proses ditangguhkan, dan tidak tersedia untuk sintesis ucapan. |
Disabled |
Titik akhir tidak aktif, dan tidak tersedia untuk sintesis ucapan. Operasi deploy berhasil atau operasi resume gagal. |
Tip
Jika statusnya Failed atau Disabled, periksa properties.error pesan kesalahan terperinci. Namun, tidak akan ada detail kesalahan jika statusnya adalah Disabled karena operasi suspend yang berhasil.
Mendapatkan contoh titik akhir
Untuk informasi selengkapnya tentang ID titik akhir, wilayah, dan parameter kunci langganan, lihat parameter permintaan.
Contoh HTTP:
GET api/texttospeech/v3.0/endpoints/<YourEndpointId> HTTP/1.1
Ocp-Apim-Subscription-Key: YourSubscriptionKey
Host: <YourServiceRegion>.customvoice.api.speech.microsoft.com
Contoh cURL:
curl -v -X GET "https://<YourServiceRegion>.customvoice.api.speech.microsoft.com/api/texttospeech/v3.0/endpoints/<YourEndpointId>" -H "Ocp-Apim-Subscription-Key: <YourSubscriptionKey >"
Contoh header respons:
Status code: 200 OK
Contoh badan respons:
{
"model": {
"id": "a92aa4b5-30f5-40db-820c-d2d57353de44"
},
"project": {
"id": "ffc87aba-9f5f-4bfa-9923-b98186591a79"
},
"properties": {},
"status": "Succeeded",
"lastActionDateTime": "2019-01-07T11:36:07Z",
"id": "e7ffdf12-17c7-4421-9428-a7235931a653",
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"name": "Voice endpoint",
"description": "Example for voice endpoint"
}
Menangguhkan titik akhir
Anda dapat menangguhkan titik akhir untuk membatasi pembelanjaan dan menghemat sumber daya yang tidak digunakan. Anda tidak akan dikenakan biaya saat titik akhir ditangguhkan. Saat melanjutkan titik akhir, Anda dapat menggunakan URL titik akhir yang sama di aplikasi untuk mensintesis ucapan.
Anda menangguhkan titik akhir dengan ID penyebaran uniknya. Status titik akhir harus Succeeded agar Anda dapat menangguhkannya.
Gunakan operasi get endpoint untuk melakukan polling dan melacak perkembangan status dari Succeeded, ke Disabling, dan akhirnya ke Disabled.
Menangguhkan contoh titik akhir
Untuk informasi selengkapnya tentang ID titik akhir, wilayah, dan parameter kunci langganan, lihat parameter permintaan.
Contoh HTTP:
POST api/texttospeech/v3.0/endpoints/<YourEndpointId>/suspend HTTP/1.1
Ocp-Apim-Subscription-Key: YourSubscriptionKey
Host: <YourServiceRegion>.customvoice.api.speech.microsoft.com
Content-Type: application/json
Content-Length: 0
Contoh cURL:
curl -v -X POST "https://<YourServiceRegion>.customvoice.api.speech.microsoft.com/api/texttospeech/v3.0/endpoints/<YourEndpointId>/suspend" -H "Ocp-Apim-Subscription-Key: <YourSubscriptionKey >" -H "content-type: application/json" -H "content-length: 0"
Contoh header respons:
Status code: 202 Accepted
Untuk informasi selengkapnya, lihat header respons.
Melanjutkan titik akhir
Saat melanjutkan titik akhir, Anda dapat menggunakan URL titik akhir yang sama dengan yang Anda gunakan sebelum ditangguhkan.
Anda melanjutkan titik akhir dengan ID penyebaran uniknya. Status titik akhir harus Disabled agar Anda dapat melanjutkannya.
Gunakan operasi get endpoint untuk melakukan polling dan melacak perkembangan status dari Disabled, ke Running, dan akhirnya ke Succeeded. Jika operasi resume gagal, status titik akhir akan menjadi Disabled.
Contoh titik akhir resume
Untuk informasi selengkapnya tentang ID titik akhir, wilayah, dan parameter kunci langganan, lihat parameter permintaan.
Contoh HTTP:
POST api/texttospeech/v3.0/endpoints/<YourEndpointId>/resume HTTP/1.1
Ocp-Apim-Subscription-Key: YourSubscriptionKey
Host: <YourServiceRegion>.customvoice.api.speech.microsoft.com
Content-Type: application/json
Content-Length: 0
Contoh cURL:
curl -v -X POST "https://<YourServiceRegion>.customvoice.api.speech.microsoft.com/api/texttospeech/v3.0/endpoints/<YourEndpointId>/resume" -H "Ocp-Apim-Subscription-Key: <YourSubscriptionKey >" -H "content-type: application/json" -H "content-length: 0"
Contoh header respons:
Status code: 202 Accepted
Untuk informasi selengkapnya, lihat header respons.
Parameter dan kode respons
Parameter permintaan
Anda menggunakan parameter permintaan ini dengan panggilan ke REST API. Lihat pengaturan aplikasi untuk informasi tentang tempat mendapatkan wilayah, ID titik akhir, dan kunci langganan Anda di Speech Studio.
| Nama | Lokasi | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
YourServiceRegion |
Jalur | True |
string | Wilayah Azure yang dikaitkan dengan titik akhir. |
YourEndpointId |
Jalur | True |
string | Pengidentifikasi unik dari titik akhir. |
Ocp-Apim-Subscription-Key |
Header | True |
string | Kunci langganan yang dikaitkan dengan titik akhir. |
Header respons
Kode status: 202 Accepted
| Nama | Jenis | Deskripsi |
|---|---|---|
Location |
string | Lokasi titik akhir yang dapat digunakan sebagai URL lengkap untuk mendapatkan titik akhir. |
Retry-After |
string | Total detik interval yang disarankan untuk mencoba kembali mendapatkan status titik akhir. |
Kode status HTTP
Kode status HTTP untuk setiap respons menunjukkan keberhasilan atau kesalahan umum.
| Kode status HTTP | Deskripsi | Kemungkinan alasan |
|---|---|---|
| 200 | OK | Permintaan berhasil. |
| 202 | Diterima | Permintaan telah diterima dan sedang diproses. |
| 400 | Permintaan Buruk | Nilai parameter tidak valid, atau parameter yang diperlukan hilang, kosong, atau null. Salah satu masalah umum adalah header yang terlalu panjang. |
| 401 | Tidak diizinkan | Permintaan tersebut tidak diotorisasi. Periksa untuk memastikan kunci langganan atau token Anda valid dan di wilayah yang benar. |
| 429 | Terlalu Banyak Permintaan | Anda telah melebihi kuota atau tarif permintaan yang diizinkan untuk langganan Anda. |
| 502 | Gateway buruk | Masalah jaringan atau sisi server. Mungkin juga menunjukkan header yang tidak valid. |