Partager via


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

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

Le tableau ci-dessous indique les formats pris en charge pour les fichiers audio de consentement :

Format Taux d’échantillonnage Vitesse de transmission Profondeur de bits
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 / 16 bits, 24 bits, 32 bits

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=2024-02-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": "2024-09-01T05:30:00.000Z",
  "lastActionDateTime": "2024-09-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=2024-02-01-preview
Operation-Id: 070f7986-ef17-41d0-ba2b-907f0f28e314

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=2024-02-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": "2024-09-01T05:30:00.000Z",
  "lastActionDateTime": "2024-09-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=2024-02-01-preview
Operation-Id: 070f7986-ef17-41d0-ba2b-907f0f28e314

Étapes suivantes