Delen via

Gebruikerstoestemming toevoegen aan het persoonlijke spraakproject

  • Artikel

Met de functie voor persoonlijke spraak is vereist dat elke stem wordt gemaakt met expliciete toestemming van de gebruiker. Een opgenomen instructie van de gebruiker is vereist om te bevestigen dat de klant (Azure AI Speech-resource-eigenaar) hun stem zal maken en gebruiken.

Als u gebruikerstoestemming wilt toevoegen aan het persoonlijke spraakproject, geeft u het vooraf opgenomen toestemmingsaudiobestand op vanuit een openbaar toegankelijke URL (Consents_Create) of uploadt u het audiobestand (Consents_Post).

U hebt een audio-opname van de gebruiker nodig die de toestemmingsverklaring spreekt.

U kunt de tekst van de toestemmingsverklaring voor elke landinstelling ophalen uit de tekst naar de GitHub-opslagplaats voor spraak. Zie verbal-statement-all-locales.txt voor de toestemmingsverklaring. Hieronder ziet u een voorbeeld voor de en-US landinstelling:

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

Zie de onderstaande tabel voor de ondersteunde indelingen voor audiobestanden voor toestemming:

Notatie Samplefrequentie Bitrate Bitdiepte
mp3 16 kHz, 24 kHz, 44,1 kHz, 48 kHz 128 kbps, 192 kbps, 256kbbits, 320kbbits /
wav 16 kHz, 24 kHz, 44,1 kHz, 48 kHz / 16-bits, 24-bits, 32-bits

In dit scenario moeten de audiobestanden lokaal beschikbaar zijn.

Als u toestemming wilt toevoegen aan een persoonlijk spraakproject vanuit een lokaal audiobestand, gebruikt u de Consents_Post werking van de aangepaste spraak-API. Bouw de aanvraagbody volgens de volgende instructies:

  • Stel de vereiste projectId eigenschap in. Zie Een project maken.
  • Stel de vereiste voiceTalentName eigenschap in. De naam van het stemtalent kan later niet meer worden gewijzigd.
  • Stel de vereiste companyName eigenschap in. De bedrijfsnaam kan later niet meer worden gewijzigd.
  • Stel de vereiste audiodata eigenschap in met het toestemmingsaudiobestand.
  • Stel de vereiste locale eigenschap in. Dit moet de landinstelling van de toestemming zijn. De landinstelling kan later niet meer worden gewijzigd. Hier vindt u de lijst met taalinstellingen voor tekst.

Maak een HTTP POST-aanvraag met behulp van de URI, zoals wordt weergegeven in het volgende Consents_Post voorbeeld.

  • Vervang door YourResourceKey uw Spraak-resourcesleutel.
  • Vervang door YourResourceRegion uw spraakresourceregio.
  • Vervang door JessicaConsentId een toestemmings-id van uw keuze. De hoofdlettergevoelige id wordt gebruikt in de URI van de toestemming en kan later niet meer worden gewijzigd.
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"

U ontvangt een antwoordtekst in de volgende indeling:

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

De antwoordheader bevat de Operation-Location eigenschap. Gebruik deze URI om details over de Consents_Post bewerking op te halen. Hier volgt een voorbeeld van de antwoordheader:

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

In dit scenario moeten de audiobestanden al worden opgeslagen in een Azure Blob Storage-container.

Als u toestemming wilt geven voor een persoonlijk spraakproject vanuit de URL van een audiobestand, gebruikt u de Consents_Create bewerking van de aangepaste spraak-API. Bouw de aanvraagbody volgens de volgende instructies:

  • Stel de vereiste projectId eigenschap in. Zie Een project maken.
  • Stel de vereiste voiceTalentName eigenschap in. De naam van het stemtalent kan later niet meer worden gewijzigd.
  • Stel de vereiste companyName eigenschap in. De bedrijfsnaam kan later niet meer worden gewijzigd.
  • Stel de vereiste audioUrl eigenschap in. De URL van het audiobestand stemtalenttoestemming. Gebruik een URI met het SAS-token (Shared Access Signatures).
  • Stel de vereiste locale eigenschap in. Dit moet de landinstelling van de toestemming zijn. De landinstelling kan later niet meer worden gewijzigd. Hier vindt u de lijst met taalinstellingen voor tekst.

Maak een HTTP PUT-aanvraag met behulp van de URI, zoals wordt weergegeven in het volgende Consents_Create voorbeeld.

  • Vervang door YourResourceKey uw Spraak-resourcesleutel.
  • Vervang door YourResourceRegion uw spraakresourceregio.
  • Vervang door JessicaConsentId een toestemmings-id van uw keuze. De hoofdlettergevoelige id wordt gebruikt in de URI van de toestemming en kan later niet meer worden gewijzigd.
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"

U ontvangt een antwoordtekst in de volgende indeling:

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

De antwoordheader bevat de Operation-Location eigenschap. Gebruik deze URI voor meer informatie over de Consents_Create-bewerking . Hier volgt een voorbeeld van de antwoordheader:

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

Volgende stappen

Maak een persoonlijke stem..