소개
앱 안내, 내레이션 초안, 현지화 보이스오버를 위해 최대 10,000자를 elevenlabs/v4-turbo/text-to-speech로 보냅니다. 언어, 정규화 모드, 출력 형식을 선택하고 게시 전에 완성된 오디오를 검토합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 오디오 |
| 음성 API 식별자 | elevenlabs/v4-turbo/text-to-speech |
| 텍스트 상한 | 요청당 10,000자 |
| 음성 배역 | 기본 제공 음성 21개; 기본값 Roger |
| 형식 설정 | 9개 선택지; 기본값 |
| 기록된 테스트 조건 | 2026년 11월 13일: 75자, Sarah, |
핵심 기능 및 하이라이트
조건을 함께 제시한 짧은 Sarah 녹음
2026년 11월 13일 자체 75자 Turbo 요청은 약 7.6초 후 3.40초의 MP3를 반환했습니다. Sarah와 mp3_44100_128을 사용한 호출로, 다른 대본이나 작업량을 예측하지 않는 구체적인 통합 참고 사례입니다.
21개 음성으로 안내 문구 배역을 구성합니다
기본 제공 음성 21개 중 Roger가 기본값이며 Sarah, Daniel, Lily 등도 있습니다. 선택 음성에 자동 언어 감지나 언어 코드 91개 중 하나를 조합하고 각 현지화 안내의 실제 문구를 들어 봅니다.
읽을 문구 바로 옆에 발화 지시를 둡니다
[laughs]나 [whispers] 같은 대괄호 태그는 text 안에 넣습니다. 자체 테스트는 태그 1개를 사용했으므로 많은 지시가 검증됐다고 가정하지 말고 반환된 연기를 직접 판단합니다.
출력 선택지 9개 중 고릅니다
기본 출력은 mp3_44100_128이며 mp3_22050_32도 선택할 수 있습니다. 플레이어가 지원하는 목록 내 형식을 고른 뒤 대본 수정본을 비교하는 동안 같은 설정을 유지합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
text | 예 | 필수 낭독 대본을 최대 10,000자로 제공합니다. 해당 문구에 [whispers] 같은 인라인 지시를 넣고 큰 묶음을 생성하기 전에 교정합니다. 1자 이상 · 10000자 이하 |
voice_id | 아니요 | 기본 제공 음성 21개 중 하나를 고르며 생략하면 Roger를 사용합니다. 사용자 지정 음성 ID 대신 같은 짧은 대사로 Sarah, Daniel, Lily를 비교합니다. |
language | 아니요 | auto 또는 지원 언어 코드 91개 중 하나를 고릅니다. 짧은 현지화 안내는 목적 언어를 지정하고 이미 그 언어로 작성된 text를 제공합니다. |
stability | 아니요 | stability로 발화의 일관성을 조정한 뒤 짧은 샘플을 들어 봅니다. 설정을 비교하는 동안 대본과 음성을 유지합니다. |
similarity_boost | 아니요 | 선택 음성을 연기가 어떻게 따르는지 평가할 때 similarity_boost를 조정합니다. 같은 단어로 비교하고 여러 음성 제어를 한꺼번에 바꾸지 않습니다. |
output_format | 아니요 | 9개 선택지에서 고르며 기본값은 mp3_44100_128이고 다른 MP3 선택지로 mp3_22050_32가 있습니다. 재생 환경이 선택 형식을 지원하는지 확인합니다. |
text_normalization_mode | 아니요 | auto, on, off로 숫자와 약어 정규화를 제어합니다. 표기대로 정확히 발음될 것이라 가정하지 말고 게시할 실제 날짜, 제품명, 코드를 시험합니다. |
clone_strength | 아니요 | 기본 제공 음성에는 효과가 없으므로 음성 비교에서 clone_strength를 생략합니다. 이 엔드포인트는 사용자 지정 음성이나 복제 음성 선택을 제공하지 않습니다. |
seed | 아니요 | 대본이나 설정 하나씩을 비교하려면 seed를 고정합니다. 동일한 오디오를 기대하기보다 새 연기로 받아들이고 평가합니다. |
요금
$0.048 / 1,000자
공백, 문장부호, 인라인 태그를 포함한 text 문자 수로 과금합니다. 음성·언어·출력 형식을 바꿔도 문자당 요율은 같으며 실패한 요청에는 과금하지 않습니다. 이 페이지에 표시된 가격을 확인합니다.
활용 사례
앱 상태 메시지
Sarah와 함께 ‘업로드가 준비됐습니다. 미리보기를 열어 계속하세요.’를 입력해 앱용 음성 상태 안내를 만듭니다. 음성을 재사용하기 전에 실제 화면 흐름에서 들어 봅니다.
제품 시연용 초안
‘작업 공간을 고르고 파일을 추가한 다음 미리보기를 여세요.’를 보내 내레이션 초안을 생성합니다. 최종 녹음을 준비하기 전에 반환 오디오를 시연 타이밍에 맞춰 비교합니다.
강의 학습 지시
‘강의를 잠시 멈추고 본인 프로젝트의 예시 세 가지를 적어 보세요.’를 짧은 강의 대본으로 사용합니다. 결과는 연습 문제와 함께 검토할 수 있는 단일 음성 녹음입니다.
현지화된 출시 안내
language es와 ‘파일이 준비됐습니다.’라는 뜻의 스페인어 문구를 제공해 스페인어 앱 안내 음성을 만듭니다. 각 번역 대본은 직접 준비하고 별도 녹음으로 생성합니다.
게임 캐릭터 대사
‘[whispers] 문이 열렸어요. 등불을 따라오세요.’로 지시가 담긴 NPC 대사를 시도합니다. 단일 음성 연기를 받은 뒤 지시 표현과 안내의 명료성을 확인합니다.
프롬프트 가이드 및 실전 팁
Turbo 대사 하나를 만듭니다
교정한 짧은 대본을 text에 넣고 기본 제공 음성 하나를 고릅니다.
모델과 입력을 제출합니다
createTask 요청의 model에는 elevenlabs/v4-turbo/text-to-speech를 지정하고 음성 관련 필드는 input 안에 넣습니다.
완료된 자산을 청취합니다
반환된 taskId로 recordInfo를 폴링하고 성공 후 오디오 자산을 내려받아 플레이어에서 발음을 확인합니다.
짧은 음성 대본을 위한 ElevenLabs v4 Turbo API
ElevenLabs v4 Turbo API는 ElevenLabs의 Eleven v4 Turbo 음성 모델로 텍스트를 기본 제공 음성 하나의 녹음으로 만듭니다. 요청당 최대 10,000자를 사용해 앱 알림, 내레이션 초안, 다국어 보이스오버를 제작합니다.
ElevenLabs는 출시 발표에서 Turbo가 대화형 애플리케이션을 지향한다고 설명합니다. 여기의 엔드포인트는 작업을 제출하고 완성 오디오 자산을 받는 방식이며, 아래 실측 작업 시간은 스트리밍 지연 시간에 대한 주장이 아닙니다.
음성 요청 제출
model을 elevenlabs/v4-turbo/text-to-speech로 지정하고 input 안에 음성 필드를 넣어 작업을 만듭니다. Authorization: Bearer YOUR_SPICY_API_KEY 및 Content-Type: application/json과 함께 POST https://api.spicyapi.ai/api/v1/jobs/createTask를 보냅니다.
{
"model": "elevenlabs/v4-turbo/text-to-speech",
"input": {
"text": "[whispers] Your preview is ready. Open it when you have a moment.",
"voice_id": "Sarah",
"language": "en",
"output_format": "mp3_44100_128"
}
}
이 요청은 필드 배치 예제이며 자체 실측 대본을 재현하지 않습니다. voice_id를 생략하면 Roger가 기본 음성이 되며 사용자 지정 음성 ID는 받지 않습니다.
응답 받기
제출 시 받은 작업 ID로 GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID를 폴링합니다. 같은 작업을 확인할 수 있도록 ID를 보관합니다.
제출 응답을 축약하면 다음과 같습니다.
{
"code": 200,
"data": {
"taskId": "YOUR_TASK_ID",
"state": "queued"
}
}
성공한 작업의 축약 응답에는 오디오 자산이 제공됩니다.
{
"code": 200,
"data": {
"taskId": "YOUR_TASK_ID",
"state": "succeeded",
"output": {
"assets": [
{"url": "https://example.com/turbo-result.mp3", "mime": "audio/mpeg"}
]
}
}
}
발췌문에는 예시 ID와 URL이 들어 있습니다. 성공 후 data.output.assets에서 내려받고 사용할 플레이어에서 들어 봅니다.
매개변수와 엔드포인트 범위
입력 설정에는 텍스트, 기본 제공 음성, 언어, 발화, 정규화, 출력 형식, seed가 있습니다. 다른 음성 API의 필드를 가져오지 말고 각 설정의 목록에 있는 선택지를 사용합니다.
| 매개변수 | 지원 입력 또는 용도 | 선택 시 참고 사항 |
|---|---|---|
text | 필수; 최대 10,000자 | 문구와 인라인 지시를 교정합니다 |
voice_id | 기본 제공 음성 21개; 기본값 Roger | Sarah, Daniel, Lily로 짧은 대사를 시험합니다 |
language | auto 또는 언어 코드 91개 중 하나 | 준비된 대본의 언어와 맞춥니다 |
stability | 발화 일관성 제어 | 음성을 고정한 채 변경 효과를 비교합니다 |
similarity_boost | 선택 음성과의 유사성 제어 | 조정 후 같은 구절을 청취합니다 |
clone_strength | 기본 제공 음성에 영향 없음 | 이 음성 목록을 쓸 때 생략합니다 |
text_normalization_mode | auto, on 또는 off | 숫자와 약어 낭독을 점검합니다 |
output_format | 9가지; 기본값 mp3_44100_128 | mp3_22050_32도 MP3 선택지입니다 |
seed | 변수를 통제한 비교 지원 | 녹음이 같을 것으로 기대하지 않습니다 |
문자 기준 과금
이 음성 엔드포인트는 생성 오디오의 초 수가 아닌 텍스트 문자 수로 과금합니다. 대본 묶음의 사용료는 이 페이지의 현재 표시 가격으로 추정하며, 반환 MP3의 길이로 요금을 유추하지 않습니다.
대량 생성 전 발화 개선
짧은 시험 대본으로 더 큰 모음을 녹음하기 전에 발음과 연기를 들어 볼 수 있습니다. 앱 알림은 ‘업로드가 준비됐습니다. 미리보기를 열어 계속하세요.’를 시도해 두 문장 사이의 전환을 확인합니다.
- 음성 하나와 태그 없는 대본으로 시작해 기준 녹음을 만듭니다.
- 발화가 바뀔 곳에
[whispers]나[laughs]같은 지시를 추가하고 다시 듣습니다. - 프로젝트에 실제로 쓰이는 숫자와 약어로 정규화 설정을 비교합니다.
- 대본이나 발화 설정의 요소 하나를 바꿀 때 음성, 형식, seed를 고정합니다.
고정 seed는 동일 출력을 약속하지 않으면서 비교를 돕습니다. 언어 코드를 선택하기 전에 번역 문구를 준비해야 하며 언어 선택은 번역 단계가 아닙니다.
자체 호출 측정 내용
2026년 11월 13일 자체 Turbo 호출은 Sarah와 75자로 약 7.6초에 3.40초 MP3를 반환했습니다. 인라인 태그 1개를 사용했으며 더 넓은 태그 어휘는 검증하지 않았습니다.
| 호출 | 텍스트 문자 수 | 음성 | 출력 형식 | 오디오 길이 | 완료까지의 시간 |
|---|---|---|---|---|---|
| v4 Turbo | 75 | Sarah | mp3_44100_128 | 3.40초 | 약 7.6초 |
| v4 | 84 | Daniel | mp3_22050_32 | 5.17초 | 약 4.7초 |
대본, 음성, 출력 형식이 다르므로 이 호출은 통제된 비교가 아닌 통합 과정의 관측입니다. v4 호출에는 영어와 seed 7도 지정했습니다. 어느 결과도 다음 대본의 성능을 예측하지 않습니다.
제한, 오류, 모델 선택
거절된 요청을 확인할 때는 text를 10,000자 이내로 유지하고 목록에 있는 기본 제공 음성을 사용합니다. 다중 화자 대화 입력과 사용자 지정 음성 ID는 아직 없으며 clone_strength로 기본 제공 음성을 바꿀 수 없습니다.
호출이 실패하면 요청을 수정해 재시도하기 전에 반환 오류와 제출 필드를 확인합니다. 오디오는 완료됐지만 숫자 낭독이 잘못됐다면 짧은 발췌문으로 정규화 설정과 명확히 풀어 쓴 문구를 시험합니다.
초안, 대량 안내 음성 라이브러리, 지연 시간을 우선하는 흐름에는 Turbo를 선택합니다. 최종 내레이션은 같은 대본과 설정으로 ElevenLabs v4와 비교합니다. 사용자 지정 음성이나 대화 입력이 필요하면 해당 기능의 문서상 지원을 확인한 뒤 다른 음성 엔드포인트를 고려합니다. Turbo 연기를 게시하기 전에 텍스트와 음성의 사용 권리를 확인하고 실제 인물의 사칭을 피합니다.
필요한 권리를 가진 대본을 게시하고 음성을 사용합니다. 생성된 연기를 실제 인물의 사칭에 이용하지 않습니다.
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": "elevenlabs/v4-turbo/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"language": "auto",
"voice_id": "Roger",
"output_format": "mp3_44100_128",
"text_normalization_mode": "auto"
}
}'
# 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 레퍼런스에서 확인하세요.




