Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

음성 인식 프로젝트 설정

Google Distributed Cloud (GDC) 에어 갭 어플라이언스의 Speech-to-Text를 사용하면 애플리케이션에서 오디오 파일을 텍스트로 변환할 수 있습니다. 프로젝트를 만들고 개발자 역할을 요청한 후 GDC 콘솔에서 Speech-to-Text API를 사용 설정하여 서비스 상태와 엔드포인트를 확인합니다. 그런 다음 Python 클라이언트 라이브러리를 설치하고, 환경 변수를 정의하고, gdcloud CLI를 사용하여 서비스 계정을 구성하고 요청을 인증할 수 있습니다. Vertex AI를 처음 사용하는 경우 음성 인식 기능 알아보기를 참조하세요.

프로젝트 만들기

음성 인식 프로젝트를 만들면 공동작업자, 사용 설정된 API, 사용자 인증 정보, 액세스 제어를 포함한 Speech-to-Text 리소스가 정리됩니다.

프로젝트를 만들려면 Vertex AI용 프로젝트 설정을 참고하세요. API를 호출할 때 프로젝트 ID가 필요합니다.

개발자 권한 요청

음성 인식 기능에 액세스하고 요청 인증 및 승인을 위한 API 토큰을 생성하려면 프로젝트에 AI 음성 개발자 역할이 있어야 합니다.

프로젝트 IAM 관리자에게 프로젝트 네임스페이스 내의 사용자 또는 서비스 계정에 AI 음성 개발자(ai-speech-developer) 역할을 부여해 달라고 요청하세요. 이 역할에 대한 자세한 내용은 IAM 권한 준비를 참조하세요.

Speech-to-Text API 사용 설정

프로젝트에 Speech-to-Text 선행 학습된 API를 사용 설정해야 합니다. 사용 설정하면 Speech-to-Text 선행 학습된 API의 서비스 상태 및 엔드포인트를 확인할 수 있습니다.

클라이언트 라이브러리 설치

Python 프로그래밍 언어에 클라이언트 라이브러리를 사용할 수 있습니다. 이러한 클라이언트 라이브러리를 사용하면 API에 더 쉽게 액세스할 수 있으므로 Speech-to-Text API를 호출하는 것이 좋습니다.

Speech-to-Text 클라이언트 라이브러리를 설치하고 다음 단계에 따라 올바른 버전이 있는지 확인합니다.

Speech-to-Text 클라이언트 라이브러리가 설치되어 있는지 확인하고 버전 번호를 가져옵니다.
```
pip freeze | grep speech
```
클라이언트 라이브러리가 이미 설치되어 있으면 다음 예시와 비슷한 출력이 표시됩니다.
```
google-cloud-speech==2.15.0
```
가져오는 버전 번호는 다음 엔드포인트의 클라이언트 라이브러리와 일치해야 합니다.
```
https://GDC_URL/.well-known/static/client-libraries
```
GDC_URL를 GDC의 조직 URL로 바꿉니다.
버전 번호가 일치하지 않으면 클라이언트 라이브러리를 제거합니다.
```
pip uninstall google-cloud-speech
```
Speech-to-Text 클라이언트 라이브러리를 제거한 경우 운영체제에 해당하는 파일 이름을 지정하여 다시 설치해야 합니다.

환경 변수 설정

Speech-to-Text 클라이언트 라이브러리를 설치한 후 Python 스크립트에서 API와 상호작용할 수 있습니다.

프로젝트에서 서비스 계정을 설정하여 승인된 API 호출을 프로그래매틱 방식으로 수행하는 경우 Python 스크립트에서 환경 변수를 정의하여 실행 시 서비스 계정 키와 같은 값에 액세스할 수 있습니다.

Python 스크립트에서 필수 환경 변수를 설정하려면 다음 단계를 따르세요.

Python 스크립트를 만듭니다.
Python 스크립트에 다음 코드를 추가합니다.
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
```
APPLICATION_DEFAULT_CREDENTIALS_FILENAME를 프로젝트에서 만든 서비스 계정 키가 포함된 JSON 파일의 이름(예: my-service-key.json)으로 바꿉니다.
Python 스크립트를 speech.py과 같은 이름으로 저장합니다.
Python 스크립트를 실행하여 환경 변수를 설정합니다.
```
python SCRIPT_NAME
```
SCRIPT_NAME을 Python 스크립트에 지정한 이름(예: speech.py)으로 바꿉니다.

인증 설정

Speech-to-Text API를 사용하려면 먼저 클라이언트 사용자 인증 정보를 인증하고 프로젝트 리소스에 대한 계정 액세스를 요청해야 합니다. 자세한 내용은 API 요청 인증을 참조하세요.