ElevenLabs: Eleven v3 Conversational

Eleven v3 Conversational은 실시간 대화를 위한 ElevenLabs의 표현력 있는 음성 모델입니다. 준비된 텍스트를 맥락에 맞는 표현과 오디오 태그를 사용해 오디오로 변환하며, 일반 v3 내레이션과 구분되는 제작사 스트리밍 워크플로에서 70개가 넘는 언어를 지원합니다.

Ailoot Ultra · 음성 합성 POST /v1/audio/speech elevenlabs/eleven-v3-conversational

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

Eleven v3 Conversational은 실시간 대화를 위한 ElevenLabs의 음성 합성 버전입니다. 준비된 응답의 텍스트를 받아 v3 계열의 감정 범위와 맥락에 맞는 표현을 담은 음성 오디오를 반환합니다. 제작사는 일반 Eleven v3와 구분하며 Text to Dialogue 스트리밍 워크플로에 배치합니다. 앞선 대화에 따라 다음 발화가 달라지는 어시스턴트나 대화형 캐릭터의 목소리로 유용합니다.

이 모델은 영어, 프랑스어, 독일어, 일본어, 한국어, 스페인어, 포르투갈어, 러시아어를 포함해 70개가 넘는 언어를 지원합니다. 작성된 응답의 언어와 적절한 억양의 목소리를 선택하세요. 다국어 지원 대본은 합성 전에 자연스러운 구어체로 문구를 조정하세요. 모델은 제공된 내용을 말합니다. 응답을 정하는 추론과 사용자의 마이크 입력을 해석하는 과정은 애플리케이션의 별도 단계입니다.

오디오 태그는 감정과 표현을 세밀하게 제어합니다. 안심시키는 답변, 호기심 있는 질문, 극적인 캐릭터 반응은 짧은 문구라도 서로 다른 연기가 필요합니다. 영향을 주는 발화 가까이에 신호를 두고 감정 변화를 설명할 충분한 맥락을 유지하세요. 예를 들어 “정정을 따뜻하게 확인한 뒤 차분하고 주의 깊은 목소리로 다음 단계를 설명하세요.”라는 요구사항을 쓸 수 있습니다. 응답은 신호가 빠진 정보를 대신 제공하지 않아도 이해할 수 있어야 합니다.

문서에 명시된 대화 WebSocket 워크플로에서는 애플리케이션이 텍스트를 보내고 Base64로 인코딩된 오디오 청크를 받으며 연결은 여러 대사에 걸쳐 유지됩니다. 제작사는 일관된 음성 세그먼트에 충분한 텍스트를 버퍼링합니다. 매우 짧은 조각은 맥락이 더 도착하거나 버퍼를 명시적으로 플러시할 때까지 기다릴 수 있습니다. 대화 차례의 경계는 운율을 초기화할 수 있고 화자 변경은 새 차례를 표시합니다. 이러한 특성에 맞춰 대화형 응답에는 고립된 단어보다 완결된 문구를 준비하세요.

공통 대화 안내는 요청되고 제공 가능한 경우 오디오 청크에 선택적인 정렬 정보를 제공한다고 설명합니다. 정렬은 음성을 텍스트와 연결하는 데 도움이 되지만 정해진 발화가 하나의 고정 길이를 갖는다는 약속은 아닙니다. 재생이나 파일 수집에 맞는 제작사 출력 형식을 선택하세요. 공통 TTS 형식 계열에는 MP3와 PCM이 포함되며 관련 워크플로에서 전화용 인코딩도 사용할 수 있습니다. 대화 연결과 전체 사전 녹음 음성 요청은 다른 모드이므로 준비와 타이밍 전제를 구분해야 합니다.

발음을 위해 모호한 약어를 풀어 쓰고 그렇지 않으면 의미가 불분명할 때 숫자를 의도한 발화 형태로 쓰세요. 이름과 반복되는 용어를 일관되게 유지하세요. 계열 이름이 비슷하다는 이유만으로 v4 모델의 기본 IPA 문법이나 일반 v3의 요청 상한을 가져오지 마세요. 대화 역할에 맞는 목소리를 선택한 뒤 대본을 계속하기 전에 대표 대사의 명확성과 감정 적합성을 검토하세요.

실용적인 어시스턴트 응답에는 핵심 생각 하나, 명확한 결과, 사용자가 답할 수 있는 자연스러운 끝맺음을 사용하세요. 예를 들어 “새 배송 주소를 확인하고 도로명을 명확히 반복한 뒤 저장된 주소를 바꾸고 싶은지 물어보세요.”라고 쓸 수 있습니다. 캐릭터는 확립된 인물을 유지하면서 현재 장면에 맞게 반응해야 합니다. 의미 있는 문장 경계에서 긴 설명을 나누고 앞선 대화 맥락을 보존하세요. 결과물은 제공된 응답의 음성 오디오이며 통화자의 전사문이나 독립적으로 생성한 결정이 아닙니다.

Ailoot Ultra · 음성 합성 POST /v1/audio/speech elevenlabs/eleven-v3-conversational

elevenlabs/eleven-v3-conversational

ElevenLabs /elevenlabs/eleven-v3-conversational

시작하기

허용 입력: 텍스트
결과: 오디오

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · 음성 합성 POST /v1/audio/speech

입력: text
출력: audio
출력 형식: mp3

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 elevenlabs/eleven-v3-conversational	기본값—
필드`input`	유형`string`	요건필수	값과 한도 최소 길이: 1 최대 길이: 5,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`	명세5000
매개변수`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 v3 Conversational

설정별 가격

설정	과금 조건	요금
설정ElevenLabs: Eleven v3 Conversational · 기본 설정	과금 조건기본 설정	요금 입력 · 입력 문자 수 US$0.00004 입력 문자당

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · 음성 합성

curl

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-v3-conversational", "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}/content
GET /v1/media/assets
GET /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-v3-conversational

메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

ElevenLabs: Eleven v3 Conversational