Compartir a través de

Agregue el consentimiento del usuario al proyecto de voz personal

  • Artículo

Con la característica de voz personal, es necesario que cada voz se cree con consentimiento explícito del usuario. Se requiere una instrucción grabada del usuario que reconozca que el cliente (propietario del recurso de Voz de Azure AI) creará y usará su voz.

Para agregar el consentimiento del usuario al proyecto de voz personal, proporcione el archivo de audio de consentimiento previamente grabado mediante una dirección URL accesible públicamente (Consents_Create) o cargue el archivo de audio (Consents_Post).

Necesita una grabación de audio del usuario que hable la declaración de consentimiento.

Puede obtener el texto de la declaración de consentimiento para cada configuración regional desde el repositorio de texto a voz de GitHub. Consulte el archivo verbal-statement-all-locales.txt, ya que en él se encuentra la declaración de consentimiento. A continuación se muestra un ejemplo para la configuración regional 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 la tabla siguiente para ver los formatos admitidos para los archivos de audio de consentimiento:

Format Frecuencia de muestreo Velocidad de bits Profundidad en 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

En este escenario, los archivos de audio deben estar disponibles localmente.

Para agregar el consentimiento a un proyecto de voz personal desde un archivo de audio local, use la operación Consents_Post de la API de voz personalizada. Construya el cuerpo de la solicitud según las instrucciones siguientes:

  • Establezca la propiedad projectId requerida. Consulte Creación de un proyecto.
  • Establezca la propiedad voiceTalentName requerida. El nombre del actor de voz no se podrá cambiar más adelante.
  • Establezca la propiedad companyName requerida. El nombre de la empresa no se podrá cambiar más adelante.
  • Establezca la propiedad requerida audiodata con el archivo de audio de consentimiento.
  • Establezca la propiedad locale requerida. Debe ser la configuración regional del consentimiento. Esta configuración regional no se podrá modificar más adelante. Encontrará la lista de opciones de configuración regional de texto a voz aquí.

Realice una solicitud HTTP POST con el URI, como se muestra en el ejemplo Consents_Post siguiente.

  • Reemplace YourResourceKey por su clave de recurso de Voz.
  • Reemplace YourResourceRegion por la región del recurso de Voz.
  • Reemplace JessicaConsentId por un id. de consentimiento de su elección. El id., que distingue mayúsculas de minúsculas, se usará en el URI del consentimiento y no se podrá cambiar más adelante.
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"

Debe recibir un cuerpo de respuesta en el formato siguiente:

{
  "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"
}

El encabezado de respuesta contiene la propiedad Operation-Location. Use este URI para obtener detalles sobre la operación Consents_Post. Este es un ejemplo de encabezado de respuesta:

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

En este escenario, los archivos de audio ya deben estar almacenados en un contenedor de Azure Blob Storage.

Para agregar el consentimiento a un proyecto de voz personal desde la dirección URL de un archivo de audio, use la operación Consents_Create de la API de voz personalizada. Construya el cuerpo de la solicitud según las instrucciones siguientes:

  • Establezca la propiedad projectId requerida. Consulte Creación de un proyecto.
  • Establezca la propiedad voiceTalentName requerida. El nombre del actor de voz no se podrá cambiar más adelante.
  • Establezca la propiedad companyName requerida. El nombre de la empresa no se podrá cambiar más adelante.
  • Establezca la propiedad audioUrl requerida. Dirección URL del archivo de audio de consentimiento del actor de voz. Use un identificador URI con el token de firmas de acceso compartido (SAS).
  • Establezca la propiedad locale requerida. Debe ser la configuración regional del consentimiento. Esta configuración regional no se podrá modificar más adelante. Encontrará la lista de opciones de configuración regional de texto a voz aquí.

Realice una solicitud HTTP PUT usando el URI como se muestra en el siguiente ejemplo de Consents_Create.

  • Reemplace YourResourceKey por su clave de recurso de Voz.
  • Reemplace YourResourceRegion por la región del recurso de Voz.
  • Reemplace JessicaConsentId por un id. de consentimiento de su elección. El id., que distingue mayúsculas de minúsculas, se usará en el URI del consentimiento y no se podrá cambiar más adelante.
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"

Debe recibir un cuerpo de respuesta en el formato siguiente:

{
  "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"
}

El encabezado de respuesta contiene la propiedad Operation-Location. Use este URI para obtener detalles sobre la operación Consents_Create. Este es un ejemplo de encabezado de respuesta:

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

Pasos siguientes

Cree una voz personal..