ElevenLabs: Eleven v4
Eleven v4는 맥락에 맞는 표현, 텍스트 안의 오디오 지시, 소리 이벤트로 대본을 표현력 있는 음성으로 바꿉니다. ElevenLabs는 제작 내레이션, 캐릭터 대화, 다국어 오디오를 위해 설계했으며 생성당 한도는 10,000자입니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Eleven v4는 제작 콘텐츠, 내레이션, 인물 연기를 위한 ElevenLabs의 표현력 있는 텍스트 음성 변환 모델입니다. 새 아키텍처는 대본의 맥락을 사용해 누가 말하는지, 무슨 일이 있었는지, 다음 대사가 어떻게 들려야 하는지를 형성합니다. 입력은 선택한 목소리에 연결된 글로 된 대본이고, 출력은 오디오입니다. 제조사는 감정적 대화, 오디오북 제작, 애니메이션과 게임, 다국어 프로젝트를 대표 활용으로 강조합니다.
대본에 인라인 오디오 태그로 연출을 넣을 수 있습니다. [laughs], [whispers], [door slams] 같은 태그는 발화 방식, 비언어적 사건, 장면 속 소리를 설명할 수 있습니다. 문서화된 v4 업데이트는 v3보다 이러한 연속 지시를 더 잘 따릅니다. 짧은 극적 순간에는 실제 대사를 쓰고, 끝에 무관한 감정 목록을 붙이기보다 중요한 지점에 전달 방식의 단서를 넣으세요.
멈춤과 강조는 자연어 오디오 연출 지시를 사용합니다. ElevenLabs는 멈춤에 [pause]와 [long pause]를, 발화 방식에 [excited]나 [sighs] 같은 단서를 문서화합니다. v4에서는 SSML <break> 태그가 비활성화되어 있으므로 해당 태그가 있는 오래된 대본은 v4 연출 형식에 맞춰야 합니다. 태그는 의도한 연기를 지정하며, 그 자체로 정확한 밀리초 수를 설정하거나 고정된 최종 길이를 보장하지 않습니다.
제조사의 대화 워크플로는 여러 화자를 지원해 장면에 서로 다른 목소리와 소리 사건을 넣을 수 있습니다. v4 대화 WebSocket 프로필은 등록된 목소리 최대 열 개를 지원하고, v4 Turbo 프로필은 하나를 사용합니다. 화자 순서를 명확하게 준비하고 각 대사를 의도한 목소리에 연결하세요. 예를 들어 조용하고 불확실한 질문에서 자신 있는 답변으로, 이어서 안도하는 반응으로 넘어가는 대화를 만들 수 있습니다. 내용과 감정의 전환은 대본 자체에서 이해할 수 있어야 합니다. 한 명의 내레이터에서도 같은 명확성을 사용해 서술, 인용 대사, 분위기 변화를 구별하세요.
Eleven v4는 영어, 프랑스어, 독일어, 일본어, 스페인어, 포르투갈어, 러시아어를 포함한 90개 이상의 언어를 지원합니다. 제조사는 언어가 바뀌어도 일관된 목소리 품질을 설명합니다. 녹음의 대상 언어와 지역에 적합한 목소리와 발음을 선택하세요. 대본의 언어와 목소리의 성격이 모두 중요합니다. 현지화한 수업에서는 먼저 발화 문구를 번역하고 새 대본에 의미, 용어, 전달 단서를 보존하세요.
한 번의 생성은 최대 10,000자를 지원합니다. 더 긴 작업은 여러 개의 연결된 생성으로 준비하며, 구간 사이의 속도감과 전달 방식을 일정하게 유지하기 위해 맥락을 이어 붙입니다. 장을 자연스러운 문장이나 장면 경계에서 나누고 주변 맥락을 유지하세요. 제조사는 대사 하나를 다시 생성할 때도 화자 정체성이 안정적으로 유지된다고 설명합니다. 이는 주변 자료의 같은 배역과 연기 스타일을 보존하면서 한 구절을 수정하는 데 유용합니다.
v4는 ElevenLabs의 제조사 워크플로에서 Instant Voice Clones와 Professional Voice Clones를 지원합니다. ElevenLabs는 v4에서 이 기능이 돌아왔음을 강조합니다. v3 프롬프트 가이드는 Professional Voice Clones가 v3에 완전히 최적화되지 않았다고 설명합니다. v4 출시 전에 만든 Instant 또는 Professional Voice Clones는 이 모델에서 효과적으로 작동하려면 v4용으로 재학습해야 합니다. 음성 복제는 합성에 사용할 목소리를 만들거나 준비하는 것으로, 제공한 대본을 음성으로 바꾸는 행위와 별개입니다. 모델 정체성이 특정 기본 목소리를 요구하지 않으므로 모델 이름이 화자를 결정한다고 가정하기보다 내레이터나 인물에 맞는 목소리를 선택하세요.
제조사는 일반 청취와 미디어 전달에 MP3, 비압축 제작 오디오에 WAV 또는 PCM, 전화 통신에 μ-law를 문서화합니다. API는 선택한 형식의 샘플레이트와 비트레이트를 제어합니다. 발음 사전은 이름, 약어, 전문 용어를 어떻게 읽을지 정의할 수 있습니다. v4는 /IPA_transcription/처럼 슬래시로 감싼 표준 IPA 전사도 인식하며, 여러 음절로 된 용어의 강세 표시를 포함합니다. 다만 발음은 목소리와 구절에 따라 여전히 달라질 수 있습니다. 제작 전에 필수 용어를 준비하고 수정 과정에서 선호하는 발음 형태를 일관되게 유지하세요. v4 제조사 프로필은 Stability와 Similarity 음성 설정을 사용하며 Style 및 Speed 슬라이더는 제공하지 않습니다. 속도와 감정 전달은 대본과 오디오 태그로 연출합니다.
실용적인 내레이션 지시에는 완성된 장면, 의도한 목소리, 언어, 감정의 흐름, 오디오의 용도를 제공하세요. 예를 들면 다음과 같습니다. “도입부는 차분히 읽고, 발견 직전에 잠시 멈춘 뒤 마지막 대사는 안도하는 느낌으로 읽으세요. 내레이터의 어조는 일관되게 유지하세요.” 발음, 화자 전환, 들리는 태그나 사건, 구절 간 전환을 검토하세요. 유용한 결과물은 대본과 연결된 제작 음성 녹음이며, 선택한 테이크와 특정 대사를 수정하는 데 필요한 연출 지시를 함께 갖춥니다.
Ailoot Ultra · 음성 합성 POST /v1/audio/speech elevenlabs/eleven-v4
elevenlabs/eleven-v4시작하기
Eleven v4는 맥락에 맞는 표현, 텍스트 안의 오디오 지시, 소리 이벤트로 대본을 표현력 있는 음성으로 바꿉니다. ElevenLabs는 제작 내레이션, 캐릭터 대화, 다국어 오디오를 위해 설계했으며 생성당 한도는 10,000자입니다.
- 허용 입력
- 텍스트
- 결과
- 오디오
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 음성 합성 POST /v1/audio/speech
- 입력
text- 출력
audio- 출력 형식
- mp3
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 elevenlabs/eleven-v4 | 기본값— |
필드input | 유형string | 요건필수 | 값과 한도 최소 길이: 1 최대 길이: 10,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 | 명세10000 |
매개변수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.00016 입력 문자당 |
참조 요금 상세 정보
모델 수준의 참조 요금표는 메서드 선택, 견적 또는 요금을 변경하지 않습니다. 실제 과금에는 선택한 Ailoot 메서드 요금이 적용됩니다.
ElevenLabs: Eleven v4
설정별 가격
| 설정 | 과금 조건 | 요금 |
|---|---|---|
| 설정ElevenLabs: Eleven v4 · 기본 설정 | 과금 조건기본 설정 | 요금 입력 · 입력 문자 수 US$0.00008 입력 문자당 |
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-v4", "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-v4
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · ElevenLabs: Eleven v4
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/audio/speech·elevenlabs/eleven-v4:text→audio- 요청은 어떤 필드를 사용하나요?
POST /v1/audio/speech·elevenlabs/eleven-v4:model,input,voice,response_format- 어떤 제한이 적용되나요?
POST /v1/audio/speech·elevenlabs/eleven-v4:input.maximum_length:10000