ElevenLabs: Eleven Flash v2.5

Eleven Flash v2.5는 다국어 대화형 응답과 음성 애플리케이션을 위해 텍스트를 음성으로 변환합니다. 32개 언어와 요청당 최대 40,000자를 지원하며, 빠른 응답에 초점을 맞춘 모델이므로 숫자와 이름을 발화 형태로 미리 준비하면 유용합니다.

Ailoot Ultra · 음성 합성 POST /v1/audio/speech elevenlabs/eleven-flash-v2.5

모델 소개

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

Eleven Flash v2.5는 실시간·대화형 애플리케이션을 위해 설계된 ElevenLabs의 다국어 텍스트 음성 변환 모델입니다. 입력된 텍스트 응답을 음성 오디오로 바꾸며, 빠른 응답과 자연스러운 표현, 일관된 목소리 특성 사이의 균형을 추구합니다. 제조사는 음성 에이전트, 챗봇, 게임, 즉각적인 피드백이 필요한 애플리케이션, 대규모 텍스트 음성 변환을 대표 용도로 제시합니다.

이 모델은 Multilingual v2의 29개 언어에 헝가리어, 노르웨이어, 베트남어를 더한 32개 언어를 지원합니다. 문서에 명시된 언어에는 영어, 일본어, 중국어, 독일어, 힌디어, 프랑스어, 한국어, 포르투갈어, 이탈리아어, 스페인어, 인도네시아어, 네덜란드어, 튀르키예어, 필리핀어, 폴란드어, 스웨덴어, 불가리아어, 루마니아어, 아랍어, 체코어, 그리스어, 핀란드어, 크로아티아어, 말레이어, 슬로바키아어, 덴마크어, 타밀어, 우크라이나어, 러시아어가 포함됩니다. 이는 영어 전용 Flash v2와 다릅니다. 영어 목소리의 억양이 모든 현지화에 맞는다고 가정하지 말고 대본의 언어와 그에 맞는 지역 목소리를 선택하세요.

요청 하나는 최대 40,000자를 지원합니다. 제조사는 문자 수 표와 함께 대략적인 오디오 시간을 제시하지만 문자 수 한도가 고정된 녹음 길이는 아닙니다. 말하기 속도, 언어, 문장부호, 목소리의 표현 방식이 길이를 바꿉니다. 실시간 응답에는 훨씬 짧은 완결된 문구를 사용하세요. 긴 녹음은 의미 있는 구간에서 대본을 나누고 경계 주변의 맥락을 유지하세요. 높은 문자 수 상한은 원고 준비에 유용하지만, 길게 이어지는 응답이 듣기 쉬워지는 것은 아닙니다.

숫자 정규화는 이 모델의 중요한 차이점입니다. Flash v2.5를 다룬 해당 절은 낮은 지연을 위한 기본 설정에서 정규화가 꺼져 있으며, 전화번호, 날짜, 금액 표기가 예상과 다른 방식으로 읽힐 수 있다고 설명합니다. 합성 전에 원하는 발화 형태를 준비하세요. 숫자가 수량인지, 참조 코드인지, 한 자리씩 반복할 숫자인지 결정하세요. 날짜의 월과 일은 청중에게 들려줄 형태로 쓰고, 약어를 단어로 읽어야 한다면 풀어 쓴 표현을 제공하세요.

발음은 표기를 바꾸거나 사전 별칭을 사용해 유도할 수 있습니다. 제조사의 사전 안내는 phoneme 규칙을 명시된 v4, v3, Flash v2 모델에 한정하고 다른 버전에는 별칭을 권장합니다. 따라서 Flash v2.5가 Flash v2의 phoneme 태그를 지원한다고 간주하면 안 됩니다. 반복해서 등장하는 이름과 용어의 원하는 발음을 유지하고 선택한 목소리로 확인하세요. 일반 텍스트 안에 감정 표현을 설명하는 지시를 넣으면 그 문장 자체가 읽힐 수 있습니다. 원하는 녹음을 위한 깔끔한 최종 대본을 준비하세요.

공통 TTS 워크플로는 스트리밍 오디오와 전체 음성 생성을 지원합니다. 형식 계열에는 MP3, 비압축 16비트 PCM, 전화용 μ-law 및 A-law, Opus가 포함됩니다. 재생 환경에 맞는 형식을 선택하고 생성에 사용한 텍스트를 오디오 옆에서 확인할 수 있게 보관하세요. ElevenLabs의 음성 제어는 일관성과 속도에 영향을 줄 수 있고, 대본의 문구와 문장부호가 의도한 리듬의 상당 부분을 만듭니다. 이는 제조사의 워크플로 옵션이며 특정 애플리케이션에 모든 제어가 제공된다고 가정하는 것과는 별개입니다. 제품 안내는 Flash v2.5의 SSML break를 명시적으로 지원하며, 예를 들어 <break time="1.5s" />로 최대 3초까지 멈춤을 요청할 수 있습니다. break 태그를 지나치게 사용하면 속도가 달라지거나 오디오 이상이 생길 수 있습니다. 공통 속도 제어 범위는 0.7~1.2이며 1.0은 원래 속도입니다.

어시스턴트에는 명확한 결과 하나와 다음 단계 하나를 대화체 문장으로 준비하세요. 예를 들어 작업 완료를 확인하고 아직 필요한 필드 하나를 설명할 수 있습니다. 게임이나 튜토리얼에서는 사용자가 다른 활동을 진행하면서도 이해할 수 있을 만큼 안내를 짧게 유지하세요. 다국어 프로젝트에서는 단어만 바꾸지 말고 실제 문장 표현을 조정하되 이름, 행동, 조건의 의미를 보존하세요.

대본에서 어려운 요소인 이름, 식별자, 날짜, 긴 설명이 들어 있는 대표 문단을 검토하세요. 명료도, 억양, 속도, 숫자가 의도한 방식으로 읽히는지 확인하세요. 제조사 문서에 따르면 합성은 비결정적이므로 입력이 비슷해도 정확한 녹음 결과는 달라질 수 있습니다. 선택한 오디오와 발화용으로 준비한 텍스트를 함께 보관하면 알림, 도움말 응답, 대화형 캐릭터, 녹음된 설명에 재사용할 수 있습니다.

Ailoot Ultra · 음성 합성 POST /v1/audio/speech elevenlabs/eleven-flash-v2.5

elevenlabs/eleven-flash-v2.5

ElevenLabs /elevenlabs/eleven-flash-v2.5

시작하기

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

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

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

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

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

설정별 가격

설정	과금 조건	요금
설정ElevenLabs: Eleven Flash v2.5 · 기본 설정	과금 조건기본 설정	요금 입력 · 입력 문자 수 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-flash-v2.5", "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-flash-v2.5

메서드 경로 별칭

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

ElevenLabs: Eleven Flash v2.5