Text-to-Speech propose des points de terminaison d'API régionaux aux États-Unis et dans l'UE. Si vous utilisez un point de terminaison régional, vos données au repos et en cours d'utilisation resteront dans les limites géographiques de l'Europe ou des États-Unis. La spécification d'un point de terminaison est importante si l'emplacement de vos données doit être contrôlé afin de respecter les exigences réglementaires locales. Il n'y a aucune modification fonctionnelle du comportement de l'API.
Lorsque vous utilisez un point de terminaison régional, assurez-vous d'inclure l'emplacement us ou eu correspondant dans la chaîne parent. Pour en savoir plus sur la configuration du corps de la requête synthesize, consultez la documentation sur Synthesize.
Protocole
Pour effectuer une synthèse vocale à l'aide d'un point de terminaison régional, exécutez la commande applicable dans le tableau ci-dessous afin de configurer le point de terminaison approprié :
| Multirégional | Remplacement de point de terminaison |
|---|---|
| UE | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| États-Unis | $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com |
Seules les voix Neural2 sont disponibles à partir de ces points de terminaison :
| Single-region | Remplacement de point de terminaison |
|---|---|
| US Central1 | $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com |
L'exemple de code suivant montre comment envoyer une requête de reconnaissance synthesis request qui conserve toutes les données confinées dans une région spécifiée. Vous pouvez remplacer le point de terminaison régional EU ou US par la variable CLOUD_TTS_ENDPOINT. Remplacez PROJECT_ID par l'ID de votre projet.
$ curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
--data "{
'input':{
'text':'Android is a mobile operating system developed by Google,
based on the Linux kernel and designed primarily for
touchscreen mobile devices such as smartphones and tablets.'
},
'voice':{
'languageCode':'en-gb',
'name':'en-GB-Neural2-A',
'ssmlGender':'FEMALE'
},
'audioConfig':{
'audioEncoding':'MP3'
}
}" $CLOUD_TTS_ENDPOINT/v1/text:synthesize > synthesize-text.txt
Cet exemple utilise Google Cloud CLI afin de créer un jeton d'accès pour votre compte Google. Pour obtenir des instructions sur l'installation de gcloud CLI, consultez la page S'authentifier auprès de Text-to-Speech.