메인 콘텐츠로 건너뛰기

업데이트 이력

AmiVoice API 및 본 매뉴얼의 주요 업데이트 이력을 게재하고 있습니다. 여기에 게재된 것 외에도 경미한 업데이트 및 수정은 수시로 이루어지고 있습니다.

AmiVoice API의 주요 기능 업데이트 이력​

2026-08-18: AWS PrivateLink를 통한 연결 지원​

AmiVoice API에 인터넷을 경유하지 않고 AWS 네트워크 내부에서 연결할 수 있는 AWS PrivateLink를 지원합니다. 고객의 VPC 내에 생성한 인터페이스 엔드포인트를 통해, 기존과 동일한 API key로 음성 인식, 사용자 사전 관리, API key 발급용 각 API를 이용할 수 있습니다. 본 기능을 이용하려면 미리 신청하셔야 합니다.

자세한 내용은 프라이빗 연결(AWS PrivateLink)을 참조하십시오.

2026-08-12: 감정 분석 기능을 비동기 HTTP 인터페이스 v2에서 출시​

감정 분석 기능은 지금까지 비동기 HTTP 인터페이스의 v1에서만 제공하였으나, 이번에 비동기 HTTP 인터페이스의 v2에서도 이용할 수 있게 되었습니다.

v1과 v2에서는 사용 방법이나 파라미터의 지정 방법, 응답 전체의 구조는 기본적으로 동일하지만, 감정 분석 엔진의 버전이 다르기 때문에 동일한 음성을 처리하더라도 감정 파라미터의 값이 동일하지 않습니다. 이는 감정 분석 엔진의 업데이트에 따른 것이며, 파라미터가 나타내는 감정의 정의에는 변경이 없습니다. v1에서 v2로 마이그레이션하는 경우에는 이 점에 유의해 주십시오.

또한, 비동기 HTTP 인터페이스의 v1에서는 제공 종료 시까지 v2와 병행하여 계속해서 감정 분석 기능을 이용하실 수 있습니다.

2026-07-28: 마이페이지의 표시 변경(일부 사용자)​

2025-06-30 마이페이지 리뉴얼 이후에 생성된 계정을 대상으로, 마이페이지의 "接続情報" 연결 정보에 표시되던 서비스 ID 및 서비스 비밀번호를 비표시로 전환하였습니다. 이들은 API Key 발급 API에서 인증용으로 사용하는 것으로 제시하였으나, 앞으로는 마이페이지에서 "API Key 발급 기능"을 활성화하여 발급한 API key를 이용하십시오.

서비스 ID와 서비스 비밀번호는 계정을 삭제하지 않는 한 변경할 수 없습니다. 따라서 인증 정보의 유출 위험을 줄이기 위해 마이페이지에서의 표시를 중지하였습니다.

또한, 마이페이지 리뉴얼 이전에 생성된 계정에 대해서는, 계속해서 "接続情報" 연결 정보에 표시됩니다. 변경할 수 없으므로 취급에 충분히 주의해 주시기 바랍니다.

2026-07-23: 정기 자동 테스트를 통한 음성 인식 엔진 Partial Outage(부분 장애) 감지 및 Statuspage 게시 시작​

현재까지도 음성 인식 서버의 로그를 모니터링하여 내부 서버 간의 통신 오류를 자동으로 감지하고 "接続障害" 연결 장애로 Statuspage에 표시하여 왔습니다. 한편, 기존 방법만으로는 내부 통신 오류 외의 원인으로 인해 클라이언트가 음성 인식 결과를 수신하지 못하는 경우를 충분히 감지하기 어려웠습니다.

이에 따라 실제 이용 환경과 동일한 방식으로 외부에서 각 음성 인식 엔진에 테스트 음성을 정기적으로 전송하고, 음성 인식 결과를 정상적으로 수신할 수 있는지를 확인하는 E2E 테스트를 추가하였습니다. 이를 통해, Partial Outage(부분 장애)에 대한 자동 감지 기능을 강화하였습니다.

