Speech-to-Text now offers US and EU regional API endpoints. If you use a regional endpoint, your data in-transit and at-rest will stay within the continental boundaries of Europe or the USA. Specifying an endpoint is important if your data's location must be controlled in order to comply with local regulatory requirements. There is no functional change to the behavior of the API.
Protocol
To perform speech recognition using a regional endpoint, run the applicable command in the table below to configure the correct endpoint:
Multi-region | Endpoint override |
---|---|
EU | $ export CLOUD_SPEECH_ENDPOINT=https://eu-speech.googleapis.com |
US | $ export CLOUD_SPEECH_ENDPOINT=https://us-speech.googleapis.com |
When you send a recognize
request (below), all data will be confined to the specified region.
$ curl -H "Content-Type: application/json" \ -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \ ${CLOUD_SPEECH_ENDPOINT}/v1/speech:recognize \ --data "{ 'config': { 'encoding': 'LINEAR16', 'languageCode': 'en-US' }, 'audio': { 'uri':'gs://speech-samples-00/commercial_mono.wav' } }"
The example above uses the access token for a service account set up for the project using the Google Cloud Cloud SDK. For instructions on installing the Cloud SDK, setting up a project with a service account, and obtaining an access token, see the quickstart.
See the RecognitionConfig reference documentation for more information on configuring the request body.
The audio content supplied in the request body is base64-encoded.
For more information on how to base64-encode
audio, see Base64 Encoding Audio Content. For more information
on the content
field, see
RecognitionAudio.
gcloud
To perform speech recognition using a regional endpoint, run the applicable command in the table below to configure the correct endpoint:
Multi-region | Endpoint override |
---|---|
EU | gcloud config set api_endpoint_overrides/speech https://eu-speech.googleapis.com/ |
US | gcloud config set api_endpoint_overrides/speech https://us-speech.googleapis.com/ |
When you send a recognize
request (below), all data will be confined to the specified region.
$ gcloud ml speech recognize gs://cloud-samples-tests/speech/brooklyn.flac \ --language-code=en-US --log-http
Python