Bagikan melalui

Menambahkan persetujuan pengguna ke proyek suara pribadi

  • Artikel

Dengan fitur suara pribadi, diperlukan agar setiap suara dibuat dengan persetujuan eksplisit dari pengguna. Pernyataan yang direkam dari pengguna diperlukan untuk mengakui bahwa pelanggan (pemilik sumber daya Azure AI Speech) akan membuat dan menggunakan suara mereka.

Untuk menambahkan persetujuan pengguna ke proyek suara pribadi, Anda memberikan file audio persetujuan yang telah direkam sebelumnya dari URL yang dapat diakses publik (Consents_Create) atau mengunggah file audio (Consents_Post).

Anda memerlukan rekaman audio pengguna yang mengucapkan pernyataan persetujuan.

Anda bisa mendapatkan teks pernyataan persetujuan untuk setiap lokal dari teks ke repositori GitHub ucapan. Lihat verbal-statement-all-locales.txt untuk pernyataan persetujuan. Di bawah ini adalah sampel untuk en-US lokal:

"I  [state your first and last name] am aware that recordings of my voice will be used by [state the name of the company] to create and use a synthetic version of my voice."

Dalam skenario ini, file audio harus tersedia secara lokal.

Untuk menambahkan persetujuan ke proyek suara pribadi dari file audio lokal, gunakan Consents_Post pengoperasian API suara kustom. Buat isi permintaan sesuai dengan instruksi berikut:

  • Atur properti projectId yang diperlukan. Lihat membuat proyek.
  • Atur properti voiceTalentName yang diperlukan. Nama bakat suara tidak dapat diubah nanti.
  • Atur properti companyName yang diperlukan. Nama perusahaan tidak dapat diubah nanti.
  • Atur properti yang diperlukan audiodata dengan file audio persetujuan.
  • Atur properti locale yang diperlukan. Ini harus menjadi lokal persetujuan. Lokal tidak dapat diubah nanti. Anda dapat menemukan daftar lokal teks ke ucapan di sini.

Buat permintaan HTTP POST menggunakan URI seperti yang ditunjukkan dalam contoh berikut Consents_Post .

  • Ganti YourResourceKey dengan kunci sumber daya Ucapan Anda.
  • Ganti YourResourceRegion dengan wilayah sumber daya Ucapan Anda.
  • Ganti JessicaConsentId dengan ID persetujuan pilihan Anda. ID peka huruf besar/kecil akan digunakan dalam URI persetujuan dan tidak dapat diubah nanti.
curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourResourceKey" -F 'description="Consent for Jessica voice"' -F 'projectId="ProjectId"' -F 'voiceTalentName="Jessica Smith"' -F 'companyName="Contoso"' -F 'audiodata=@"D:\PersonalVoiceTest\jessica-consent.wav"' -F 'locale="en-US"' "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/consents/JessicaConsentId?api-version=2023-12-01-preview"

Anda akan menerima isi respons dalam format berikut:

{
  "id": "JessicaConsentId",
  "description": "Consent for Jessica voice",
  "projectId": "ProjectId",
  "voiceTalentName": "Jessica Smith",
  "companyName": "Contoso",
  "locale": "en-US",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Header respons berisi Operation-Location properti . Gunakan URI ini untuk mendapatkan detail tentang Consents_Post operasi. Berikut adalah contoh header respons:

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/070f7986-ef17-41d0-ba2b-907f0f28e314?api-version=2023-12-01-preview
Operation-Id: 070f7986-ef17-41d0-ba2b-907f0f28e314

Dalam skenario ini, file audio harus sudah disimpan dalam kontainer Azure Blob Storage.

Untuk menambahkan persetujuan ke proyek suara pribadi dari URL file audio, gunakan operasi Consents_Create API suara kustom. Buat isi permintaan sesuai dengan instruksi berikut:

  • Atur properti projectId yang diperlukan. Lihat membuat proyek.
  • Atur properti voiceTalentName yang diperlukan. Nama bakat suara tidak dapat diubah nanti.
  • Atur properti companyName yang diperlukan. Nama perusahaan tidak dapat diubah nanti.
  • Atur properti audioUrl yang diperlukan. URL file audio persetujuan talenta suara. Gunakan URI dengan token tanda tangan akses bersama (SAS ).
  • Atur properti locale yang diperlukan. Ini harus menjadi lokal persetujuan. Lokal tidak dapat diubah nanti. Anda dapat menemukan daftar lokal teks ke ucapan di sini.

Buat permintaan HTTP PUT menggunakan URI seperti yang ditunjukkan dalam contoh Consents_Create berikut.

  • Ganti YourResourceKey dengan kunci sumber daya Ucapan Anda.
  • Ganti YourResourceRegion dengan wilayah sumber daya Ucapan Anda.
  • Ganti JessicaConsentId dengan ID persetujuan pilihan Anda. ID peka huruf besar/kecil akan digunakan dalam URI persetujuan dan tidak dapat diubah nanti.
curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "Content-Type: application/json" -d '{
  "description": "Consent for Jessica voice",
  "projectId": "ProjectId",
  "voiceTalentName": "Jessica Smith",
  "companyName": "Contoso",
  "audioUrl": "https://contoso.blob.core.windows.net/public/jessica-consent.wav?mySasToken",
  "locale": "en-US"
} '  "https://YourResourceRegion.api.cognitive.microsoft.com/customvoice/consents/JessicaConsentId?api-version=2023-12-01-preview"

Anda akan menerima isi respons dalam format berikut:

{
  "id": "JessicaConsentId",
  "description": "Consent for Jessica voice",
  "projectId": "ProjectId",
  "voiceTalentName": "Jessica Smith",
  "companyName": "Contoso",
  "locale": "en-US",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Header respons berisi Operation-Location properti . Gunakan URI ini untuk mendapatkan detail tentang operasi Consents_Create . Berikut adalah contoh header respons:

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/070f7986-ef17-41d0-ba2b-907f0f28e314?api-version=2023-12-01-preview
Operation-Id: 070f7986-ef17-41d0-ba2b-907f0f28e314

Langkah berikutnya

Buat suara pribadi..