메인 콘텐츠로 건너뛰기

사용량 집계 태그

동일 계정 공유 시 속성별 사용량 조회​

AmiVoice API를 사용한 서비스를 제공할 때, 여러 시스템이나 환경, 최종 사용자 별로 각각 AmiVoice API 계정을 사용하지 않고, 하나의 AmiVoice API 계정을 공유하는 경우가 있을 수 있습니다. 이러한 경우에 임의의 속성마다 사용량 집계 태그를 설정함으로써, 속성별 AmiVoice API 사용량을 조회할 수 있으며, 분석 등에 활용할 수 있습니다.

개요​

음성 인식 요청을 보낼 때, 요청 매개변수에 임의의 사용량 집계 태그(billing_key)를 설정함으로써, 태그별 사용량을 조회할 수 있습니다. 연결 엔진과 사용량 태그의 조합별로 정리되어 제공되며, 마이페이지에서 [MyPage > 利用料金の確認 > 利用明細 > 発話量CSV出力]에서 발화량 이용 명세를 CSV 파일로 다운로드할 수 있습니다. 예를 들어, 최종 사용자마다 태그(user01 user02 등)를 설정하면, 최종 사용자별 사용량을 집계하고, 사용 현황을 분석하거나, 최종 사용자별 청구용 이용량을 계산하는 데 활용할 수 있습니다. "그 외에도 다음과 같은 방식으로 사용할 수 있습니다.

  • 여러 시스템에서 계정을 공유하는 경우, 시스템별 사용량 집계(voicebot transcription 등)
  • 환경별 사용량 집계(development staging production 등)
  • 시스템 버전별 사용량 집계(v1 v2 등)
  • 사용 단말기별 집계(tel01 tel02 등)
노트
  • 이용 명세 파일이 사용량 집계 태그별로 분할되는 것이 아니라, 한 개의 파일 내에 태그별 집계가 출력됩니다.
  • 마이페이지 [今月の使用量]에서는 태그별 집계를 확인할 수 없습니다.

요청 방법​

사용량 집계 태그 billing_key는 요청 매개변수에 extension을 설정하고, 그 안에 기술하는 것으로 client_info 아래에 추가합니다. billing_key에는 임의의 문자열을 설정하십시오.

extension 설정 예:

{
    "client_info": {
        "billing_key": "any_key_for_billing_aggregation"
    }
}

동기・비동기 HTTP 인터페이스의 경우​

d 매개변수에 extension을 설정합니다. extension의 값은 URL 인코딩하십시오.

동기 HTTP 인터페이스에서 위의 내용의 extension으로 요청을 보내는 경우의 예:

curl -X POST https://acp-api.amivoice.com/v1/nolog/recognize \
     -F u={YOUR_APPKEY} \
     -F d="grammarFileNames=-a-general extension=%7B%22client_info%22%3A+%7B%22billing_key%22%3A+%22any_key_for_billing_aggregation%22%7D%7D" \
     -F a=@test.wav

WebSocket 인터페이스의 경우​

s 명령어의 요청 행에 extension을 설정합니다. extension에 설정하는 문자열 중 "는 ""와 같이 2개를 겹쳐서 이스케이프 처리하십시오.

WebSocket 인터페이스에서 위의 내용의 extension으로 요청을 보내는 경우의 예:

s 16K -a-general extension="{""client_info"":{""billing_key"":""any_key_for_billing_aggregation""}}" authorization={YOUR_APPKEY}