Deteksi bahasa secara otomatis

Halaman ini menjelaskan cara menyiapkan pengenal agar otomatis mengenali bahasa yang diucapkan dalam file audio, dari daftar preset bahasa potensial.

Dalam beberapa situasi, Anda tidak tahu secara pasti bahasa apa yang terkandung dalam rekaman audio Anda. Misalnya, jika Anda memublikasikan layanan, aplikasi, atau produk di negara dengan beberapa bahasa resmi, Anda berpotensi menerima input audio dari pengguna dalam berbagai bahasa. Hal ini dapat membuat penentuan satu kode bahasa untuk permintaan transkripsi jauh lebih sulit.

Pengenalan beberapa bahasa

Speech-to-Text menawarkan cara bagi Anda untuk menentukan sekumpulan bahasa yang mungkin terdapat dalam data audio Anda. Saat membuat Recognizer atau mengirimkan permintaan pengenalan, Anda dapat menyediakan satu atau beberapa bahasa yang mungkin disertakan data audio dalam kolom language_codes. Dalam permintaan dengan beberapa bahasa, Speech-to-Text akan mencoba mentranskripsikan audio menggunakan bahasa yang paling cocok dari daftar alternatif yang Anda berikan. Speech-to-Text kemudian melabeli hasil transkripsi dengan kode bahasa yang diprediksi.

Fitur ini ideal untuk aplikasi yang perlu mentranskripsikan pernyataan singkat seperti perintah suara atau penelusuran. Anda dapat mencantumkan hingga tiga bahasa untuk pengenalan bahasa otomatis.

Sebelum memulai

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Aktifkan API Speech-to-Text.

    Mengaktifkan API

  5. Make sure that you have the following role or roles on the project: Cloud Speech Administrator

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role colunn to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Buka IAM
    2. Pilih project.
    3. Klik Berikan akses.
    4. Di kolom New principals, masukkan ID pengguna Anda. Ini biasanya adalah alamat email untuk Akun Google.

    5. Di daftar Pilih peran, pilih peran.
    6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
    7. Klik Simpan.
    8. Install the Google Cloud CLI.
    9. To initialize the gcloud CLI, run the following command:

      gcloud init
    10. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

      Buka pemilih project

    11. Make sure that billing is enabled for your Google Cloud project.

    12. Aktifkan API Speech-to-Text.

      Mengaktifkan API

    13. Make sure that you have the following role or roles on the project: Cloud Speech Administrator

      Check for the roles

      1. In the Google Cloud console, go to the IAM page.

        Go to IAM
      2. Select the project.
      3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

      4. For all rows that specify or include you, check the Role colunn to see whether the list of roles includes the required roles.

      Grant the roles

      1. In the Google Cloud console, go to the IAM page.

        Buka IAM
      2. Pilih project.
      3. Klik Berikan akses.
      4. Di kolom New principals, masukkan ID pengguna Anda. Ini biasanya adalah alamat email untuk Akun Google.

      5. Di daftar Pilih peran, pilih peran.
      6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
      7. Klik Simpan.
      8. Install the Google Cloud CLI.
      9. To initialize the gcloud CLI, run the following command:

        gcloud init
      10. Library klien dapat menggunakan Kredensial Default Aplikasi untuk dengan mudah melakukan autentikasi dengan Google API dan mengirim permintaan ke API tersebut. Dengan Kredensial Default Aplikasi, Anda dapat menguji aplikasi secara lokal dan men-deploy aplikasi tanpa mengubah kode yang mendasarinya. Untuk informasi selengkapnya, lihat Lakukan autentikasi untuk menggunakan library klien.

      11. Buat kredensial autentikasi lokal untuk Akun Google Anda:

        gcloud auth application-default login

      Selain itu, pastikan Anda telah menginstal library klien.

      Aktifkan pengenalan bahasa dalam permintaan transkripsi audio

      Berikut adalah contoh penerapan pengenalan ucapan sinkron pada file audio lokal dengan beberapa bahasa.

      Python

      import os
      
      from typing import List
      
      from google.cloud.speech_v2 import SpeechClient
      from google.cloud.speech_v2.types import cloud_speech
      
      PROJECT_ID = os.getenv("GOOGLE_CLOUD_PROJECT")
      
      
      def transcribe_multiple_languages_v2(
          audio_file: str,
          language_codes: List[str],
      ) -> cloud_speech.RecognizeResponse:
          """Transcribe an audio file using Google Cloud Speech-to-Text API with support for multiple languages.
          Args:
              audio_file (str): Path to the local audio file to be transcribed.
                  Example: "resources/audio.wav"
              language_codes (List[str]): A list of BCP-47 language codes to be used for transcription.
                  Example: ["en-US", "fr-FR"]
          Returns:
              cloud_speech.RecognizeResponse: The response from the Speech-to-Text API containing the
                  transcription results.
          """
          client = SpeechClient()
      
          # Reads a file as bytes
          with open(audio_file, "rb") as f:
              audio_content = f.read()
      
          config = cloud_speech.RecognitionConfig(
              auto_decoding_config=cloud_speech.AutoDetectDecodingConfig(),
              language_codes=language_codes,
              model="latest_long",
          )
      
          request = cloud_speech.RecognizeRequest(
              recognizer=f"projects/{PROJECT_ID}/locations/global/recognizers/_",
              config=config,
              content=audio_content,
          )
      
          # Transcribes the audio into text
          response = client.recognize(request=request)
          # Prints the transcription results
          for result in response.results:
              print(f"Transcript: {result.alternatives[0].transcript}")
      
          return response
      
      

      Pembersihan

      Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

      1. Opsional: Cabut kredensial autentikasi yang Anda buat, dan hapus file kredensial lokal.

        gcloud auth application-default revoke
      2. Opsional: Cabut kredensial dari gcloud CLI.

        gcloud auth revoke

      Konsol

    14. Di konsol Google Cloud, buka halaman Manage resource.

      Buka Manage resource

    15. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
    16. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.
    17. gcloud

      Menghapus project Google Cloud:

      gcloud projects delete PROJECT_ID

      Langkah berikutnya