메인 콘텐츠로 건너뛰기
POST
/
v1
/
audio
/
speech
curl --request POST \
  --url https://api.apimart.ai/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-mini-tts",
    "input": "오늘 날씨가 정말 좋네요. 산책하기 딱 좋은 날입니다.",
    "voice": "alloy",
    "response_format": "opus",
    "speed": 1.0
  }' \
  --output speech.opus

바이너리 오디오 데이터 스트림

curl --request POST \
  --url https://api.apimart.ai/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-mini-tts",
    "input": "오늘 날씨가 정말 좋네요. 산책하기 딱 좋은 날입니다.",
    "voice": "alloy",
    "response_format": "opus",
    "speed": 1.0
  }' \
  --output speech.opus

바이너리 오디오 데이터 스트림

​
Authorizations

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

​
Body

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

​
Response

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