# 받아쓰기 — /v1/audio/transcriptions

> 소리를 글로. 오디오는 25MB 까지.

> 원문: https://schoolorder.kr/docs/reference/audio-transcriptions

녹음 파일을 글로 바꿔드려요. 수업 녹음이나 회의록을 정리하실 때 쓰세요. 파일을 보내는 문이라 JSON 이 아니라 multipart 로 올리셔야 해요.

> **요금 단위가 모델마다 달라요**
>
> whisper 는 소리 길이(초)로, transcribe 계열은 토큰으로 계산해요. 어느 쪽이든 부른 만큼만 차감되고, 저희가 지어내는 값은 없어요 — 벤더가 준 양을 그대로 씁니다.

**소리를 글로**

```bash
curl https://schoolorder.kr/v1/audio/transcriptions \
  -H "Authorization: Bearer $SCHOOLORDER_API_KEY" \
  -F model=whisper-1 \
  -F file=@./lesson.m4a
```

> **⚠️ 오디오는 25MB 까지예요**
>
> 벤더 상한과 같아요. 넘으면 저희가 먼저 413 으로 알려드려요 — 벤더 메시지보다 우리 문장이 낫거든요. 긴 녹음은 나눠서 보내주세요.

## 요청 파라미터

**요청 — multipart/form-data (JSON 아니에요)**

| 파라미터 | 받는 값 | 저희가 하는 일 |
| --- | --- | --- |
| `file` (필수) | 오디오 파일 | 25MB 까지예요. 넘으면 저희가 먼저 413 으로 알려드려요 — 벤더 메시지보다 우리 문장이 낫거든요. |
| `model` (필수) | 받아쓰기 모델 id | 다른 종류를 넣으시면 400 으로 어느 문인지 알려드려요. |
| `language · prompt · response_format` | 벤더 문서에 있는 값 | 저희가 거르지 않고 그대로 넘겨요 — 벤더 문서를 그대로 보고 쓰시면 돼요. |

## 이 문이 받는 모델

#### 받아쓰기 — `POST /v1/audio/transcriptions`

| model | 요금 |
| --- | --- |
| gpt-4o-transcribe | 소리 입력 $2.5 / 1M 토큰 · 출력 $10 / 1M 토큰 |
| gpt-4o-mini-transcribe | 소리 입력 $1.25 / 1M 토큰 · 출력 $5 / 1M 토큰 |
| whisper-1 | 길이 $0.0001 / 초 |