Sdílet prostřednictvím

Přidání souhlasu uživatele s osobním hlasovým projektem

  • Článek

U funkce osobního hlasu je nutné, aby se každý hlas vytvořil s výslovným souhlasem uživatele. Vyžaduje se zaznamenané prohlášení od uživatele s potvrzením, že zákazník (vlastník prostředku Azure AI Speech) vytvoří a použije svůj hlas.

Pokud chcete přidat souhlas uživatele s osobním hlasovým projektem, zadáte předem zaznamenaný zvukový soubor souhlasu z veřejně přístupné adresy URL (Consents_Create) nebo nahrajete zvukový soubor (Consents_Post).

Potřebujete zvukový záznam uživatele, který mluví prohlášením o souhlasu.

Text příkazu pro vyjádření souhlasu můžete získat z úložiště GitHub pro každé národní prostředí z textu na řeč. Viz verbal-statement-all-locales.txt prohlášení o souhlasu. Níže je ukázka národního en-US prostředí:

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

Podporované formáty zvukových souborů souhlasu najdete v následující tabulce:

Formát Vzorkovací frekvence Přenosová rychlost Hloubka bitu
mp3 16 kHz, 24 kHz, 44,1 kHz, 48 kHz 128 kb/s, 192 kb/s, 256 kb/s, 320 kB/s /
wav 16 kHz, 24 kHz, 44,1 kHz, 48 kHz / 16bitová, 24bitová, 32bitová

V tomto scénáři musí být zvukové soubory dostupné místně.

Pokud chcete přidat souhlas s osobním hlasovým projektem z místního zvukového souboru, použijte Consents_Post operaci vlastního hlasového rozhraní API. Sestavte tělo požadavku podle následujících pokynů:

  • Nastavte požadovanou projectId vlastnost. Viz vytvoření projektu.
  • Nastavte požadovanou voiceTalentName vlastnost. Jméno hlasu se později nedá změnit.
  • Nastavte požadovanou companyName vlastnost. Název společnosti nejde později změnit.
  • Nastavte požadovanou audiodata vlastnost se zvukovým souborem souhlasu.
  • Nastavte požadovanou locale vlastnost. Mělo by to být národní prostředí souhlasu. Národní prostředí nelze později změnit. Text na seznam národních prostředí řeči najdete tady.

Vytvořte požadavek HTTP POST pomocí identifikátoru URI, jak je znázorněno v následujícím Consents_Post příkladu.

  • Nahraďte YourResourceKey klíčem prostředku služby Speech.
  • Nahraďte YourResourceRegion oblastí prostředků služby Speech.
  • Nahraďte JessicaConsentId id souhlasu podle vašeho výběru. V identifikátoru URI souhlasu se použije ID s rozlišováním velkých a malých písmen a později ho nejde změnit.
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"

Měl by se zobrazit text odpovědi v následujícím formátu:

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

Hlavička odpovědi obsahuje Operation-Location vlastnost. Pomocí tohoto identifikátoru Consents_Post URI získáte podrobnosti o operaci. Tady je příklad hlavičky odpovědi:

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

V tomto scénáři už musí být zvukové soubory uložené v kontejneru Azure Blob Storage.

Pokud chcete přidat souhlas s osobním hlasovým projektem z adresy URL zvukového souboru, použijte Consents_Create operaci vlastního hlasového rozhraní API. Sestavte tělo požadavku podle následujících pokynů:

  • Nastavte požadovanou projectId vlastnost. Viz vytvoření projektu.
  • Nastavte požadovanou voiceTalentName vlastnost. Jméno hlasu se později nedá změnit.
  • Nastavte požadovanou companyName vlastnost. Název společnosti nejde později změnit.
  • Nastavte požadovanou audioUrl vlastnost. Adresa URL zvukového souboru souhlasu hlasového talentu. Použijte identifikátor URI se sdíleným přístupovým podpisem (SAS).
  • Nastavte požadovanou locale vlastnost. Mělo by to být národní prostředí souhlasu. Národní prostředí nelze později změnit. Text na seznam národních prostředí řeči najdete tady.

Vytvořte požadavek HTTP PUT pomocí identifikátoru URI, jak je znázorněno v následujícím příkladu Consents_Create.

  • Nahraďte YourResourceKey klíčem prostředku služby Speech.
  • Nahraďte YourResourceRegion oblastí prostředků služby Speech.
  • Nahraďte JessicaConsentId id souhlasu podle vašeho výběru. V identifikátoru URI souhlasu se použije ID s rozlišováním velkých a malých písmen a později ho nejde změnit.
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"

Měl by se zobrazit text odpovědi v následujícím formátu:

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

Hlavička odpovědi obsahuje Operation-Location vlastnost. Pomocí tohoto identifikátoru URI získáte podrobnosti o operaci Consents_Create . Tady je příklad hlavičky odpovědi:

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

Další kroky

Vytvořte osobní hlas.