Compartilhar via

Adicionar o consentimento do usuário ao projeto de voz pessoal

  • Artigo

Com o recurso de voz pessoal, é necessário que cada voz seja criada com consentimento explícito do usuário. Uma instrução gravada do usuário é necessária reconhecendo que o cliente (proprietário do recurso da Fala de IA do Azure) criará e usará sua voz.

Para adicionar o consentimento do usuário ao projeto de voz pessoal, forneça o arquivo de áudio de consentimento pré-gravado de uma URL acessível publicamente (Consents_Create) ou carregue 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 instrução de consentimento para cada localidade do repositório GitHub de texto em fala. Consulte verbal-statement-all-locales.txt para obter a instrução de consentimento. Veja abaixo um exemplo para a localidade en-US:

"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 com suporte para arquivos de áudio de consentimento:

Formatar Taxa de amostragem Taxa de bits Profundidade de bits
mp3 16 kHz, 24 kHz, 44.1 kHz e 48 kHz 128 kbps, 192 kbps, 256 kbps e 320 kbps /
WAV 16 kHz, 24 kHz, 44.1 kHz e 48 kHz / 16 bits, 24 bits e 32 bits

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

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

  • Defina a propriedade projectId necessária. Consulte Criar um projeto.
  • Defina a propriedade voiceTalentName obrigatória. O nome do talento de voz não pode ser alterado mais tarde.
  • Defina a propriedade companyName obrigatória. O nome da empresa não pode ser alterado mais tarde.
  • Defina a propriedade audiodata necessária com o arquivo de áudio de consentimento.
  • Defina a propriedade locale obrigatória. Essa deve ser a localidade do consentimento. Ela não poderá ser alterada posteriormente. Você pode encontrar a lista de localidades de conversão de texto em fala aqui.

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

  • Substitua YourResourceKey pela chave do recurso de Fala.
  • Substitua YourResourceRegion pela região do Recurso de Fala.
  • Substitua JessicaConsentId por uma ID de consentimento de sua escolha. A ID que diferencia maiúsculas e minúsculas será usada no URI do modelo e não poderá ser alterada 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"

Você deve 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 propriedade Operation-Location. Use esse URI para obter detalhes sobre a operação Consents_Post. 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 do Armazenamento de Blobs do Azure.

Para adicionar consentimento a um projeto de voz pessoal 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 projectId necessária. Consulte Criar um projeto.
  • Defina a propriedade voiceTalentName obrigatória. O nome do talento de voz não pode ser alterado mais tarde.
  • Defina a propriedade companyName obrigatória. O nome da empresa não pode ser alterado mais tarde.
  • Defina a propriedade audioUrl obrigatória. A URL do arquivo de áudio de consentimento do talento de voz. Use um URI com o token de assinaturas de acesso compartilhado (SAS).
  • Defina a propriedade locale obrigatória. Essa deve ser a localidade do consentimento. Ela não poderá ser alterada posteriormente. Você pode encontrar a lista de localidades de conversão de texto em 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 do recurso de Fala.
  • Substitua YourResourceRegion pela região do Recurso de Fala.
  • Substitua JessicaConsentId por uma ID de consentimento de sua escolha. A ID que diferencia maiúsculas e minúsculas será usada no URI do modelo e não poderá ser alterada 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"

Você deve 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 propriedade Operation-Location. Use esse 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óximas etapas

Criar uma voz pessoal..