STT

공통 설정

인증 토근 발급받기 위한 계정 생성 이름, 이메일, 패스워드 입력 후 계정을 생성 해야만 정상적으로 사용이 가능합니다.

이메일 / 패스워드 입력 토큰 값 발급 후 인증 통해 정상적으로 API 를 이용 하실 수 있습니다.

토큰은 발급 1시간 후 자동 파기 됩니다. 재발급 받으셔야 정상 이용 가능합니다.

Method	Request URI
POST	/api/v1/stt

헤더명	설명
Authorization	로그인 또는 회원 가입 후 발급 받은 토큰키 입력 Bearer [토큰값]
Content-Type	multipart/form-data

파라미터 이름	타입	설명	기본값	필수 여부
lang	string	음성 인식에 사용할 언어 Kor: 한국어 Jpn: 일본어 Eng: 영어 Chn: 중국어	KOR	Y
file	binary	mp3, aac, ac3, ogg, flac, wav 음성 파일	N	Y

파라미터 이름

타입

설명

기본값

필수 여부

lang

string

음성 인식에 사용할 언어

KOR

file

binary

mp3, aac, ac3, ogg, flac, wav 음성 파일

필드 이름	타입	설명
TEXT	string	음성 파일에 대한 텍스트

# JSON
 
{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

HttpStatusCode	ErrorCode	ErrorMessage	Description
400	100	Bad Request Exception	protocol(https), endocing(UTF-8) 등 request 오류
401	200	Authentication Failed	인증실패
401	210	Permission Denied	권한없음
404	300	Not Found Exception	권한없음
429	400	Quota Exceeded	Quota 초과
429	410	Throttle Limited	Rate 초과
429	420	Rate Limited	Rate 초과
413	430	Request Entity Too Large	content-length 초과 (10MB)
503	500	Endpoint Error	엔드포인트 연결오류
504	510	Endpoint Timeout	엔드포인트 연결시간 초과
500	900	Unexpected Error	예외처리가 안된 오류

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