CLOVA Speech 단문 인식 API

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

version

Version	Date	Changes
v1.0.0	2023-11-23	최초 작성

요청

Method	Request URI
POST	CLOVA Speech 도메인에서 생성된 API Gateway의 InvokeURL로 호출

API URL

Method	Request URI
POST	`https://clovaspeech-gw.ncloud.com/recog/v1/stt`

요청 헤더

헤더명	설명
`X-CLOVASPEECH-API-KEY`	`{Secret Key}`
`Content-Type`	`application/octet-stream`

Query Param

name	value
`lang`	`Kor`

참고

금융환경에서는 한국어만 지원합니다.

Example (cURL shell)

curl --location 'https://beta-clovaspeech-gw.ncloud.com/recog/v1/stt?lang=Kor' \
--header 'X-CLOVASPEECH-API-KEY: ${secret key}' \
--header 'Content-Type: application/octet-stream' \
--data '@/D:/example.mp3'

응답

응답 바디

Field Name	Description
text	인식한 음원의 결과 값
quota	음원 길이 (15초 단위)

{
    "text": "코이코 아산 서울 수영장입니다 입장료가 얼마예요 5천원이에요 감사합니다",
    "quota": 30
}

오류 코드

{
    "timestamp": 1700536699045,
    "error": {
        "errorCode": "STT005",
        "message": "Invalid Language"
    }
}

API 오류

HttpStatusCode	ErrorCode	ErrorMessage	Description
400	400	-	Invalid request parameters
401	401	Invalid secret	Invalid secret
413	STT001	Exceed Sound Data length	허용 음성데이터 길이 초과 ( 60초 )
400	STT002	Invalid Content Type	application/octet-stream 이외의 content-type인 경우 발생
400	STT003	Empty Sound Data	음성 데이터가 입력되지 않았음
400	STT005	Invalid Language	정해진 언어 이외의 언어 값이 입력됨
400	STT004	Empty Language	언어 파라미터가 입력되지 않았음
500	STT006	Failed to pre-processing	음성인식 전처리 중 오류 발생 음성 데이터가 정상적인 wav, mp3, flac 인지 확인 필요
500	STT998	Failed to STT	음성인식 중 오류 발생 고객지원을 통해 문의하면 신속히 조치 가능
500	STT999	Internal Server Error	알 수 없는 오류 발생 고객지원을 통해 문의하면 신속히 조치 가능

이 문서가 도움이 되었습니까?

What's Next

CLOVA OCR 개요

version
요청
응답