Skip to main content
POST
Python
이 엔드포인트를 사용하면 OpenAI 호환 오디오 API를 통해 텍스트를 오디오 파일로 변환할 수 있습니다. 내레이션, 짧은 음성 프롬프트, 읽어주기 기능, 그리고 앱에 이미 텍스트가 있고 음성 출력을 필요로 하는 기타 워크플로에 적합합니다.

첫 번째 요청

model, input, voice의 세 필드로 시작하세요. 속도나 출력 형식을 조정하기 전에 인증, 오디오 형식, 파일 처리를 확인할 수 있도록 첫 번째 요청은 짧게 유지하세요.

응답 읽기

응답은 JSON이 아니라 바이너리 오디오입니다. SDK 예제에서는 응답을 output.mp3 같은 파일에 기록하세요. 직접 HTTP 클라이언트를 사용하는 경우 응답 본문을 저장하고, 요청한 response_format에 맞게 파일 확장자를 설정하세요.

다음 단계

  • 음성을 다시 텍스트로 변환해야 할 때는 음성 전사를 사용하세요.
  • 영어가 아닌 오디오에서 영어 텍스트가 필요할 때는 번역를 사용하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

본문

application/json
model
string
기본값:tts-1
필수

The TTS model to use. Choose a current speech model from the Models page.

input
string
필수

The text to generate audio for. Maximum length is 4096 characters.

Maximum string length: 4096
voice
enum<string>
기본값:alloy
필수

The voice to use for speech synthesis.

사용 가능한 옵션:
alloy,
ash,
ballad,
coral,
echo,
fable,
onyx,
nova,
sage,
shimmer
response_format
enum<string>
기본값:mp3

The audio output format.

사용 가능한 옵션:
mp3,
opus,
aac,
flac,
wav,
pcm
speed
number
기본값:1

The speed of the generated audio. Select a value between 0.25 and 4.0.

필수 범위: 0.25 <= x <= 4

응답

200 - audio/mpeg

The audio file content.

The response is of type file.