Skip to main content
POST

Authorizations

string
필수
모든 API는 Bearer Token 인증이 필요합니다API Key 얻기:API Key 관리 페이지를 방문하여 API Key를 받으세요요청 헤더에 추가:

Body

string
기본값:"gpt-4o-mini-tts"
필수
TTS 모델 이름사용 가능한 모델:
  • gpt-4o-mini-tts - GPT-4o Mini TTS 모델
예: "gpt-4o-mini-tts"
string
필수
음성으로 변환할 텍스트 콘텐츠최대 길이: 4096자예: "오늘 날씨가 정말 좋네요. 산책하기 딱 좋은 날입니다."
string
필수
음성 선택사용 가능한 음성:
  • alloy - 중립적이고 균형 잡힌 음성
  • echo - 남성, 차분한 음성
  • fable - 영국식, 서술적인 음성
  • onyx - 남성, 깊은 음성
  • nova - 여성, 활기찬 음성
  • shimmer - 여성, 부드러운 음성
예: "alloy"
string
기본값:"wav"
필수
오디오 출력 형식지원되는 형식:
  • wav - WAV 형식, 비압축 (기본값)
  • opus - Opus 형식, 인터넷 스트리밍용
  • aac - AAC 형식
  • flac - FLAC 형식, 무손실 압축
  • pcm - PCM 형식, 원시 오디오 데이터
예: "wav"
number
기본값:"1.0"
음성 재생 속도범위: 0.25 ~ 4.0
  • 0.25 - 가장 느린 속도 (1/4배속)
  • 1.0 - 정상 속도 (기본값)
  • 4.0 - 가장 빠른 속도 (4배속)
예: 1.0

Response

성공 시 바이너리 오디오 데이터 스트림을 반환하며, 오디오 파일로 직접 저장하거나 재생할 수 있습니다. 오류 시 오류 코드, 메시지 및 유형을 포함하는 JSON 형식의 오류 정보를 반환합니다.