메인 콘텐츠로 건너뛰기

사용자 사전의 이용 방법

미리 등록해 두는 방법으로 단어를 프로파일에 저장한 경우, 해당 단어를 활성화하는 방법을 설명합니다.

사용 방법​

음성 인식 요청 파라미터에 음성 인식 엔진(grammarFileNames)과 함께 프로파일 ID(profileId)를 설정합니다. 해당 요청 세션 중에는 프로파일에 등록된 단어가 활성화됩니다.

grammarFileNames={연결 엔진 이름} profileId=:{프로파일 ID}
  • profileId에는 ":" (콜론) 다음에 프로파일 이름을 지정하십시오.
  • 프로파일은 음성 인식 엔진별로 구분되므로, 단어 등록 시 지정한 grammarFileNames를 요청 시에도 설정하십시오.
  • 마이페이지에서 등록한 경우, 프로파일 ID에 서비스 ID를 설정하십시오. 서비스 ID는 마이페이지의 [アカウント情報] 계정 정보에 표시된 [サービス ID]입니다. 예를 들어, 서비스 ID가 "user01"인 경우 profileId=:user01로 지정합니다.

WebSocket 인터페이스의 경우, 다음과 같이 s 명령어에 지정합니다. 음성 형식에 대한 자세한 내용은 여기를 참조하십시오.

s {음성_형식명} {연결_엔진명} profileId=:{프로파일 ID}
팁

profileId 앞에 ":"를 붙이지 않아도 작동합니다. 그러나 다음과 같은 이유로 의도하지 않은 내용으로 프로파일이 저장되어 인식 정확도가 저하될 수 있습니다.

  • ":"를 붙이지 않은 경우, 음성 인식 처리 세션 종료 시 해당 세션에서 사용된 프로파일 내용으로 프로파일이 덮어쓰기됩니다.
  • 예를 들어, test라는 프로파일을 사용하여 음성 인식 처리를 실행하는 중에, 별도로 사용자 사전 등록 API로 test 프로파일의 내용을 업데이트했다고 가정합니다. 이 경우, 음성 인식 세션 종료 시 test 프로파일은 "음성 인식 처리에 사용된 내용" = "사용자 사전 등록 API로 업데이트하기 전의 내용"으로 덮어쓰기되어 롤백됩니다.

만약 profileId와 profileWords를 동시에 지정한 경우에는 profileWords가 우선됩니다. 이미 프로필에 등록된 단어는 활성화되지 않습니다.

예를 들어, 다음과 같이 "会話_汎用(대화 범용) 엔진"(-a-general)에서 profileId에 ":test", profileWords에 "AMI あみ"로 설정하여 요청을 한 경우. 이 세션에서는 profileId로 지정한 프로필에 저장된 단어는 활성화되지 않습니다. profileWords에 설정한 "AMI あみ"만 활성화됩니다.

grammarFileNames=-a-general profileId=:test profileWords="AMI あみ"

하나의 요청으로 동시에 여러 사용자 사전을 이용하는 경우​

하나의 음성 인식 요청에 대해 사용자 사전은 동시에 최대 5개까지 이용할 수 있습니다. 여러 사용자 사전을 이용하는 경우, profileId에 ":"(반각 콜론)로 구분하여 나열해서 지정합니다.

예를 들어 dic1, dic2, dic3의 세 가지 프로파일을 이용하는 경우, profileId에 다음과 같이 지정합니다.

profileId=:dic1:dic2:dic3

사용자 사전의 테스트​

음성 파일(www.wav)을 다운로드하여 명령어를 실행할 디렉토리에 복사하십시오. "とりぷるだぶる"라는 발화가 녹음되어 있습니다. 다음 파라미터를 설정하여 샘플을 실행합니다.

  • profileId에는 프로파일 ID 앞에 ":"(반각 콜론)을 붙여서 지정하십시오.
  • {API_KEY}는 마이페이지에 표시된 [API キー] API key입니다.
curl https://acp-api.amivoice.com/v1/recognize \
     -F u={API_KEY} \
     -F d="grammarFileNames=-a-general profileId=:{프로파일 ID}" \
     -F a=@www.wav

JavaScript 버전 샘플에서는, 아래의 같은 방법으로 사용자 사전의 효과를 확인할 수 있습니다.

  1. WrpTester.html 또는 wrp.html을 브라우저(IE는 미대응)에서 엽니다.
  2. [プロファイル ID]에는, 이용하고자 하는 프로파일 ID 선두에 ":"(콜론)를 붙여서 입력합니다.
  3. [APPKEY]에는, 마이페이지의 [API キー] API key를 입력합니다.
  4. [録音の開始] 버튼을 클릭하여 녹음이 시작되면 "とりぷるだぶる"라고 발화합니다.

JavaScript 버전 샘플에서 API key를 취득하여 실행하는 절차는 여기를 참조하십시오.