음성 합성

텍스트, 음성 및 출력 형식 등의 매개변수를 제출하면 응답 본문은 바이너리 오디오입니다. 클라이언트는 요청한 출력 형식에 맞춰 결과를 저장하거나 처리해야 합니다.

POST/v1/audio/speech

입력 텍스트를 음성으로 변환하고 결과를 바이너리 오디오로 반환합니다.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

텍스트 음성 변환 요청 매개변수입니다.

TypeScript 타입 정의

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

model*string

사용할 텍스트 음성 변환 모델 ID입니다. 예를 들어 tts-1, tts-1-hd입니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

input*string

음성으로 변환할 텍스트이며 최대 길이는 4096자입니다.

길이1 <= length <= 4096

voice*string

음성 생성에 사용하는 목소리입니다.

허용 값

"alloy"
"ash"
"ballad"
"coral"
"echo"
"fable"
"nova"
"onyx"
"sage"
"shimmer"
"verse"
"marin"
"cedar"

instructions?string

생성 음성의 어조, 표현 방식 또는 기타 말하기 요구 사항을 제어합니다.

길이length <= 4096

response_format?string

오디오 출력 형식입니다.

기본값"mp3"

허용 값

"mp3"
"opus"
"aac"
"flac"
"wav"
"pcm"

speed?number

생성 음성의 속도이며 범위는 0.25~4.0입니다.

범위0.25 <= value <= 4

기본값1

stream_format?string

스트리밍 응답 형식입니다. audio는 바이너리 오디오 스트림을 반환하고 sse는 의미 단위 오디오 이벤트를 반환합니다.

기본값"audio"

허용 값

"audio"
"sse"

응답 본문

`application/json`

curl -X POST "https://example.com/v1/audio/speech" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "input": "안녕하세요, 세상!",
    "voice": "alloy"
  }' \
  --output speech.mp3

응답 본문은 JSON이 아닙니다. 요청한 출력 형식에 맞춰 바이너리 데이터를 오디오 파일로 저장하세요.

<binary audio data>

인증

요청 본문

응답 본문

200application/octet-stream

400application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`