Text-to-Speech는 미국 및 EU 리전 API 엔드포인트를 제공합니다. 리전 엔드포인트를 사용할 경우 저장 데이터 및 사용 중인 데이터는 유럽 또는 미국의 대륙 경계 내에 유지됩니다. 엔드포인트 지정은 현지 규제 요건을 준수하기 위해 데이터 위치를 제어해야 하는 경우에 중요합니다. API의 동작에 대한 기능 변경사항은 없습니다.
리전 엔드포인트를 사용하는 경우 parent 문자열에 일치하는 us 또는 eu 위치를 포함해야 합니다. 합성 요청 본문 구성에 대한 자세한 내용은 Synthesize 문서를 참조하세요.
프로토콜
리전 엔드포인트를 사용하여 TTS(텍스트 음성 변환) 합성을 수행하려면 아래 테이블의 해당 명령어를 실행하여 적절한 엔드포인트를 구성합니다.
| 멀티 리전 | 엔드포인트 재정의 |
|---|---|
| 유럽 | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| US | $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com |
다음 엔드포인트에서는 Neural2 음성만 사용할 수 있습니다.
| 단일 리전 | 엔드포인트 재정의 |
|---|---|
| US Central1 | $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com |
다음 코드 샘플은 모든 데이터를 지정된 리전으로 제한하는 synthesis request를 전송하는 방법을 보여줍니다. EU 또는 US 리전 엔드포인트를 CLOUD_TTS_ENDPOINT 변수 대신 사용할 수 있습니다. 여기서 PROJECT_ID를 프로젝트 ID로 바꿉니다.
$ 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
이 예시에서는 Google Cloud CLI를 사용하여 Google 계정에 대한 액세스 토큰을 만듭니다. gcloud CLI 설치에 대한 안내는 Text-to-Speech에 인증을 참조하세요.