支援的區域端點

Cloud Speech-to-Text 提供美國和歐盟地區的 API 端點。如果使用區域端點，靜態和使用中的資料會保留在歐洲或美國的大陸疆界內。如果為了遵守當地法規要求，必須控管資料位置，請務必指定端點。API 行為沒有任何功能性變更。

使用區域端點

使用區域端點時，請務必在 parent 字串中加入相符的 us 或 eu 位置。如要進一步瞭解如何設定辨識要求主體，請參閱 RecognitionConfig 說明文件。

通訊協定

如要使用區域端點執行語音辨識，請在下表中執行適用指令以設定正確的端點：

多區域	端點覆寫
歐洲	$ export CLOUD_SPEECH_ENDPOINT=https://eu-speech.googleapis.com
美國	$ export CLOUD_SPEECH_ENDPOINT=https://us-speech.googleapis.com

下列程式碼範例說明如何傳送 recognize request，確保將所有資料限制在特定區域。您可以將 EU 或 US 區域端點替換為 CLOUD_SPEECH_ENDPOINT 變數。

$ curl   -H "Content-Type: application/json"  \
         -H  "Authorization: Bearer "$(gcloud auth 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'
        }
    }"

這個範例使用 Google Cloud CLI 為使用者帳戶產生憑證。如要瞭解如何安裝及初始化 gcloud CLI，請參閱快速入門導覽課程。

要求主體中提供的音訊內容採用 Base64 編碼。 如要進一步瞭解如何使用 base64 編碼音訊，請參閱「Base64 編碼音訊內容」。如要進一步瞭解 content 欄位，請參閱 RecognitionAudio。

gcloud

下列指令會設定區域端點：

多區域	端點覆寫
歐洲	gcloud config set api_endpoint_overrides/speech https://eu-speech.googleapis.com/
美國	gcloud config set api_endpoint_overrides/speech https://us-speech.googleapis.com/

設定區域端點後，後續傳送 recognize requests 時，所有資料都會限制在指定區域。以下範例示範如何發出辨識要求。

$ gcloud ml speech recognize gs://cloud-samples-tests/speech/brooklyn.flac \
    --language-code=en-US --log-http

Python

如要瞭解如何安裝及使用 Cloud STT 的用戶端程式庫，請參閱「Cloud STT 用戶端程式庫」。詳情請參閱「Cloud STT Python API 參考文件」。

如要向 Cloud STT 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

# Imports the Google Cloud client library
from google.api_core import client_options
from google.cloud import speech


def sync_recognize_with_multi_region_gcs() -> speech.RecognizeResponse:
    """Recognizes speech synchronously in the GCS bucket."""

    # Instantiates a client

    # Pass an additional argument, ClientOptions, to specify the new endpoint.
    _client_options = client_options.ClientOptions(
        api_endpoint="eu-speech.googleapis.com"
    )

    client = speech.SpeechClient(client_options=_client_options)

    # The name of the audio file to transcribe
    gcs_uri = "gs://cloud-samples-data/speech/brooklyn_bridge.raw"

    audio = speech.RecognitionAudio(uri=gcs_uri)

    config = speech.RecognitionConfig(
        encoding=speech.RecognitionConfig.AudioEncoding.LINEAR16,
        sample_rate_hertz=16000,
        language_code="en-US",
    )

    # Detects speech in the audio file
    response = client.recognize(config=config, audio=audio)

    for result in response.results:
        print(f"Transcript: {result.alternatives[0].transcript}")

    return response.results

限制全域 API 端點用量

如要強制使用區域端點，請使用 constraints/gcp.restrictEndpointUsage 組織政策限制，封鎖對全域 API 端點的要求。詳情請參閱「限制端點用量」。