Поделиться через

Добавление согласия пользователя в проект личной голосовой связи

  • Статья

При использовании личной функции голосовой связи требуется, чтобы каждый голос был создан с явным согласием от пользователя. Записанная инструкция от пользователя требует подтверждения того, что клиент (владелец ресурса службы "Речь ИИ Azure") создаст и будет использовать свой голос.

Чтобы добавить согласие пользователя в проект личной голосовой связи, вы предоставляете предварительно подготовленный аудиофайл согласия из общедоступного URL-адреса (Consents_Create) или отправьте звуковой файл (Consents_Post).

Требуется звукозапись пользователя, выступающего с заявлением согласия.

Вы можете получить текст инструкции согласия для каждого языкового стандарта из текста в репозиторий GitHub. См . verbal-statement-all-locales.txt инструкции согласия. Ниже приведен пример языкового 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."

В этом сценарии аудиофайлы должны быть доступны локально.

Чтобы добавить согласие на личные голосовые проекты из локального звукового файла, используйте Consents_Post операцию пользовательского API голосовой связи. Создайте текст запроса в соответствии со следующими инструкциями:

  • Задайте обязательное свойство projectId. См. статью о создании проекта.
  • Задайте обязательное свойство voiceTalentName. Имя таланта голоса не может быть изменено позже.
  • Задайте обязательное свойство companyName. Имя компании не может быть изменено позже.
  • Задайте необходимое audiodata свойство с звуковым файлом согласия.
  • Задайте обязательное свойство locale. Это должен быть языковой стандарт согласия. Языковой стандарт нельзя будет изменить позже. Здесь можно найти текст для языкового стандарта речи.

Выполните HTTP-запрос POST с помощью URI, как показано в следующем Consents_Post примере.

  • Замените YourResourceKey ключом ресурса службы речи.
  • Замените YourResourceRegion регион ресурсов службы "Речь".
  • Замените JessicaConsentId на свой выбор идентификатор согласия. Конфиденциальный код регистра будет использоваться в URI согласия и не может быть изменен позже.
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"

Вы должны получить ответ в следующем формате:

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

Заголовок ответа содержит Operation-Location свойство. Используйте этот универсальный код ресурса (URI) для получения сведений Consents_Post об операции. Ниже приведен пример заголовка ответа:

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

В этом сценарии звуковые файлы уже должны храниться в контейнере Хранилище BLOB-объектов Azure.

Чтобы добавить согласие на личный голосовой проект из URL-адреса звукового файла, используйте Consents_Create операцию пользовательского API голосовой связи. Создайте текст запроса в соответствии со следующими инструкциями:

  • Задайте обязательное свойство projectId. См. статью о создании проекта.
  • Задайте обязательное свойство voiceTalentName. Имя таланта голоса не может быть изменено позже.
  • Задайте обязательное свойство companyName. Имя компании не может быть изменено позже.
  • Задайте обязательное свойство audioUrl. URL-адрес аудиофайла голосового таланта. Используйте универсальный код ресурса (URI) с маркером ПОДПИСАННЫХ URL-адресов (SAS).
  • Задайте обязательное свойство locale. Это должен быть языковой стандарт согласия. Языковой стандарт нельзя будет изменить позже. Здесь можно найти текст для языкового стандарта речи.

Выполните HTTP-запрос PUT с помощью URI, как показано в следующем Consents_Create примере.

  • Замените YourResourceKey ключом ресурса службы речи.
  • Замените YourResourceRegion регион ресурсов службы "Речь".
  • Замените JessicaConsentId на свой выбор идентификатор согласия. Конфиденциальный код регистра будет использоваться в URI согласия и не может быть изменен позже.
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"

Вы должны получить ответ в следующем формате:

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

Заголовок ответа содержит Operation-Location свойство. Используйте этот URI для получения сведений об операции Consents_Create . Ниже приведен пример заголовка ответа:

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

Следующие шаги

Создайте личный голос..