Melakukan migrasi dari Speech-to-Text v1 ke v2

Speech-to-Text API v2 menghadirkan desain Google Cloud API terbaru bagi pelanggan untuk memenuhi persyaratan peraturan dan keamanan perusahaan secara langsung.

Persyaratan ini diwujudkan melalui hal berikut:

  • Residensi Data: Speech-to-Text v2 menawarkan berbagai model transkripsi yang sudah ada di Region Google Cloud seperti Belgia atau Singapura. Hal ini memungkinkan pemanggilan model transkripsi kami melalui layanan yang sepenuhnya regional.

  • Recognizer Resourcefulness: Pengenal adalah konfigurasi pengenalan yang dapat digunakan kembali dan dapat berisi kombinasi model, bahasa, dan fitur. Dengan implementasi yang praktis ini, akun layanan khusus tidak diperlukan lagi untuk autentikasi dan otorisasi.

  • Logging: Pembuatan resource dan transkripsi menghasilkan log yang tersedia di konsol Google Cloud, sehingga telemetri dan proses debug dapat berjalan lebih baik.

  • Enkripsi: Speech-to-Text v2 mendukung Kunci enkripsi yang dikelola pelanggan untuk semua resource serta transkripsi batch.

  • Deteksi Otomatis Audio: Speech-to-Text v2 dapat secara otomatis mendeteksi frekuensi sampel, jumlah channel, dan format file audio Anda, tanpa memerlukan untuk memberikan informasi tersebut dalam konfigurasi permintaan.

Bermigrasi dari v1 ke v2

Migrasi dari API v1 ke API v2 tidak terjadi secara otomatis. Perubahan implementasi minimal diperlukan untuk memanfaatkan set fitur.

Bermigrasi di API

Serupa dengan Speech-to-Text v1, untuk mentranskripsikan audio, Anda harus membuat RecognitionConfig dengan memilih bahasa audio dan model pengenalan pilihan Anda:

Python

from google.cloud.speech_v2 import SpeechClient
from google.cloud.speech_v2.types import cloud_speech

def quickstart_v2(
    project_id: str,
    audio_file: str,
) -> cloud_speech.RecognizeResponse:
    """Transcribe an audio file."""
    # Instantiates a client
    client = SpeechClient()

    # Reads a file as bytes
    with open(audio_file, "rb") as f:
        content = f.read()

    config = cloud_speech.RecognitionConfig(
        auto_decoding_config=cloud_speech.AutoDetectDecodingConfig(),
        language_codes=["en-US"],
        model="long",
    )

    request = cloud_speech.RecognizeRequest(
        recognizer=f"projects/{project_id}/locations/global/recognizers/_",
        config=config,
        content=content,
    )

    # Transcribes the audio into text
    response = client.recognize(request=request)

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

    return response

Jika diperlukan, pilih region tempat Anda ingin menggunakan Speech-to-Text API, dan periksa ketersediaan bahasa dan model di region tersebut:

Python

from google.api_core.client_options import ClientOptions
from google.cloud.speech_v2 import SpeechClient
from google.cloud.speech_v2.types import cloud_speech

def change_speech_v2_location(
    project_id: str,
    location: str,
    audio_file: str,
) -> cloud_speech.RecognizeResponse:
    """Transcribe an audio file in a specific region."""
    # Instantiates a client to a regionalized Speech endpoint.
    client = SpeechClient(
        client_options=ClientOptions(
            api_endpoint=f"{location}-speech.googleapis.com",
        )
    )

    # Reads a file as bytes
    with open(audio_file, "rb") as f:
        content = f.read()

    config = cloud_speech.RecognitionConfig(
        auto_decoding_config=cloud_speech.AutoDetectDecodingConfig(),
        language_codes=["en-US"],
        model="long",
    )

    request = cloud_speech.RecognizeRequest(
        recognizer=f"projects/{project_id}/locations/{location}/recognizers/_",
        config=config,
        content=content,
    )

    # Transcribes the audio into text
    response = client.recognize(request=request)

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

    return response

Secara opsional, buat resource pengenal jika Anda perlu menggunakan kembali konfigurasi pengenalan tertentu di banyak permintaan transkripsi:

Python

from google.cloud.speech_v2 import SpeechClient
from google.cloud.speech_v2.types import cloud_speech

def create_recognizer(project_id: str, recognizer_id: str) -> cloud_speech.Recognizer:
    # Instantiates a client
    client = SpeechClient()

    request = cloud_speech.CreateRecognizerRequest(
        parent=f"projects/{project_id}/locations/global",
        recognizer_id=recognizer_id,
        recognizer=cloud_speech.Recognizer(
            default_recognition_config=cloud_speech.RecognitionConfig(
                language_codes=["en-US"], model="long"
            ),
        ),
    )

    operation = client.create_recognizer(request=request)
    recognizer = operation.result()

    print("Created Recognizer:", recognizer.name)
    return recognizer

Ada perbedaan lain dalam permintaan dan respons di API v2 yang baru. Untuk detail selengkapnya, lihat dokumentasi referensi .

Bermigrasi di UI

Untuk bermigrasi melalui konsol Google Cloud Speech, ikuti langkah-langkah berikut:

  1. Buka konsol Google Cloud Speech.

  2. Buka Halaman Transkripsi.

  3. Klik Transkripsi Baru, lalu pilih audio Anda di tab Konfigurasi audio.

  4. Di tab Opsi transkripsi, pilih V2.