언어 코드: ko
한국어 음성 인식 API(STT)
KolWrite는 단 한 번의 REST API 호출로 한국어 음성과 영상을 텍스트로 변환합니다. 파일 URL과 "language": "ko"를 보내면 화자 라벨과 단어별 타임스탬프가 포함된 세그먼트가 JSON, TXT, SRT 중 원하는 형식으로 반환됩니다. Oracle 모델을 쓰면 같은 작업에서 한국어 음성을 영어를 비롯한 100개 지원 언어로 번역할 수도 있습니다.
한국어 음성을 요청 한 번으로 텍스트로 변환
language에 ko를 지정하고 작업을 시작합니다. 결과는 GET /transcribe/{jobId}로 조회하거나, 미리 webhook_url을 전달해 받을 수 있습니다.
curl https://app.kolwrite.com/transcribe \
-H "x-api-key: $KOLWRITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio_url": "https://example.com/meeting-ko.m4a", "model": "oracle", "language": "ko", "include_diarization": true, "output_format": "json"}'
같은 작업에서 한국어 음성을 영어로 번역하려면 다음과 같이 요청합니다(Oracle 모델 전용).
curl https://app.kolwrite.com/transcribe \
-H "x-api-key: $KOLWRITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio_url": "https://example.com/meeting-ko.m4a", "model": "oracle_mini", "language": "ko", "translate_to": "en", "word_timestamps": false, "output_format": "srt"}'
한국어 지원 한눈에 보기
| 항목 | 내용 |
|---|---|
| API 코드 | ko |
| 현지 언어 이름 | 한국어 |
| 표기 방향 | 왼쪽에서 오른쪽 |
| 언어 자동 감지 | 지원. language를 생략하거나 "auto"를 보냅니다 |
| 한국어 음성 번역 대상 | Oracle 모델에서 지원하는 100개 언어 중 선택 |
| 다른 언어를 한국어로 번역 | 지원. Oracle 모델에서 translate_to: "ko"를 지정합니다 |
| 출력 형식 | JSON(세그먼트, 단어별 타임스탬프, 화자), TXT, SRT |
| 요금 | 오디오 1시간당 US$0.48(Base)부터 US$3.60(Oracle Max)까지, Oracle은 US$1.44 |
한국어 음성 인식에서 알아둘 점
- 일상적인 글에서는 띄어쓰기를 엄격하게 지키지 않는 경우가 많습니다. 한국어 음성 인식의 정확도는 보통 글자 오류율(CER)로 측정하는데, 기준 텍스트와 비교할 때는 공백을 모두 제거해야 오류가 실제보다 많이 집계되지 않습니다.
- 한국어 발화에는 영어 단어와 외래어가 자주 섞입니다. 이런 단어는 한글로 적히기도 하고, 브랜드 이름은 한글과 알파벳 어느 쪽으로도 나올 수 있으니 검색이나 비교 전에 두 표기를 모두 다룰 수 있게 처리하세요.
- 존댓말이나 반말 같은 화자의 말투와 어미를 교정하지 않고, 말한 그대로 받아 적습니다.
- SRT 자막 파일은 UTF-8로 열어야 한글이 깨지지 않습니다. 오래된 편집기나 플레이어는 CP949 같은 인코딩을 기본으로 쓰는 경우가 있으니 설정을 확인하세요.
한국어 음성 인식 활용 사례
- 한국어 영상과 예능 콘텐츠의 자막 제작(번역 자막 포함)
- 국내 기업의 고객 상담 통화 기록과 회의록 작성
- 인터뷰와 포커스 그룹 인터뷰(FGI)를
translate_to: "en"으로 번역해 해외 팀과 공유
모델 선택 가이드
한국어 음성을 실서비스에 쓴다면 먼저 oracle(1시간당 US$1.44)로 시작하세요. 잡음이 적고 화자가 한 명인 녹음을 대량으로 처리한다면 base(US$0.48)가 적합합니다. 가장 저렴하게 번역하려면 oracle_mini(US$0.96)를, 잡음이 많거나 알아듣기 어려운 음성에는 oracle_pro 또는 oracle_max를 쓰세요. KolWrite는 이 API의 한국어 인식 정확도를 따로 공개하지 않습니다. 도입을 결정하기 전에 실제 녹음 일부로 직접 테스트해 보세요. 전체 비교는 모델 및 요금(영문 페이지)에서 확인할 수 있습니다.
자주 묻는 질문
한국어 영상으로 번역 자막을 만들 수 있나요?
네. Oracle 모델에 translate_to를 지정하고 output_format: "srt"로 요청하면 됩니다.
전사 결과의 띄어쓰기가 정확도 측정에 영향을 주나요?
한국어는 사람마다 띄어쓰기 기준이 다를 수 있습니다. 정확도를 측정한다면 공백을 제거한 뒤 비교하세요.
한국어 음성 인식 요금은 얼마인가요?
언어와 관계없이 오디오 시간당 요금이 같습니다. Base 모델은 US$0.48부터, Oracle Max는 US$3.60까지입니다.