啟用不雅用語篩選功能

本頁面說明如何使用 Cloud 語音轉文字自動偵測音訊資料中的不雅內容，並在轉錄稿中加以審查。

如要啟用不雅用語篩選器，請在 RecognitionFeatures 中設定 profanityFilter=true。啟用後，Cloud 語音轉文字會嘗試偵測不雅字詞，並在轉錄稿中只傳回第一個字母，其餘字元則以星號表示 (例如 f***)。如果將這個欄位設為 false 或未設定，Cloud Speech-to-Text 就不會嘗試濾除不雅用語。

下列範例示範如何啟用不雅用語篩選器，辨識儲存在 Cloud Storage 值區中的音訊。

Python

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

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

from google.cloud import speech
from google.cloud.speech import RecognizeResponse


def sync_recognize_with_profanity_filter_gcs(audio_uri: str) -> RecognizeResponse:
    """Recognizes speech from an audio file in Cloud Storage and filters out profane language.
    Args:
        audio_uri (str): The Cloud Storage URI of the input audio, e.g., gs://[BUCKET]/[FILE]
    Returns:
        cloud_speech.RecognizeResponse: The full response object which includes the transcription results.
    """
    # Define the audio source
    audio = {"uri": audio_uri}

    client = speech.SpeechClient()
    config = speech.RecognitionConfig(
        encoding=speech.RecognitionConfig.AudioEncoding.FLAC,  # Audio format
        sample_rate_hertz=16000,
        language_code="en-US",
        # Enable profanity filter
        profanity_filter=True,
    )

    response = client.recognize(config=config, audio=audio)

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

    return response.results