음성 전사

오디오 파일을 업로드하고 전사 매개변수를 설정하면 API가 입력 언어의 텍스트를 반환합니다. JSON 응답에는 전사 텍스트만 포함될 수도 있고 언어, 길이 및 구간 정보도 포함될 수 있습니다.

POST/v1/audio/transcriptions

오디오 파일을 업로드하고 내용을 입력 언어의 텍스트로 전사합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

multipart/form-data

Multipart로 오디오 파일과 전사 매개변수를 제출합니다. 클라이언트 요청 라이브러리가 Content-Type의 boundary를 자동 생성하도록 해야 합니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

file*file

전사할 오디오 파일입니다. flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav 및 webm 형식을 지원합니다.

형식binary

model*string

사용할 전사 모델 ID입니다. 예를 들어 whisper-1입니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

language?string

입력 오디오의 언어 코드이며 ISO-639-1 형식을 사용합니다. 예를 들어 en입니다. 언어를 제공하면 전사 정확도를 높일 수 있습니다.

패턴^[A-Za-z]{2}$

prompt?string

모델의 스타일을 안내하거나 이전 오디오에 이어서 처리하기 위한 텍스트입니다.

response_format?string

전사 결과 출력 형식입니다.

기본값"json"

허용 값

"json"
"text"
"srt"
"verbose_json"
"vtt"

temperature?number

샘플링 온도입니다. 값이 높을수록 출력의 무작위성이 커집니다.

범위0 <= value <= 1

기본값0

timestamp_granularities?array<>

전사 타임스탬프의 세분화 수준입니다.

기본값

[
  "segment"
]

응답 본문

`application/json`

curl -X POST "https://example.com/v1/audio/transcriptions" \
  -F file="audio.mp3" \
  -F model="MODEL_ID"

{
  "text": "안녕하세요, 세상!"
}

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`