소개
TTS-1은 준비된 문장을 음성 파일로 바꾸는 Speech API 모델입니다. 작업 완료 알림이나 앱 조작 안내처럼 짧은 메시지를 빠르게 만드는 용도에 맞습니다. 사용자의 말을 듣거나 답변 내용을 작성하는 기능은 포함하지 않습니다. 제공사가 공지한 서비스 종료일은 2027년 1월 6일입니다.
핵심 기능 및 하이라이트
TTS-1에서 고를 수 있는 기본 음성은 alloy, ash, coral, echo, fable, onyx, nova, sage, shimmer입니다. 영어를 중심으로 최적화되어 있으므로 다른 언어나 중요한 이름은 실제 녹음을 들어 확인하세요. 연결된 안내에는 같은 음성을 유지하는 편이 자연스럽습니다.
TTS-1은 MP3, Opus, AAC, FLAC, WAV, 원시 PCM을 지원합니다. 모바일 알림에는 압축 파일을, 자체 재생 파이프라인에는 필요한 비압축 형식을 선택할 수 있습니다. 속도 범위는 0.25~4이며 속도를 조정해도 제출한 문장의 과금 문자 수는 바뀌지 않습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
text | 예 | TTS-1이 그대로 읽을 문장입니다. 공백과 문장 부호를 포함해 최대 4,096자입니다. 1자 이상 · 4096자 이하 |
voice_id | 아니요 | TTS-1 기본 음성 9종 중 선택하며 기본값은 alloy입니다. |
speed | 아니요 | TTS-1 말하기 속도를 0.25~4로 지정합니다. 일반 속도는 1입니다. |
output_format | 아니요 | TTS-1 파일 인코딩입니다. PCM은 WAV 헤더 없는 24 kHz, 16비트 리틀 엔디언 샘플입니다. |
요금
$0.003 / 1,000자
활용 사례
업무 대시보드에서는 앱이 확정한 작업 결과를 TTS-1의 짧은 음성으로 알려 줄 수 있습니다. 상태와 정확한 안내 문구를 먼저 정해 두어야 합니다.
기기 설정 안내를 TTS-1으로 단계별 제작하면 현재 단계만 재생할 수 있습니다. 설명 하나가 바뀌었을 때도 전체 음성을 다시 만들 필요 없이 해당 파일을 교체할 수 있습니다.
프롬프트 가이드 및 실전 팁
TTS-1 입력에는 청취자가 실제로 들어야 할 문장을 적습니다. 약어, 날짜, 코드와 소수는 문맥을 포함해 시험하고 필요하면 읽는 방식대로 풀어 씁니다. 차분하게 말하라는 문구도 읽을 본문으로 취급되므로 전달 방식 지시로 사용하지 마세요.
TTS-1 요청은 4,096자 이내, 생성 파일은 32 MiB 이내로 구성합니다. 긴 원고를 느린 WAV나 PCM으로 만들 때는 나누어 요청하세요. 사용자 화면에 넣기 전 녹음을 검토하고 합성 음성임을 표시합니다. 모델 종료 전에 옮길 수 있도록 원문과 재생 설정도 보관하세요.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/tts-1/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "alloy",
"output_format": "mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.