어떠한 원인으로 인해 음성 인식 엔진에서 인식 결과가 반환되지 않는 상태가 지속된 경우, 그 상황을 자동으로 감지하여 Statuspage에 표시합니다.

2026-05-28: 새로운 기능 및 요청 매개변수 공개​

단어 단위의 인식 결과에서 언어 라벨을 획득하는 기능이 공개되었습니다. 요청 매개변수 "segmenterProperties"의 useLid로 활성화할 수 있습니다.

또한, 인식 결과의 신뢰도 임계값을 지정하는 매개변수인 "confidenceLevel"과 "音声入力_ルール」" 음성입력_규칙 엔진의 전용 매개변수인 "completeTimeout" 및 "wildcardModelPenalty"가 추가되었습니다.

그 외에, 기존 매개변수인 maxResponseTime과 targetResponseTime은 실시간 음성 인식에만 유효하고, maxDecodingRate와 targetDecodingRate는 녹음된 음성 데이터의 배치 처리 경우에만 유효하도록 기능이 개선되었습니다.

2026-03-02：클라이언트 라이브러리의 업데이트​

클라이언트 라이브러리에 대해, AmiVoice API에 새롭게 공개된 기능 대응 및 각 프로그래밍 언어의 최신 버전 지원 등 여러 업데이트가 포함된 1.1.12 버전을 공개하였습니다.

2026-02-16: End to End 엔진의 단어 강조 기능 공개​

End to End 엔진의 "단어 강조" 기능이 공개되었습니다. 이는 하이브리드 엔진의 "단어 등록"과 유사한 기능으로, 인식하기 어려운 단어를 더 쉽게 인식할 수 있게 합니다.

또한 이번 공개와 함께, 기존 기능인 "단어 등록"과 새롭게 추가된 "단어 강조" 기능을 통합하여, "사용자 사전"이라는 이름으로 제공하기로 하였습니다.

2025-11-18: 음성 인식 처리에 관한 새로운 기능 및 단어 등록의 프로파일 목록 취득 기능 공개​

음성 인식 처리에 관한 여러 가지 새로운 기능이 출시되었으며, 이를 활성화하는 요청 매개변수로 maxDecodingTime, maxResponseTime, maxDecodingRate, targetResponseTime, targetDecodingRate, recognitionTimeout, noInputTimeout가 추가되었습니다.

또한, 사용자 단어 등록 API에서 프로파일 목록 취득 기능이 공개되었습니다.

2025-10-31: "사용량 집계 태그"가 비동기 HTTP 인터페이스 v2에도 대응​

사용량 집계 태그가 비동기 HTTP 인터페이스 v2에도 대응하게 되어, 모든 인터페이스에서 사용할 수 있게 되었습니다.

2025-10-02: 다국어 End to End 엔진의 인식 결과에 언어 라벨 추가​

다국어 End to End 엔진의 단어 단위 인식 결과에 엔진이 인식한 단어의 언어를 나타내는 라벨이 출력되도록 되었습니다. 자세한 내용은 단어 단위의 결과의 results[0].tokens[].language를 참조하십시오.

2025-09-30: 새로운 기능 "사용량 집계 태그" 공개​

동일 계정을 공유할 경우, 사용량을 속성별로 조회할 수 있는 사용량 집계 태그를 출시하였습니다. 단, 비동기 HTTP 인터페이스 v2에만 본 기능이 아직 대응되지 않았습니다.

2025-08-13: WebM 컨테이너에 저장된 Opus 음성 데이터 지원​

AmiVoice API가 WebM 컨테이너에 저장된 Opus 음성 데이터도 지원하게 되었습니다. 자세한 내용은 헤더가 있는 음성 포맷을 참조하십시오.

2025-06-23: 단어 등록 API가 8k 음성에도 대응​

단어 등록 API를 이용하여 8kHz 음성용 프로파일을 설정 및 관리할 수 있게 되었습니다. 자세한 내용은 사용자 단어 등록의 각종 기능 설명의 "요청 파라미터"의 adf를 참조하십시오.

