Menyebarkan model ucapan kustom

  • Artikel

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:

  1. Masuk ke Speech Studio.

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

  3. Pilih Sebarkan model untuk memulai wizard titik akhir baru.

  4. Pilih halaman Titik akhir baru, dan masukkan nama dan deskripsi untuk titik akhir kustom Anda.

  5. Pilih model kustom yang ingin Anda kaitkan dengan titik akhir.

  6. Secara opsional, Anda dapat mencentang kotak untuk mengaktifkan pembuatan log audio dan diagnostik lalu lintas titik akhir.

    Cuplikan layar halaman titik akhir baru yang menunjukkan kotak centang untuk mengaktifkan logging.

  7. 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 perintah spx 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. Parameter language Speech CLI sesuai dengan properti locale dalam permintaan dan respons JSON.
  • Atur parameter name yang diperlukan. Ini adalah nama yang ditampilkan di Speech Studio. Parameter name Speech CLI sesuai dengan properti displayName dalam permintaan dan respons JSON.
  • Secara opsional, Anda dapat mengatur parameter logging. Atur ini ke enabled untuk mengaktifkan pengelogan audio dan diagnostik lalu lintas titik akhir. Default adalah false.

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 dalam properties. Atur ini ke true untuk mengaktifkan pengelogan audio dan diagnostik lalu lintas titik akhir. Default adalah false.

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:

  1. Masuk ke Speech Studio.
  2. Pilih Ucapan> kustom Nama >proyek Anda Sebarkan model.
  3. Pilih tautan ke titik akhir menurut nama, lalu pilih Ubah model.
  4. Pilih model baru yang Anda inginkan untuk digunakan di titik akhir.
  5. 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:

  1. Masuk ke Speech Studio.
  2. Pilih Ucapan> kustom Nama >proyek Anda Sebarkan model.
  3. Pilih tautan menurut nama titik akhir.
  4. 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