빠른 시작: Azure AI Speech CLI 시작

  • 아티클

이 문서에서는 Azure AI Speech CLI(SPX라고도 함)를 사용하여 코드를 작성하지 않고도 음성 텍스트 변환, 텍스트 음성 변환 및 음성 번역과 같은 Speech Service에 액세스하는 방법에 대해 알아봅니다. Speech CLI는 프로덕션 환경에 즉시 사용할 수 있으며, .bat 또는 셸 스크립트를 사용하여 Speech Service에서 간단한 워크플로를 자동화하는 데 사용할 수 있습니다.

이 문서에서는 사용자가 명령 프롬프트 창, 터미널 또는 PowerShell에 대한 실무 지식이 있다고 가정합니다.

참고 항목

PowerShell에서 stop-parsing 토큰(--%)은 spx 다음에 와야 합니다. 예를 들어 spx --% config @region을 실행하여 현재 지역 구성 값을 확인합니다.

다운로드 및 설치

Windows에 Speech CLI를 설치하려면 다음 단계를 수행합니다.

  1. 플랫폼에 맞는 Visual Studio 2019용 Microsoft Visual C++ 재배포 가능 패키지를 설치합니다. 처음 설치하는 경우 재시작이 필요할 수 있습니다.

  2. .NET 6을 설치합니다.

  3. 다음 명령을 입력하여 .NET CLI를 통해 Speech CLI를 설치합니다.

    dotnet tool install --global Microsoft.CognitiveServices.Speech.CLI

    음성 CLI를 업데이트하려면 다음 명령을 입력합니다.

    dotnet tool update --global Microsoft.CognitiveServices.Speech.CLI

음성 CLI에 대한 도움말을 보려면 spx 또는 spx help를 입력합니다.

글꼴 제한 사항

Windows에서 Speech CLI는 로컬 컴퓨터의 명령 프롬프트에서 사용할 수 있는 글꼴만 표시할 수 있습니다. Windows 터미널은 Speech CLI에서 대화형으로 생성하는 모든 글꼴을 지원합니다.

파일로 출력하면 메모장과 같은 텍스트 편집기나 Microsoft Edge와 같은 웹 브라우저도 모든 글꼴을 표시할 수 있습니다.

리소스 구성 만들기

시작하려면 Speech 리소스 키 및 지역 식별자(예: eastus, westus)가 필요합니다. Azure Portal에서 음성 리소스를 만듭니다. 자세한 내용은 다중 서비스 리소스 만들기를 참조하세요.

리소스 키와 지역 식별자를 구성하려면 다음 명령을 실행합니다.

spx config @key --set SPEECH-KEY
spx config @region --set SPEECH-REGION

키와 지역은 이후 Speech CLI 명령에 대해 저장됩니다. 현재 구성을 확인하려면 다음 명령을 실행합니다.

spx config @key
spx config @region

필요에 따라 저장된 값 중 하나를 제거하는 clear 옵션을 포함합니다.

spx config @key --clear
spx config @region --clear

기본 사용법

Important

컨테이너에서 음성 CLI를 사용하는 경우 --host 옵션을 포함하세요. CLI가 인증을 위해 음성 키를 사용하지 않도록 하려면 --key none도 지정해야 합니다. 예를 들어 spx recognize --key none --host wss://localhost:5000/ --file myaudio.wav를 실행하여 음성 텍스트 변환 컨테이너의 오디오 파일에서 음성을 인식합니다.

이 섹션에서는 처음으로 테스트 또는 실험을 수행할 때 도움이 되는 몇 가지 기본 SPX 명령을 보여줍니다. 도구 내 도움말을 보려면 다음 명령을 실행합니다.

spx

키워드를 기준으로 도움말 항목을 검색할 수 있습니다. 예를 들어 Speech CLI 사용 예제 목록을 보려면 다음 명령을 실행합니다.

spx help find --topics "examples"

recognize 명령에 대한 옵션을 보려면 다음 명령을 실행합니다.

spx help recognize

추가 도움말 명령이 콘솔 출력에 나열됩니다. 이러한 명령을 입력하여 하위 명령에 대한 자세한 도움말을 가져올 수 있습니다.

음성 - 텍스트 변환(음성 인식)

참고 항목

Docker 컨테이너 내에서 Speech CLI를 실행하는 경우 컴퓨터의 마이크를 사용할 수 없습니다. 그러나 로컬에 탑재된 디렉터리에서는 오디오 파일을 읽고 저장할 수 있습니다.

시스템의 기본 마이크를 사용하여 음성을 텍스트로 변환(음성 인식)하려면 다음 명령을 실행합니다.

spx recognize --microphone

명령이 실행되면 SPX에서 현재 활성 입력 디바이스의 오디오 수신 대기를 시작합니다. Enter 키를 선택하면 수신 대기가 중지됩니다. 그러면 음성 오디오가 인식되고 콘솔 출력의 텍스트로 변환됩니다.

Speech CLI를 사용하면 오디오 파일의 음성을 인식할 수도 있습니다. 다음 명령을 실행합니다.

spx recognize --file /path/to/file.wav

팁

문제가 발생하거나 Speech CLI 인식 옵션에 대해 자세히 알아보려면 spx help recognize를 실행할 수 있습니다.

텍스트 음성 변환(음성 합성)

다음 명령은 텍스트를 입력으로 사용한 다음, 합성된 음성을 현재 활성 출력 디바이스(예: 컴퓨터 스피커)로 출력합니다.

spx synthesize --text "Testing synthesis using the Speech CLI" --speakers

또한 합성된 출력은 파일에 저장할 수 있습니다. 다음 예제에서는 명령을 실행하는 디렉터리에 my-sample.wav라는 파일을 만들어 보겠습니다.

spx synthesize --text "Enjoy using the Speech CLI." --audio output my-sample.wav

이 예제에서는 영어로 테스트하는 것으로 가정합니다. 그러나 Speech Service는 음성 합성을 다양한 언어로 지원합니다. 다음 명령을 실행하거나 언어 지원 페이지를 방문하여 전체 음성 목록을 끌어올 수 있습니다.

spx synthesize --voices

검색한 음성 중 하나를 사용하는 명령은 다음과 같습니다.

spx synthesize --text "Bienvenue chez moi." --voice fr-FR-AlainNeural --speakers

팁

문제가 발생하거나 Speech CLI 인식 옵션에 대해 자세히 알아보려면 spx help synthesize를 실행할 수 있습니다.

음성을 텍스트로 번역

Speech CLI를 사용하여 음성을 텍스트로 번역할 수도 있습니다. 다음 명령을 실행하여 기본 마이크에서 오디오를 캡처하고, 번역을 텍스트로 출력합니다. translate 명령을 사용하여 source 및 target 언어를 제공해야 한다는 점을 기억하세요.

spx translate --microphone --source en-US --target ru-RU

여러 언어로 번역하는 경우 언어 코드를 세미콜론(;)으로 구분합니다.

spx translate --microphone --source en-US --target ru-RU;fr-FR;es-ES

번역 출력을 저장하려면 --output 플래그를 사용합니다. 이 예제에서는 파일의 음성도 읽습니다.

spx translate --file /some/file/path/input.wav --source en-US --target ru-RU --output file /some/file/path/russian_translation.txt

팁

문제가 발생하거나 Speech CLI 인식 옵션에 대해 자세히 알아보려면 spx help translate를 실행할 수 있습니다.

다음 단계