Endpoint regionali supportati

Cloud Speech-to-Text offre endpoint API regionali per gli Stati Uniti e l'UE. Se utilizzi un endpoint regionale, i dati at-rest e in uso rimarranno all'interno dei confini continentali dell'Europa o degli Stati Uniti. È importante specificare un endpoint se la località dei tuoi dati deve essere controllata per rispettare i requisiti normativi locali. Non vengono apportate modifiche funzionali al comportamento dell'API.

Utilizza endpoint regionali

Quando utilizzi un endpoint regionale, assicurati di includere la località us o eu corrispondente nella stringa parent. Consulta la RecognitionConfig documentazione per saperne di più sulla configurazione del corpo delle richieste di riconoscimento.

Protocollo

Per eseguire il riconoscimento vocale utilizzando un endpoint regionale, esegui il comando applicabile nella tabella seguente per configurare l'endpoint corretto:

Più regioni	Override dell'endpoint
UE	$ export CLOUD_SPEECH_ENDPOINT=https://eu-speech.googleapis.com
US	$ export CLOUD_SPEECH_ENDPOINT=https://us-speech.googleapis.com

L'esempio di codice seguente mostra come inviare una recognize request che mantiene tutti i dati confinati in una regione specificata. Puoi sostituire l'endpoint regionale EU o US con la variabile 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'
        }
    }"

Questo esempio utilizza Google Cloud CLI per generare le credenziali per il tuo account utente. Per scoprire come installare e inizializzare la gcloud CLI, consulta la guida rapida.

I contenuti audio forniti nel corpo della richiesta sono codificati in base64. Per saperne di più su come codificare l'audio in base64, consulta Codifica dei contenuti audio in base64. Per saperne di più sul campo content, consulta RecognitionAudio.

gcloud

I seguenti comandi impostano un endpoint regionale:

Più regioni	Override dell'endpoint
UE	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/

Dopo aver impostato l'endpoint regionale, tutti i dati verranno limitati alla regione specificata quando invii le successive recognize requests. L'esempio seguente mostra una richiesta di riconoscimento.

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

Python

Per scoprire come installare e utilizzare la libreria client per Cloud STT, consulta Librerie client di Cloud STT. Per saperne di più, consulta la documentazione di riferimento dell' API Python Cloud STT.

Per eseguire l'autenticazione in Cloud STT, configura le credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

# 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

Limita l'utilizzo degli endpoint API globali

Per contribuire a imporre l'utilizzo di endpoint regionali, utilizza il vincolo delle policy dell'organizzazione constraints/gcp.restrictEndpointUsage per bloccare le richieste all'endpoint API globale. Per saperne di più, consulta Limitazione dell'utilizzo degli endpoint.