개발가이드

  • 개발가이드

오디오 텍스트 변환(STT)

STT(Speech To Text) 음성 파일을 텍스트로 변환합니다.

정보

Method
URL
POST
https://apick.app/rest/stt

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
audio
File
O
음성 파일
language
String
O
추출 언어
지원 언어
ko: 한국어
en: 영어
zh: 중국어
de: 독일어
es: 스페인어
fr: 프랑스어
ja: 일본어

응답

Body
이름
타입
설명
data
Object
조회 데이터
text
String
전체 추출 텍스트
segments
Array
구간별 데이터
{}
Object
구간 정보
id
Integer
구간 ID
start
Double
시작 구간
end
Double
끝 구간
text
String
추출 텍스트
language
String
추출 언어
duration
Double
재생 시간
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/stt" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "audio=@/C:/Users/user/Desktop/sample_audio.mp3" \
-F "language=ko"
            
응답 예시

{
    "data": {
        "text": " 절기상 대설인 오늘은 일교차를 유의하셔야겠습니다. 현재 서울 기온 1.3도로 어제 같은 시간보다 다소 공기가 차가워졌는데요. 어제 내린 비가 얼어붙은 곳이 있어서 도로 살얼음 유의하셔야겠고요. 낮부터는 기온이 오르면서 비교적 온화하겠습니다. 현재 제주와 일부 전남과 경남, 동해안을 중심으로는 강풍특보가 발효 중이고요. 건조주의보까지 이어지는 곳들이 있어서 시설물 관리와 각종 화재 사고 발생하지 않도록 주의하셔야겠습니다. 오늘은 전국 하늘 미세먼지 걱정 없이 대체로 쾌청하게 드러나겠습니다. 자자한 현재 기온을 살펴보시면 서울 1.3도, 광주 6.3도, 부산 7.1도로 출발하고 있고요. 낮이 되면 서울 11도, 전주와 광주, 부산 13도까지 오르는 등 비교적 포근하겠습니다. 당분간 뚜렷한 비 소식 없겠고요. 금요일인 내일은 서울 낮 기온 16도까지 오르는 등 예년보다 온화한 날들이 이어지겠습니다. 날씨였습니다.",
        "segments": [
            {
                "id": 0,
                "start": 0,
                "end": 2.5,
                "text": " 절기상 대설인 오늘은 일교차를 유의하셔야겠습니다."
            },
            {
                "id": 1,
                "start": 3.74,
                "end": 7.24,
                "text": " 현재 서울 기온 1.3도로 어제 같은 시간보다 다소 공기가 차가워졌는데요."
            },
            {
                "id": 2,
                "start": 7.54,
                "end": 13.040000000000001,
                "text": " 어제 내린 비가 얼어붙은 곳이 있어서 도로 살얼음 유의하셔야겠고요."
            },
            {
                "id": 3,
                "start": 13.780000000000001,
                "end": 15.780000000000001,
                "text": " 낮부터는 기온이 오르면서 비교적 온화하겠습니다."
            },
            {
                "id": 4,
                "start": 17.04,
                "end": 20.48,
                "text": " 현재 제주와 일부 전남과 경남, 동해안을"
            },
            {
                "id": 5,
                "start": 20.82,
                "end": 23.28,
                "text": " 중심으로는 강풍특보가 발효 중이고요."
            },
            {
                "id": 6,
                "start": 23.56,
                "end": 26.060000000000002,
                "text": " 건조주의보까지 이어지는 곳들이 있어서"
            },
            {
                "id": 7,
                "start": 26.36,
                "end": 29.8,
                "text": " 시설물 관리와 각종 화재 사고 발생하지 않도록 주의하셔야겠습니다."
            },
            {
                "id": 8,
                "start": 30.1,
                "end": 34.6,
                "text": " 오늘은 전국 하늘 미세먼지 걱정 없이 대체로 쾌청하게 드러나겠습니다."
            },
            {
                "id": 9,
                "start": 34.86,
                "end": 40.36,
                "text": " 자자한 현재 기온을 살펴보시면 서울 1.3도, 광주 6.3도, 부산 7.1도로"
            },
            {
                "id": 10,
                "start": 42.2,
                "end": 46.7,
                "text": " 출발하고 있고요. 낮이 되면 서울 11도, 전주와 광주, 부산"
            },
            {
                "id": 11,
                "start": 46.980000000000004,
                "end": 49.14,
                "text": " 13도까지 오르는 등 비교적 포근하겠습니다."
            },
            {
                "id": 12,
                "start": 50.44,
                "end": 52.54,
                "text": " 당분간 뚜렷한 비 소식 없겠고요."
            },
            {
                "id": 13,
                "start": 52.84,
                "end": 55.82,
                "text": " 금요일인 내일은 서울 낮 기온 16도까지"
            },
            {
                "id": 14,
                "start": 56.120000000000005,
                "end": 58.480000000000004,
                "text": " 오르는 등 예년보다 온화한 날들이"
            },
            {
                "id": 15,
                "start": 58.48,
                "end": 59.959999999999994,
                "text": " 이어지겠습니다. 날씨였습니다."
            }
        ],
        "language": "ko",
        "duration": 71.088,
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 100,
        "ms": 7929,
        "pl_id": 1595684
    }
}
            
현재 페이지 북마크