소개
TTS-1 HD는 제공한 원고를 읽어 녹음하는 Speech API 모델입니다. 오디오 품질에 초점을 둔 제품으로, 공개 전에 청취 검토를 거치는 설명이나 학습 자료에 맞습니다. 실시간 마이크 입력 대신 작성한 대본이 발화 내용을 정합니다. 안내된 종료일은 2027년 1월 6일입니다.
핵심 기능 및 하이라이트
HD 모델은 alloy, ash, coral, echo, fable, onyx, nova, sage, shimmer의 기본 음성 9종을 제공합니다. 음성을 고르는 기능이며 특정 인물의 맞춤 목소리를 만드는 기능은 아닙니다. 영어 이외의 원고라면 실제 구절로 이름의 발음과 호흡을 검토하는 것이 좋습니다.
TTS-1 HD 녹음은 MP3, Opus, AAC, FLAC, WAV, PCM으로 받을 수 있습니다. 작은 배포 파일과 후반 편집용 비압축 파일 중 작업에 맞는 것을 선택하세요. 속도를 바꿔도 원고의 과금 문자 수는 그대로여서 대본 분량으로 제작량을 관리할 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
text | 예 | TTS-1 HD가 읽을 최종 원고입니다. 요청당 최대 4,096자를 보낼 수 있습니다. 1자 이상 · 4096자 이하 |
voice_id | 아니요 | HD의 기본 화자를 선택하고 표본 구절로 이름과 강세를 청취 검토합니다. |
speed | 아니요 | TTS-1 HD 속도는 0.25~4입니다. 원고의 과금 문자 수에는 영향을 주지 않습니다. |
output_format | 아니요 | HD 편집 및 배포 과정에 맞는 형식입니다. PCM은 24 kHz, 16비트 리틀 엔디언 설정으로 재생합니다. |
요금
$0.006 / 1,000자
활용 사례
교육 콘텐츠에서는 TTS-1 HD로 장 도입부와 설명을 제작한 뒤 담당자가 들어 보고 게시할 수 있습니다. 승인한 원고를 녹음과 함께 보관하면 수정 검토도 수월합니다.
제품 설명서의 오디오판은 TTS-1 HD로 절마다 생성한 후 편집 과정에서 합칠 수 있습니다. 절 단위로 재생 위치를 제공하고 개정된 문단만 교체하기도 쉽습니다.
프롬프트 가이드 및 실전 팁
HD 대본은 완성된 편집 원고로 준비하고 문장 부호로 의도한 구절을 나눕니다. 기호, 낯선 이름과 긴 숫자열은 합성 전에 읽는 방식을 정하세요. 선택한 음성과 속도로 대표 구절을 들어 봅니다. 텍스트가 맞는다는 이유만으로 모든 용어가 의도대로 발음된다고 볼 수는 없습니다. 별도의 스타일 지시는 이 구형 Speech 모델의 발성 조절 기능이 아닙니다.
TTS-1 HD에는 요청당 최대 4,096자를 전달합니다. 긴 장은 문장이나 절 경계로 나눠 오디오 편집기에서 조합하세요. 느린 비압축 형식은 파일이 32 MiB를 넘지 않도록 분량을 조절합니다. 원고와 절 순서를 승인 음성과 함께 남기고 청취자에게 합성 내레이션임을 알리세요. 이 자료는 종료 전 이전 작업에도 사용할 수 있습니다.
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-hd/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 레퍼런스에서 확인하세요.

