이 페이지에서는 Speech-to-Text를 통해 텍스트로 변환된 오디오 데이터에서 여러 화자의 라벨을 가져오는 방법을 설명합니다.
오디오 데이터에 두 명 이상이 이야기하는 샘플이 포함되어 있는 경우가 있습니다. 예를 들어 전화 통화 오디오는 대개 두 명 이상의 음성이 포함되어 있습니다. 통화 내용을 텍스트로 변환할 때 누가 언제 이야기하는지 알 수 있습니다.
화자 분할
Speech-to-Text는 같은 오디오 클립에서 화자를 여러 명 인식할 수 있습니다. Speech-to-Text에 오디오 텍스트 변환 요청을 보낼 때 Speech-to-Text가 오디오 샘플에서 다른 화자를 식별하도록 지시하는 매개변수를 포함할 수 있습니다. 화자 분할이라고 하는 이 기능은 화자가 바뀌는 시점을 감지하고 오디오에서 감지된 개별 음성에 숫자로 라벨을 지정합니다.
텍스트 변환 요청에서 화자 분할을 사용 설정하면 Speech-to-Text는 오디오 샘플에 포함된 여러 음성을 구별하려고 시도합니다. 텍스트 변환 결과에는 개별 화자마다 지정된 숫자와 함께 각 단어에 태그가 지정됩니다. 같은 화자가 말한 단어는 같은 숫자가 지정됩니다. 텍스트 변환 결과에는 Speech-to-Text가 오디오 샘플에서 고유하게 식별할 수 있는 최대 화자 수가 모두 포함될 수 있습니다.
화자 분할을 사용할 경우 Speech-to-Text는 텍스트 변환에서 제공되는 모든 결과의 누적 집계를 산출합니다. 각 결과에는 이전 결과의 단어가 포함됩니다. 따라서 최종 결과의 words
배열은 텍스트 변환의 완전한 분할 결과를 제공합니다.
이 기능이 사용 중인 언어로 지원되는지 알아보려면 언어 지원 페이지를 확인하세요.
요청에 화자 분할 사용 설정
화자 분할을 사용 설정하려면 요청에 대한 SpeakerDiarizationConfig
매개변수에서 enableSpeakerDiarization
필드를 true
로 설정해야 합니다. 텍스트 변환 결과를 개선하려면 SpeakerDiarizationConfig
매개변수에서 diarizationSpeakerCount
필드를 설정하여 오디오 클립에 포함된 화자 수도 지정해야 합니다. diarizationSpeakerCount
값을 제공하지 않으면 Speech-to-Text는 기본값을 사용합니다.
Speech-to-Text는 speech:recognize
speech:longrunningrecognize
, 스트리밍 등 모든 음성 인식 메서드의 화자 분할을 지원합니다.
로컬 파일 사용
다음 코드 스니펫은 로컬 파일을 사용하여 Speech-to-Text에 대한 텍스트 변환 요청에서 화자 분할을 사용 설정하는 방법을 보여줍니다.
프로토콜
자세한 내용은 speech:recognize
API 엔드포인트를 참조하세요.
동기 음성 인식을 수행하려면 POST
요청을 하고 적절한 요청 본문을 제공합니다. 다음은 curl
을 사용한 POST
요청의 예시입니다. 이 예시에서는 Google Cloud CLI를 사용하여 액세스 토큰을 생성합니다. gcloud CLI 설치에 대한 안내는 빠른 시작을 참조하세요.
curl -s -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ https://speech.googleapis.com/v1p1beta1/speech:recognize \ --data '{ "config": { "encoding": "LINEAR16", "languageCode": "en-US", "diarizationConfig": { "enableSpeakerDiarization": true, "minSpeakerCount": 2, "maxSpeakerCount": 2 }, "model": "phone_call", }, "audio": { "uri": "gs://cloud-samples-tests/speech/commercial_mono.wav" } }' > speaker-diarization.txt
요청이 성공하면 서버는 200 OK
HTTP 상태 코드와 응답을 JSON 형식으로 반환하여 speaker-diarization.txt
라는 파일에 저장합니다.
{ "results": [ { "alternatives": [ { "transcript": "hi I'd like to buy a Chromecast and I was wondering whether you could help me with that certainly which color would you like we have blue black and red uh let's go with the black one would you like the new Chromecast Ultra model or the regular Chrome Cast regular Chromecast is fine thank you okay sure we like to ship it regular or Express Express please terrific it's on the way thank you thank you very much bye", "confidence": 0.92142606, "words": [ { "startTime": "0s", "endTime": "1.100s", "word": "hi", "speakerTag": 2 }, { "startTime": "1.100s", "endTime": "2s", "word": "I'd", "speakerTag": 2 }, { "startTime": "2s", "endTime": "2s", "word": "like", "speakerTag": 2 }, { "startTime": "2s", "endTime": "2.100s", "word": "to", "speakerTag": 2 }, ... { "startTime": "6.500s", "endTime": "6.900s", "word": "certainly", "speakerTag": 1 }, { "startTime": "6.900s", "endTime": "7.300s", "word": "which", "speakerTag": 1 }, { "startTime": "7.300s", "endTime": "7.500s", "word": "color", "speakerTag": 1 }, ... ] } ], "languageCode": "en-us" } ] }
Go
Speech-to-Text용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Speech-to-Text 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Speech-to-Text Go API 참조 문서를 확인하세요.
Speech-to-Text에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Speech-to-Text용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Speech-to-Text 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Speech-to-Text Java API 참조 문서를 확인하세요.
Speech-to-Text에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Speech-to-Text용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Speech-to-Text 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Speech-to-Text Node.js API 참조 문서를 확인하세요.
Speech-to-Text에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Speech-to-Text용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Speech-to-Text 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Speech-to-Text Python API 참조 문서를 확인하세요.
Speech-to-Text에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Cloud Storage 버킷 사용
다음 코드 스니펫은 Google Cloud Storage 파일을 사용하여 Speech-to-Text에 대한 텍스트 변환 요청에서 화자 분할을 사용 설정하는 방법을 보여줍니다.
Go
Speech-to-Text용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Speech-to-Text 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Speech-to-Text Go API 참조 문서를 확인하세요.
Speech-to-Text에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Speech-to-Text용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Speech-to-Text 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Speech-to-Text Java API 참조 문서를 확인하세요.
Speech-to-Text에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Speech-to-Text용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Speech-to-Text 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Speech-to-Text Node.js API 참조 문서를 확인하세요.
Speech-to-Text에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Speech-to-Text용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Speech-to-Text 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Speech-to-Text Python API 참조 문서를 확인하세요.
Speech-to-Text에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.