# 한국어 음성 인식 API(STT)

> KolWrite는 단 한 번의 REST API 호출로 한국어 음성과 영상을 텍스트로 변환합니다. 파일 URL과 "language": "ko"를 보내면 화자 라벨과 단어별 타임스탬프가 포함된 세그먼트가 JSON, TXT, SRT 중 원하는 형식으로 반환됩니다. Oracle 모델을 쓰면 같은 작업에서 한국어 음성을 영어를 비롯한 100개 지원 언어로 번역할 수도 있습니다.

최종 업데이트: 2026-11-21 · HTML: https://console.kolwrite.com/ko/speech-to-text/korean

## 한국어 음성을 요청 한 번으로 텍스트로 변환

`language`에 `ko`를 지정하고 작업을 시작합니다. 결과는 `GET /transcribe/{jobId}`로 조회하거나, 미리 `webhook_url`을 전달해 받을 수 있습니다.

```bash
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 모델 전용).

```bash
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의 한국어 인식 정확도를 따로 공개하지 않습니다. 도입을 결정하기 전에 실제 녹음 일부로 직접 테스트해 보세요. 전체 비교는 [모델 및 요금](https://console.kolwrite.com/models)(영문 페이지)에서 확인할 수 있습니다.

## 자주 묻는 질문

### 한국어 영상으로 번역 자막을 만들 수 있나요?

네. Oracle 모델에 `translate_to`를 지정하고 `output_format: "srt"`로 요청하면 됩니다.

### 전사 결과의 띄어쓰기가 정확도 측정에 영향을 주나요?

한국어는 사람마다 띄어쓰기 기준이 다를 수 있습니다. 정확도를 측정한다면 공백을 제거한 뒤 비교하세요.

### 한국어 음성 인식 요금은 얼마인가요?

언어와 관계없이 오디오 시간당 요금이 같습니다. Base 모델은 US$0.48부터, Oracle Max는 US$3.60까지입니다.

## 관련 페이지

- [일본어 음성 인식 API](https://console.kolwrite.com/ja/speech-to-text/japanese)
- [미디어·팟캐스트·자막 활용 사례(영문 페이지)](https://console.kolwrite.com/use-cases/media)
- [콜센터·영업 통화 활용 사례(영문 페이지)](https://console.kolwrite.com/use-cases/call-centers)
- [지원 언어 전체 목록(영문 페이지)](https://console.kolwrite.com/languages/)

---
API 키 받기: https://console.kolwrite.com/auth · API 문서: https://console.kolwrite.com/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
