Menyebarkan model ucapan kustom
Dalam artikel ini, Anda mempelajari cara menyebarkan titik akhir untuk model ucapan kustom. Kecuali untuk transkripsi batch, Anda harus menyebarkan titik akhir kustom untuk menggunakan model ucapan kustom.
Tip
Titik akhir penyebaran yang dihosting tidak diperlukan untuk menggunakan ucapan kustom dengan API transkripsi Batch. Anda dapat menghemat sumber daya jika model ucapan kustom hanya digunakan untuk transkripsi batch. Untuk informasi selengkapnya, lihat Harga layanan Azure Cognitive Service untuk Ucapan.
Anda dapat menyebarkan titik akhir untuk model dasar atau kustom, lalu memperbarui titik akhir nanti untuk menggunakan model terlatih yang lebih baik.
Catatan
Titik akhir yang digunakan oleh F0
sumber daya Ucapan dihapus setelah tujuh hari.
Tambahkan titik akhir penyebaran
Untuk membuat pemeriksaan kustom, ikuti langkah-langkah ini:
Masuk ke Speech Studio.
Pilih Ucapan> kustom Nama >proyek Anda Sebarkan model.
Jika ini adalah titik akhir pertama Anda, Anda melihat bahwa tidak ada titik akhir yang tercantum dalam tabel. Setelah Anda membuat titik akhir, Anda menggunakan halaman ini untuk melacak setiap titik akhir yang disebarkan.
Pilih Sebarkan model untuk memulai wizard titik akhir baru.
Pilih halaman Titik akhir baru, dan masukkan nama dan deskripsi untuk titik akhir kustom Anda.
Pilih model kustom yang ingin Anda kaitkan dengan titik akhir.
Secara opsional, Anda dapat mencentang kotak untuk mengaktifkan pembuatan log audio dan diagnostik lalu lintas titik akhir.
Pilih Tambahkan untuk menyimpan dan menyebarkan titik akhir.
Pada halaman Sebarkan model utama, detail tentang titik akhir baru ditampilkan dalam tabel, seperti nama, deskripsi, status, dan tanggal kedaluwarsa. Dibutuhkan waktu hingga 30 menit untuk membuat instans titik akhir baru yang menggunakan model kustom Anda. Ketika status penyebaran berubah menjadi Berhasil, titik akhir siap digunakan.
Penting
Perhatikan tanggal kedaluwarsa model. Ini merupakan tanggal terakhir Anda dapat menggunakan model kustom untuk pengenalan ucapan. Untuk informasi selengkapnya, lihat Siklus hidup model dan titik akhir.
Pilih tautan titik akhir untuk melihat informasi khusus titik akhir, seperti kunci titik akhir, URL titik akhir, dan kode sampel.
Untuk membuat titik akhir dan menyebarkan model, gunakan perintah spx csr endpoint create
. Buat parameter permintaan sesuai dengan instruksi berikut:
- Atur parameter
project
ke ID proyek yang ada. Ini disarankan agar Anda dapat melihat dan mengelola titik akhir di Speech Studio. Anda dapat menjalankan perintahspx csr project list
untuk mendapatkan proyek yang tersedia. - Atur parameter
model
yang diperlukan ke ID model yang ingin Anda sebarkan ke titik akhir. - Atur parameter
language
yang diperlukan. Lokal titik akhir harus cocok dengan lokal model. Lokal tidak dapat diubah nanti. Parameterlanguage
Speech CLI sesuai dengan propertilocale
dalam permintaan dan respons JSON. - Atur parameter
name
yang diperlukan. Ini adalah nama yang ditampilkan di Speech Studio. Parametername
Speech CLI sesuai dengan propertidisplayName
dalam permintaan dan respons JSON. - Secara opsional, Anda dapat mengatur parameter
logging
. Atur ini keenabled
untuk mengaktifkan pengelogan audio dan diagnostik lalu lintas titik akhir. Default adalahfalse
.
Berikut adalah contoh perintah Speech CLI untuk membuat titik akhir dan menyebarkan model:
spx csr endpoint create --api-version v3.1 --project YourProjectId --model YourModelId --name "My Endpoint" --description "My Endpoint Description" --language "en-US"
Anda akan menerima isi respons dalam format berikut:
{
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
"model": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
},
"links": {
"logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
"restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
},
"project": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/d40f2eb8-1abf-4f72-9008-a5ae8add82a4"
},
"properties": {
"loggingEnabled": true
},
"lastActionDateTime": "2022-05-19T15:27:51Z",
"status": "NotStarted",
"createdDateTime": "2022-05-19T15:27:51Z",
"locale": "en-US",
"displayName": "My Endpoint",
"description": "My Endpoint Description"
}
Properti self
tingkat atas dalam isi respons adalah URI titik akhir. Gunakan URI ini untuk mendapatkan detail tentang proyek, model, dan log titik akhir. Anda juga menggunakan URI ini untuk memperbarui titik akhir.
Untuk bantuan Speech CLI dengan titik akhir, jalankan perintah berikut:
spx help csr endpoint
Untuk membuat titik akhir dan menyebarkan model, gunakan operasi Endpoints_Create Ucapan ke REST API teks. Buat isi permintaan sesuai dengan instruksi berikut:
- Atur properti
project
ke URI proyek yang ada. Ini disarankan agar Anda dapat melihat dan mengelola titik akhir di Speech Studio. Anda dapat membuat permintaan Projects_List untuk mendapatkan proyek yang tersedia. - Atur properti
model
yang diperlukan ke model URI yang ingin Anda sebarkan ke titik akhir. - Atur properti
locale
yang diperlukan. Lokal titik akhir harus cocok dengan lokal model. Lokal tidak dapat diubah nanti. - Atur properti
displayName
yang diperlukan. Ini adalah nama yang ditampilkan di Speech Studio. - Secara opsional, Anda dapat mengatur properti
loggingEnabled
dalamproperties
. Atur ini ketrue
untuk mengaktifkan pengelogan audio dan diagnostik lalu lintas titik akhir. Default adalahfalse
.
Buat permintaan HTTP POST menggunakan URI seperti yang ditunjukkan dalam contoh Endpoints_Create berikut. Ganti YourSubscriptionKey
dengan kunci sumber daya Ucapan Anda, ganti YourServiceRegion
dengan wilayah sumber daya Ucapan Anda, dan atur properti isi permintaan seperti yang dijelaskan sebelumnya.
curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
"project": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/d40f2eb8-1abf-4f72-9008-a5ae8add82a4"
},
"properties": {
"loggingEnabled": true
},
"displayName": "My Endpoint",
"description": "My Endpoint Description",
"model": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
},
"locale": "en-US",
}' "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints"
Anda akan menerima isi respons dalam format berikut:
{
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
"model": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
},
"links": {
"logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
"restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
},
"project": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/d40f2eb8-1abf-4f72-9008-a5ae8add82a4"
},
"properties": {
"loggingEnabled": true
},
"lastActionDateTime": "2022-05-19T15:27:51Z",
"status": "NotStarted",
"createdDateTime": "2022-05-19T15:27:51Z",
"locale": "en-US",
"displayName": "My Endpoint",
"description": "My Endpoint Description"
}
Properti self
tingkat atas dalam isi respons adalah URI titik akhir. Gunakan URI ini untuk mendapatkan detail tentang proyek, model, dan log titik akhir. Anda juga menggunakan URI ini untuk memperbarui atau menghapus titik akhir.
Mengubah model dan menyebarkan ulang titik akhir
Titik akhir dapat diperbarui untuk menggunakan model lain yang dibuat oleh sumber daya Ucapan yang sama. Seperti yang disebutkan sebelumnya, Anda harus memperbarui model titik akhir sebelum model kedaluwarsa.
Untuk menggunakan model baru dan menyebarkan ulang titik akhir kustom:
- Masuk ke Speech Studio.
- Pilih Ucapan> kustom Nama >proyek Anda Sebarkan model.
- Pilih tautan ke titik akhir menurut nama, lalu pilih Ubah model.
- Pilih model baru yang Anda inginkan untuk digunakan di titik akhir.
- Pilih Selesai untuk menyimpan dan menyebarkan ulang titik akhir.
Untuk menyebarkan ulang titik akhir kustom dengan model baru, gunakan perintah spx csr model update
. Buat parameter permintaan sesuai dengan instruksi berikut:
- Atur parameter
endpoint
yang diperlukan ke ID titik akhir yang ingin Anda sebarkan. - Atur parameter
model
yang diperlukan ke ID model yang ingin Anda sebarkan ke titik akhir.
Berikut adalah contoh perintah Speech CLI yang menyebarkan ulang titik akhir kustom dengan model baru:
spx csr endpoint update --api-version v3.1 --endpoint YourEndpointId --model YourModelId
Anda akan menerima isi respons dalam format berikut:
{
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
"model": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
},
"links": {
"logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
"restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
},
"project": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/639d5280-8995-40cc-9329-051fd0fddd46"
},
"properties": {
"loggingEnabled": true
},
"lastActionDateTime": "2022-05-19T23:01:34Z",
"status": "NotStarted",
"createdDateTime": "2022-05-19T15:41:27Z",
"locale": "en-US",
"displayName": "My Endpoint",
"description": "My Updated Endpoint Description"
}
Untuk bantuan Speech CLI dengan titik akhir, jalankan perintah berikut:
spx help csr endpoint
Untuk menyebarkan ulang titik akhir kustom dengan model baru, gunakan operasi Endpoints_Update REST API Ucapan ke teks. Buat isi permintaan sesuai dengan instruksi berikut:
- Atur properti
model
ke URI model yang ingin Anda sebarkan ke titik akhir.
Buat permintaan HTTP PATCH menggunakan URI seperti yang ditunjukkan dalam contoh berikut. Ganti YourSubscriptionKey
dengan kunci sumber daya Ucapan, ganti YourServiceRegion
dengan wilayah sumber daya Ucapan, ganti YourEndpointId
dengan ID titik akhir Anda, dan atur properti permintaan seperti yang dijelaskan sebelumnya.
curl -v -X PATCH -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
"model": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
}
}' "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/YourEndpointId"
Anda akan menerima isi respons dalam format berikut:
{
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
"model": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
},
"links": {
"logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
"restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
},
"project": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/639d5280-8995-40cc-9329-051fd0fddd46"
},
"properties": {
"loggingEnabled": true
},
"lastActionDateTime": "2022-05-19T23:01:34Z",
"status": "NotStarted",
"createdDateTime": "2022-05-19T15:41:27Z",
"locale": "en-US",
"displayName": "My Endpoint",
"description": "My Updated Endpoint Description"
}
Penyebaran ulang memerlukan waktu beberapa menit untuk menyelesaikan. Sementara itu, titik akhir Anda menggunakan model sebelumnya tanpa gangguan layanan.
Tampilkan pembuatan log data
Pembuatan log data tersedia untuk diekspor jika Anda mengonfigurasinya saat membuat titik akhir.
Untuk mengunduh log titik akhir:
- Masuk ke Speech Studio.
- Pilih Ucapan> kustom Nama >proyek Anda Sebarkan model.
- Pilih tautan menurut nama titik akhir.
- Di bawah Pembuatan log konten, pilih Unduh log.
Untuk mendapatkan log untuk titik akhir, gunakan spx csr endpoint list
perintah . Buat parameter permintaan sesuai dengan instruksi berikut:
- Atur parameter
endpoint
yang diperlukan ke ID titik akhir yang ingin Anda dapatkan lognya.
Berikut adalah contoh perintah Speech CLI yang mendapatkan log di titik akhir:
spx csr endpoint list --api-version v3.1 --endpoint YourEndpointId
Lokasi setiap file log dengan detail lebih lanjut dikembalikan dalam isi respons.
Untuk mendapatkan log untuk titik akhir, mulailah dengan menggunakan operasi Endpoints_Get REST API Ucapan ke teks.
Buat permintaan HTTP GET menggunakan URI seperti yang ditunjukkan dalam contoh berikut. Ganti YourEndpointId
dengan ID titik akhir, ganti YourSubscriptionKey
dengan kunci sumber daya Ucapan, dan ganti YourServiceRegion
dengan wilayah sumber daya Ucapan.
curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/YourEndpointId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
Anda akan menerima isi respons dalam format berikut:
{
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
"model": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
},
"links": {
"logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
"restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
"webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
},
"project": {
"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/2f78cdb7-58ac-4bd9-9bc6-170e31483b26"
},
"properties": {
"loggingEnabled": true
},
"lastActionDateTime": "2022-05-19T23:41:05Z",
"status": "Succeeded",
"createdDateTime": "2022-05-19T23:41:05Z",
"locale": "en-US",
"displayName": "My Endpoint",
"description": "My Updated Endpoint Description"
}
Buat permintaan HTTP GET menggunakan URI "log" dari isi respons sebelumnya. Ganti YourEndpointId
dengan ID titik akhir, ganti YourSubscriptionKey
dengan kunci sumber daya Ucapan, dan ganti YourServiceRegion
dengan wilayah sumber daya Ucapan.
curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/YourEndpointId/files/logs" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
Lokasi setiap file log dengan detail lebih lanjut dikembalikan dalam isi respons.
Data pengelogan tersedia di penyimpanan milik Microsoft selama 30 hari, lalu dihapus. Jika akun penyimpanan Anda sendiri ditautkan ke langganan layanan Azure AI, data pengelogan tidak dihapus secara otomatis.
Langkah berikutnya
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk