빠른 시작: gcloud 도구 사용

이 페이지에서는 명령줄에서 gcloud 도구를 사용하여 Speech-to-Text에 음성 인식 요청을 보내는 방법을 설명합니다.

Speech-to-Text를 사용하면 Google 음성 인식 기술을 개발자 애플리케이션에 간편하게 통합할 수 있습니다. 오디오 데이터를 Speech-to-Text API로 보내면 Speech-to-Text API가 이 오디오 파일을 텍스트로 변환하여 반환합니다. 이 서비스에 대한 자세한 내용은 Speech-to-Text 기본사항을 참조하세요.

시작하기 전에

  1. Google 계정으로 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. Cloud Console 프로젝트를 설정합니다.

    프로젝트 설정

    클릭하여 다음을 수행하세요.

    • 프로젝트를 만들거나 선택합니다.
    • 프로젝트에 Speech-to-Text API를 사용 설정합니다.
    • 서비스 계정 만들기
    • 비공개 키를 JSON으로 다운로드합니다.

    언제든지 Cloud Console에서 이 리소스를 보고 관리할 수 있습니다.

  3. 환경 변수 GOOGLE_APPLICATION_CREDENTIALS를 서비스 계정 키가 포함된 JSON 파일의 경로로 설정합니다. 이 변수는 현재 셸 세션에만 적용되므로, 새 세션을 열 경우, 변수를 다시 설정합니다.

  4. Cloud SDK를 설치하고 초기화합니다.

오디오 텍스트 변환 요청하기

이제 Speech-to-Text를 사용하여 오디오 파일을 텍스트로 변환할 수 있습니다. 다음 코드 샘플을 사용하여 Speech-to-Text API에 recognize 요청을 보냅니다.

명령줄 셸을 열고 다음 명령어를 실행합니다.

    gcloud ml speech recognize gs://cloud-samples-tests/speech/brooklyn.flac \
        --language-code=en-US
    

이 명령어는 Speech-to-Text가 공개 액세스 가능한 위치에서 호스팅된 FLAC가 있는 오디오를 텍스트로 변환하도록 요청합니다.

요청이 성공하면 서버는 JSON 형식의 응답을 반환합니다.

    {
      "results": [
        {
          "alternatives": [
            {
              "confidence": 0.9840146,
              "transcript": "how old is the Brooklyn Bridge"
            }
          ]
        }
      ]
    }
    

수고하셨습니다. 첫 번째 요청을 Speech-to-Text에 보냈습니다.

Speech-to-Text에서 오류 또는 빈 응답이 반환되면 문제해결오류 완화 단계를 살펴보세요.

다음 단계