ElevenLabs: Eleven Turbo v2
Eleven Turbo v2는 빠른 음성 응답이 필요한 애플리케이션을 위한 ElevenLabs의 영어 전용 텍스트 음성 변환 버전입니다. 입력한 문장을 선택한 목소리로 읽어 주며, 듣기 좋게 작성한 어시스턴트 응답, 알림, 짧은 설명에 적합합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Eleven Turbo v2는 신속한 음성 응답이 필요한 애플리케이션을 위한 ElevenLabs의 영어 전용 텍스트 음성 변환 모델입니다. 미리 작성한 발화 문장을 받아 선택한 목소리의 오디오를 반환합니다. 제조사는 Turbo v2를 다국어 Turbo v2.5 및 Flash 계열과 구분합니다. 확인 메시지, 짧은 설명, 대화형 인터페이스의 다음 안내처럼 영어 음성으로 응답하는 데 유용합니다.
이 버전의 언어 범위를 규정하는 핵심은 영어입니다. 다른 언어를 입력한다고 Turbo v2에 v2.5의 다국어 특성이 생기는 것은 아닙니다. 영어 대본에 필요한 억양과 표현 방식에 맞는 목소리를 선택하세요. 따뜻한 대화체 목소리, 절제된 내레이터, 활기찬 캐릭터는 같은 문장도 다르게 들리게 합니다. 따라서 목소리 선택은 모델 이름이 정해 주는 고정 기본값이 아니라 제작 요구사항의 일부입니다.
깔끔한 낭독 대본을 준비하세요. 모델은 입력된 단어를 음성으로 합성하며, 작업이 성공했는지 판단하거나 애플리케이션의 추론을 생성하지 않습니다. 어시스턴트 응답에는 명확한 결과 하나와 자연스러운 다음 단계를 넣으세요. 예를 들어 문서를 받았다고 확인한 뒤 누락된 참조 번호를 요청할 수 있습니다. 일반적인 설명 문구도 그대로 낭독될 수 있으므로 내부 지시와 메타데이터는 청취자에게 들려줄 문장 밖에 두세요.
이름, 약어, 숫자는 의도에 맞게 준비해야 합니다. 식별자를 한 자리씩 읽어야 한다면 숫자를 분리해서 쓰고, 청취자가 약어의 전체 의미를 들어야 한다면 풀어 쓰세요. 날짜는 뜻이 분명한 발화 형태로 표현하세요. 발음 별칭이나 대체 표기를 이용하면 어려운 이름을 원하는 방식으로 읽게 할 수 있습니다. 애플리케이션이 메시지를 텍스트로도 보여 준다면 원래의 화면 표기를 발화용 표기와 별도로 보관하세요.
제조사의 음성 설정은 일관성, 유사도, 속도에 영향을 줍니다. 공통 TTS 제품 안내에서 속도 설정은 1.0이 원래 속도이며 범위는 0.7~1.2입니다. 극단적인 조정은 결과에 영향을 줄 수 있습니다. Stability는 변동성과 감정 표현 범위를, similarity는 선택한 목소리와의 유사성을 조절합니다. 이러한 제어가 합성을 결정적으로 만들거나 한 문장의 정확한 길이를 보장하지는 않습니다. 단어가 전달되는 방식에는 문장부호와 완결된 문장 구조도 중요합니다.
제조사가 명시한 Turbo v2 API의 정확한 한도는 요청당 30,000자입니다. 이는 입력 상한이며 고정된 오디오 길이가 아닙니다. 긴 텍스트를 준비할 때는 완결된 문장이나 구간을 사용하세요. ElevenLabs의 TTS 형식 계열에는 일반 청취용 MP3, 비압축 16비트 PCM, μ-law와 A-law 같은 전화용 인코딩, Opus가 포함됩니다. 스트리밍 워크플로는 오디오를 점진적으로 반환할 수 있고, 완성된 텍스트 요청의 결과를 하나의 녹음으로 모을 수도 있습니다. 재생할 환경에 맞춰 출력을 선택하고 실제 대본을 선택한 오디오와 함께 보관하세요. 긴 설명은 청취자가 하나의 긴 목록을 따라가게 하기보다 의미 있는 경계에서 나누세요.
실용적인 영어 고객 지원 응답을 만들려면 정확한 결과, 알아듣기 쉽게 읽을 이름이나 식별자, 다음 행동을 준비하세요. 녹음의 해당 부분을 들어 명료도, 억양, 자연스러운 리듬을 확인하세요. 제조사는 출력이 비결정적이라고 설명하므로 같은 설정으로도 표현이 조금 달라질 수 있습니다. 재사용할 결과물은 선택한 음성 녹음과 그에 맞게 준비한 문구 및 음성 설정이며, 어시스턴트, 알림, 튜토리얼 안내, 짧은 녹음 설명에 활용할 수 있습니다.
Ailoot Ultra · 음성 합성 POST /v1/audio/speech elevenlabs/eleven-turbo-v2
elevenlabs/eleven-turbo-v2시작하기
Eleven Turbo v2는 빠른 음성 응답이 필요한 애플리케이션을 위한 ElevenLabs의 영어 전용 텍스트 음성 변환 버전입니다. 입력한 문장을 선택한 목소리로 읽어 주며, 듣기 좋게 작성한 어시스턴트 응답, 알림, 짧은 설명에 적합합니다.
- 허용 입력
- 텍스트
- 결과
- 오디오
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 음성 합성 POST /v1/audio/speech
- 입력
text- 출력
audio- 출력 형식
- mp3
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 elevenlabs/eleven-turbo-v2 | 기본값— |
필드input | 유형string | 요건필수 | 값과 한도 최소 길이: 1 최대 길이: 30,000 단위: Unicode 문자 | 기본값— |
필드voice | 유형string | 요건필수 | 값과 한도 george, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will | 기본값— |
필드response_format | 유형string | 요건필수 | 값과 한도 mp3 | 기본값— |
입력 자료 조합
text_to_speech · 필수: input
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, input, voice, response_format |
매개변수voice_ids | 명세george, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will |
매개변수response_format | 명세mp3 |
매개변수max_input_characters | 명세30000 |
매개변수other_options | 명세false |
매개변수input | 명세정확한 UTF-8 텍스트; 정규화 없이 계산한 유니코드 문자 수 |
매개변수material_types | 명세text |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 실제로 반환된 task_id 또는 미디어 라이브러리 기록
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
이 모델 프로필에 있는 정확한 음성을 선택하세요.
입력 문자 수와 오디오 초는 서로 다른 측정 단위입니다.
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 단위 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 단위— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정입력 문자 | 요금표— | 과금 단위입력 문자당 | 요금 입력 · 입력 문자 $0.00008 입력 문자당 |
참조 요금 상세 정보
모델 수준의 참조 요금표는 메서드 선택, 견적 또는 요금을 변경하지 않습니다. 실제 과금에는 선택한 Ailoot 메서드 요금이 적용됩니다.
ElevenLabs: Eleven Turbo v2
설정별 가격
| 설정 | 과금 조건 | 요금 |
|---|---|---|
| 설정ElevenLabs: Eleven Turbo v2 · 기본 설정 | 과금 조건기본 설정 | 요금 입력 · 입력 문자 수 US$0.00004 입력 문자당 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 음성 합성
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VOICE_ID:?Choose an accepted voice ID from this exact model profile}"
export AILOOT_VOICE_ID
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "elevenlabs/eleven-turbo-v2", "input": "Good afternoon! This is a short voice take."}')
voice=os.environ["AILOOT_VOICE_ID"]
allowed=json.loads('["george", "sarah", "adam", "alice", "bella", "bill", "brian", "callum", "charlie", "chris", "daniel", "eric", "harry", "jessica", "laura", "liam", "lily", "matilda", "river", "roger", "will"]')
if voice not in allowed: raise SystemExit("Choose an accepted voice ID from this exact model profile")
p["voice"]=voice
p["response_format"]="mp3"
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o speech.mp3
결과 수신 및 저장
Ailoot Ultra · 음성 합성
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
기타 콘텐츠 조회
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
바이너리 결과 전체와 헤더를 보관하세요. JSON 또는 여러 출력이 반환되면 모든 데이터 항목을 보관하고 실제로 반환된 서명된 자산 URL을 각각 조회하세요.
원래 응답을 확인해야 할 경우
다시 제출하지 말고 정산 대조를 위해 최초 operation_id/X-Client-Request-ID를 보관하세요. 전용 오디오 폴링 라우트는 없습니다.
응답 필드
| 필드 | 유형 |
|---|---|
필드binary audio | 유형bytes |
필드response headers | 유형headers |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음 | 다음 단계새 생성 요청 전에 표시된 필드를 수정하세요. |
응답server_error | 조건반환된 응답에 작업 또는 결과 확인이 필요하다고 표시되어 있습니다 | 다음 단계최초로 반환된 작업/태스크 ID, 요청 헤더와 응답을 보관하고, 지원되는 조회 방식으로 해당 최초 작업을 계속 조회하세요. 생성 요청을 다시 제출하지 마세요. |
별칭
모델 별칭
Ailoot Ultra elevenlabs/eleven-turbo-v2
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · ElevenLabs: Eleven Turbo v2
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/audio/speech·elevenlabs/eleven-turbo-v2:text→audio- 요청은 어떤 필드를 사용하나요?
POST /v1/audio/speech·elevenlabs/eleven-turbo-v2:model,input,voice,response_format- 어떤 제한이 적용되나요?
POST /v1/audio/speech·elevenlabs/eleven-turbo-v2:input.maximum_length:30000