Partilhar via

Adicionar consentimento do usuário ao projeto de voz pessoal

  • Artigo

Com o recurso de voz pessoal, é necessário que cada voz seja criada com o consentimento explícito do usuário. É necessária uma declaração gravada do usuário reconhecendo que o cliente (proprietário do recurso Azure AI Speech) criará e usará sua voz.

Para adicionar o consentimento do usuário ao projeto de voz pessoal, você fornece o arquivo de áudio de consentimento pré-gravado de um URL acessível publicamente (Consents_Create) ou carrega o arquivo de áudio (Consents_Post).

Você precisa de uma gravação de áudio do usuário falando a declaração de consentimento.

Você pode obter o texto da declaração de consentimento para cada localidade do repositório GitHub de texto para fala. Consulte verbal-statement-all-locales.txt para obter a declaração de consentimento. Abaixo está um exemplo para a en-US localidade:

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

Consulte a tabela abaixo para obter os formatos suportados para arquivos de áudio de consentimento:

Formato Taxa de amostragem Taxa de bits Profundidade de bits
mp3 16 kHz, 24 kHz, 44,1 kHz, 48 kHz 128 kbps, 192 kbps, 256 kbps, 320 kbps /
WAV 16 kHz, 24 kHz, 44,1 kHz, 48 kHz / 16 bits, 24 bits, 32 bits

Nesse cenário, os arquivos de áudio devem estar disponíveis localmente.

Para adicionar consentimento a um projeto de voz pessoal a partir de um arquivo de áudio local, use a Consents_Post operação da API de voz personalizada. Construa o corpo da solicitação de acordo com as seguintes instruções:

  • Defina a propriedade necessária projectId . Consulte Criar um projeto.
  • Defina a propriedade necessária voiceTalentName . O nome do talento de voz não pode ser alterado posteriormente.
  • Defina a propriedade necessária companyName . O nome da empresa não pode ser alterado posteriormente.
  • Defina a propriedade necessária audiodata com o arquivo de áudio de consentimento.
  • Defina a propriedade necessária locale . Este deve ser o local do consentimento. A localidade não pode ser alterada posteriormente. Você pode encontrar a lista de localidades de texto para fala aqui.

Faça uma solicitação HTTP POST usando o URI, conforme mostrado no exemplo a seguir Consents_Post .

  • Substitua YourResourceKey pela chave de recurso de fala.
  • Substitua YourResourceRegion pela região de recursos de Fala.
  • Substitua JessicaConsentId por um ID de consentimento de sua escolha. O ID sensível a maiúsculas e minúsculas será usado no URI do consentimento e não poderá ser alterado posteriormente.
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=2024-02-01-preview"

Deverá receber um corpo de resposta no seguinte formato:

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

O cabeçalho de resposta contém a Operation-Location propriedade. Use este URI para obter detalhes sobre a Consents_Post operação. Aqui está um exemplo do cabeçalho da resposta:

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

Nesse cenário, os arquivos de áudio já devem estar armazenados em um contêiner de Armazenamento de Blob do Azure.

Para adicionar consentimento a um projeto de voz pessoal a partir da URL de um arquivo de áudio, use a operação Consents_Create da API de voz personalizada. Construa o corpo da solicitação de acordo com as seguintes instruções:

  • Defina a propriedade necessária projectId . Consulte Criar um projeto.
  • Defina a propriedade necessária voiceTalentName . O nome do talento de voz não pode ser alterado posteriormente.
  • Defina a propriedade necessária companyName . O nome da empresa não pode ser alterado posteriormente.
  • Defina a propriedade necessária audioUrl . A URL do arquivo de áudio de consentimento de talento de voz. Use um URI com o token de assinaturas de acesso compartilhado (SAS).
  • Defina a propriedade necessária locale . Este deve ser o local do consentimento. A localidade não pode ser alterada posteriormente. Você pode encontrar a lista de localidades de texto para fala aqui.

Faça uma solicitação HTTP PUT usando o URI, conforme mostrado no exemplo de Consents_Create a seguir.

  • Substitua YourResourceKey pela chave de recurso de fala.
  • Substitua YourResourceRegion pela região de recursos de Fala.
  • Substitua JessicaConsentId por um ID de consentimento de sua escolha. O ID sensível a maiúsculas e minúsculas será usado no URI do consentimento e não poderá ser alterado posteriormente.
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=2024-02-01-preview"

Deverá receber um corpo de resposta no seguinte formato:

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

O cabeçalho de resposta contém a Operation-Location propriedade. Use este URI para obter detalhes sobre a operação Consents_Create . Aqui está um exemplo do cabeçalho da resposta:

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

Próximos passos

Crie uma voz pessoal..