비동기 HTTP 인터페이스

비동기 HTTP 인터페이스는 장시간의 음성을 텍스트화, 문자 기록하기 위한 논블로킹 HTTP API입니다.

이 API를 사용하려면 다음 단계를 실행합니다.

1. 음성 인식 작업 생성
2. 폴링하여 음성 인식 작업의 상태를 확인하고 결과 가져오기

1의 작업을 생성하는 방법은 로그의 유무 지정 방법 등이 다르지만, 동기 HTTP 인터페이스와 거의 동일합니다.

엔드포인트

동기 HTTP 인터페이스와 달리, 로그 저장 유무에 관계없이 엔드포인트의 기본은 동일합니다.

v2(신버전)

https://acp-api-async.amivoice.com/v2/recognitions

v1(기존 버전)

https://acp-api-async.amivoice.com/v1/recognitions

v1과 v2의 차이점에 대해서는 새 버전에 대해를 참조하십시오.

주의

• 기존 버전의 비동기 HTTP 인터페이스는 향후 중단될 예정입니다. 사용 중인 분들은 v2로 마이그레이션해 주시기 바랍니다.
• v2에서는 현재 감정 분석 기능을 사용할 수 없습니다. 감정 분석을 사용해야 하는 경우 v1을 사용해 주십시오.

인증

다음 중 하나의 방법으로 API key를 지정해 주십시오. 취득 방법은 API Key 발급 방법을 참조하십시오.

HTTP 요청 헤더

Authorization: Bearer {API_KEY}

작업 생성에서는 요청 파라미터(u 파라미터)로 설정도 가능합니다.

u={API_KEY}