매뉴얼의 주요 업데이트 이력​

2026-08-04: 규칙 문법(Rule Grammar) 사용 시 지정 방법 게재​

AmiVoice API Private에서 사용 가능한 "音声入力_ルール" 음성입력_규칙 엔진(-a-rule-input-private)을 사용하는 경우에, 음성 인식 요청에서 사용할 규칙 문법을 지정하는 방법을 게재하였습니다. 또한, 이에 맞추어 규칙 문법에 관한 정보의 게재 위치 구성을 정리하였습니다.

게재 위치: 규칙 문법(Rule Grammar) 하위의 규칙 문법 파일의 지정 방법

2026-07-22: 보안 관련 정보 추가 게재​

AmiVoice API의 보안 관련 정보 페이지에, 신용카드 결제 정보 및 책임 분계에 관한 내용을 추가하였습니다.

게재 위치: 서비스 사양

2026-07-10: 생성형 AI・코딩 에이전트를 위한 가이드 공개​

1. 색인 파일 llms.txt 공개​

주요 API 사양 및 각종 문서를 위한 링크・개요를 정리한, AI용 인덱스 파일 llms.txt를 공개. AI 에이전트가 먼저 이 파일을 읽어 들임으로써 필요한 정보에 최단 경로로 접근할 수 있게 됩니다.

2. Markdown 버전 문서 제공​

모든 문서 페이지에서 AI가 쉽게 해석할 수 있으며, 토큰 사용량 절감에 최적화된 일반 Markdown 형식의 출력을 지원합니다. 아래 방법 중 하나로 이용할 수 있습니다.

  • 각 문서 페이지의 URL 끝에 .md를 붙여 요청
  • HTTP 요청 시에 Accept: text/markdown 헤더를 붙여 요청

AI 크롤러나 에이전트가 이러한 리소스를 자동으로 검출할 수 있도록, 일반적인 HTML 페이지 응답의 HTTP 헤더에 대응하는 Markdown 버전의 URL이나 llms.txt의 위치를 나타내는 Link 헤더를 부여하고 있습니다.

4. 개발자 여러분께 드리는 활용 방법 안내​

위의 새로운 기능을 활용하여 생성형 AI나 코딩 에이전트를 이용한 개발을 진행할 때의 AmiVoice API 활용 방법에 대한 가이드를 공개하였습니다.

게재 위치: 생성형 AI를 활용한 개발

2026-07-09: API 레퍼런스를 매뉴얼에서 분리​

AmiVoice API의 레퍼런스를 매뉴얼에서 분리하여 전용 탭에서 참조할 수 있도록 변경하였습니다. HTTP 인터페이스의 API는, OpenAPI 형식의 사양서에서 자동 생성되는 레퍼런스 방식으로 변경했습니다. 이를 통해 항상 최신 사양을 확인할 수 있을 뿐만 아니라, 각종 개발 도구에 사양을 직접 가져올 수 있게 되었습니다.

게재 위치: 레퍼런스

2026-06-26: WebSocket 인터페이스에서 HTTP 요청 헤더로 인증 정보를 전송하는 방법 공개​

WebSocket 인터페이스에서 인증 정보(API key)를 WebSocket 연결 후의 s 명령어 내에서 전송하는 것이 아니라, WebSocket 연결 시의 HTTP 요청 헤더에 기술하여 전송하는 방법을 공개하였습니다.

게재 위치: HTTP 요청 헤더로 인증 정보를 전송하는 방법

2026-06-12: 사용자 사전 "Quick Start" 공개​

사용자 사전 기능을 간단히 테스트해 볼 수 있도록 Quick Start를 공개하였습니다.

게재 위치: 사용자 사전

2026-06-08: 이용 약관과 SLA 페이지 개설​

이용 약관과 SLA에 대해 새롭게 매뉴얼의 별도 탭에 게재하도록 하고, 업데이트 기록과 일부 과거 버전도 이용할 수 있게 되었습니다.

게재 위치: AmiVoice API 이용 약관・SLA (영어)

2026-05-08: 마이페이지에 대한 정보 공개​

AmiVoice API의 마이페이지에 대한 정보를 공개하였습니다.

게재 위치: 마이페이지(관리 화면) 사용 방법

2026-04-14: "APPKEY"를 "API key"로 명칭 변경​

AmiVoice API를 이용할 때 인증에 필요한 "서비스 인증 키 문자열"에 대해, 명칭을 "APPKEY"에서 "API key"로 변경하였습니다. 또한 기존에 "원타임 APPKEY"라고 부르던 것도 "API key"로 통일하였습니다. 이에 따라, API key에 관한 설명 페이지를 추가하고 매뉴얼의 구성을 일부 변경하였습니다.

게재 위치: API Key 및 하위 페이지

또한 API key 발급 API 레퍼런스에서, 잘못된 서비스 ID나 서비스 비밀번호를 사용하여 발급된 API key를 사용했을 때의 오류 메시지에 대해, 매뉴얼의 기재에 오류가 있어 수정하였습니다.

게재 위치: API key 발급 중 "주의" 기재 내용

2026-04-03: 발화 검출에 관한 요청 매개변수 조정 참고 정보 공개​

요청 매개변수 segmenterProperties 중 발화 검출에 관한 매개변수에 대해 이용 장면별 권장값과 조정 예시를 공개하였습니다.

게재 위치: 권장값은 segmenterProperties, 매개변수 조정 예시는 발화 검출 매개변수 조정

2026-03-24: 사용자 사전 데이터 사용 및 관리 방법에 대해 공개​

AmiVoice API의 서비스 사양의 한 요소로 사용자 사전 데이터 사용 및 관리 방법에 대해 공개하였습니다.

게재 위치: 서비스 사양 중 사용자 사전 데이터 취급 및 로그 저장 옵션과 데이터 제공에 대해

2026-03-12: "시작하기" 페이지 리뉴얼​

"시작하기" 페이지를 리뉴얼하여 더 쉽게 AmiVoice API를 시작할 수 있도록 Quick Start 가이드를 공개하였습니다. 기존의 튜토리얼은 각 인터페이스 사용법 페이지에 통합하였습니다.

게재 위치: 시작하기(Quick Start)

2026-03-11: 서비스 사양 정보 공개​

AmiVoice API의 보안 등 서비스 사양에 대해 공개하였습니다.

게재 위치: 서비스 사양

2026-01-08: 시스템 장애 정보 알림용 이메일 주소 설정 방법 게재​

AmiVoice API의 장애 정보를 이메일로 전송하기 위한 알림용 이메일 주소 설정 방법에 대해 게재했습니다. 또한, 부분적으로 매뉴얼의 구성을 변경했습니다.

게재 위치: 시스템 장애 정보 알림 설정

2025-12-10: 화자 다이어리제이션 관련 매개변수의 기본값 수정​

게재 위치: segmenterProperties 중 "화자 다이어리제이션에 관한 매개변수", 화자 다이어리제이션의 화자 검출 감도 조정

2025-12-02: Statuspage 정보 추가​

AmiVoice API의 시스템 장애 및 지연 정보를 제공하는 Statuspage에 대한 정보를 추가하였습니다.

게재 위치: 시스템 장애 및 지연 정보

2025-10-01: 규칙 문법(Rule Grammar) 정보 추가​

AmiVoice API Private에서 이용 가능한 "音声入力_ルール" 음성입력_규칙 엔진(-a-rule-input-private)에서 사용하는 규칙 문법 파일에 관한 정보를 추가하였습니다.

게재 위치: 규칙 문법(Rule Grammar)

2025-08-13: segmenterProperties의 정보 추가​

요청 파라미터 segmenterProperties 중 음성 인식의 발화 구간 검출 조정에 관한 파라미터에 대한 정보를 추가하였습니다.

게재 위치: segmenterProperties 중 "발화 구간 검출 파라미터"