Ajouter un consentement de l’utilisateur au projet de voix personnelle
Avec la fonctionnalité de voix personnelle, chaque voix doit être créée avec le consentement explicite de l’utilisateur. Une déclaration enregistrée de l’utilisateur (propriétaire de la ressource Azure AI Speech) acceptant que le client crée et utilise sa voix est requise.
Pour ajouter un consentement de l’utilisateur au projet de voix personnelle, fournissez le fichier audio de consentement préenregistré à partir d’une URL publiquement accessible (Consents_Create) ou chargez le fichier audio (Consents_Post
).
Déclaration de consentement
Vous devez avoir un enregistrement audio de l’utilisateur évoquant la déclaration de consentement.
Vous pouvez obtenir le texte de la déclaration de consentement pour chacun des paramètres régionaux à partir du référentiel GitHub de synthèse vocale. Consultez verbal-statement-all-locales.txt pour obtenir la déclaration de consentement. Voici un exemple pour les paramètres régionaux 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."
Ajouter un consentement à partir d’un fichier
Dans ce scénario, les fichiers audio doivent être disponibles localement.
Pour ajouter un consentement à un projet de voix personnelle à partir d’un fichier audio local, utilisez l’opération Consents_Post
de l’API de voix personnalisée. Construisez le corps de la requête conformément aux instructions suivantes :
- Définissez la propriété requise
projectId
. Consultez Créer un projet. - Définissez la propriété requise
voiceTalentName
. Vous ne pourrez plus changer le nom d’artiste vocal plus tard. - Définissez la propriété requise
companyName
. Vous ne pourrez plus changer le nom d’entreprise plus tard. - Définissez la propriété
audiodata
requise avec le fichier audio de consentement. - Définissez la propriété requise
locale
. Il doit s’agir des paramètres régionaux du consentement. Vous ne pourrez plus changer de paramètres régionaux. Vous trouverez la liste des paramètres régionaux de synthèse vocale ici.
Effectuez une requête HTTP POST à l’aide de l’URI, comme illustré dans l’exemple Consents_Post
suivant.
- Remplacez
YourResourceKey
par votre clé de ressource Speech. - Remplacez
YourResourceRegion
par votre région de ressource Speech. - Remplacez
JessicaConsentId
par l’ID de consentement de votre choix. L’ID sensible à la casse est utilisé dans l’URI du consentement et ne peut pas être modifié plus tard.
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"
Vous devriez recevoir un corps de réponse au format suivant :
{
"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"
}
L’en-tête de réponse contient la propriété Operation-Location
. Utilisez cet URI pour obtenir des informations sur l’opération Consents_Post
. Voici un exemple d’en-tête de réponse :
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
Ajouter un consentement à partir d’une URL
Dans ce scénario, les fichiers audio doivent déjà être stockés dans un conteneur Stockage Blob Azure.
Pour ajouter un consentement à un projet de voix personnelle depuis l’URL d’un fichier audio, utilisez l’opération Consents_Create de l’API Custom Voice. Construisez le corps de la requête conformément aux instructions suivantes :
- Définissez la propriété requise
projectId
. Consultez Créer un projet. - Définissez la propriété requise
voiceTalentName
. Vous ne pourrez plus changer le nom d’artiste vocal plus tard. - Définissez la propriété requise
companyName
. Vous ne pourrez plus changer le nom d’entreprise plus tard. - Définissez la propriété requise
audioUrl
. URL du fichier audio de consentement d’artiste vocal. Utilisez un URI avec le jeton des signatures d’accès partagé (SAP). - Définissez la propriété requise
locale
. Il doit s’agir des paramètres régionaux du consentement. Vous ne pourrez plus changer de paramètres régionaux. Vous trouverez la liste des paramètres régionaux de synthèse vocale ici.
Effectuez une requête HTTP PUT à l’aide de l’URI, comme illustré dans l’exemple Consents_Create suivant.
- Remplacez
YourResourceKey
par votre clé de ressource Speech. - Remplacez
YourResourceRegion
par votre région de ressource Speech. - Remplacez
JessicaConsentId
par l’ID de consentement de votre choix. L’ID sensible à la casse est utilisé dans l’URI du consentement et ne peut pas être modifié plus tard.
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"
Vous devriez recevoir un corps de réponse au format suivant :
{
"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"
}
L’en-tête de réponse contient la propriété Operation-Location
. Utilisez cet URI pour obtenir des informations sur l’opération Consents_Create. Voici un exemple d’en-tête de réponse :
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
Étapes suivantes
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour