> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # ElevenLabs 문서 > ElevenLabs API docs for text to speech, speech to text and voice agents, with Python and TypeScript SDKs, model guides, quickstarts and API reference. > **Tip** > > 코딩 에이전트로 시작하세요. 사전에 계정이나 API 키가 필요하지 않습니다. > > Claude Code, Cursor 또는 Codex에 아래 내용을 붙여 넣으세요. 로그인하거나 계정을 만들고, 키를 생성한 뒤 프로젝트에 SDK를 추가합니다. > > ```text > Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints. > ``` > > [작동 방식 보기](/docs/ko/eleven-api/quickstart#set-up-with-your-coding-agent) 또는 에이전트에 정확히 어떤 내용을 전달하는지 확인하려면 [`onboard` 명령어의 소스](https://github.com/elevenlabs/cli/tree/main/cli/elevenlabs/workflow/onboard)를 읽어 보세요. ## ElevenLabs는 어떻게 작동하나요? ElevenLabs는 텍스트 음성 변환, 음성 텍스트 변환, 음성 복제, 음성 에이전트, 생성형 오디오를 위한 AI 음성 인프라를 제공합니다. 대상에 따라 적합한 4가지 방식으로 사용할 수 있습니다. **[ElevenCreative](/docs/ko/eleven-creative)** 는 크리에이터, 프로듀서, 편집자가 브라우저에서 직접 보이스오버, 음악, 더빙, 스튜디오 프로젝트를 생성할 수 있는 노코드 웹 애플리케이션입니다. **[ElevenAgents](/docs/ko/eleven-agents)** 는 비기술 사용자를 위한 시각적 빌더와 개발자를 위한 완전한 프로그래밍 방식 제어 기능을 갖춘 음성 에이전트 설계 및 운영 플랫폼입니다. **[ElevenAPI](/docs/ko/eleven-api)** 는 모든 기능을 공식 Python 및 TypeScript SDK와 함께 REST 인터페이스로 제공하므로, 개발자는 자체 애플리케이션과 워크플로에 음성을 통합할 수 있습니다. **[Reception.ai](/docs/ko/reception-ai)** 는 소규모 및 중견 기업을 위한 즉시 배포 가능한 AI 전화 리셉셔니스트로, 하나의 대시보드에서 전화를 받고, 예약을 잡고, 일상 운영을 관리합니다. ## 경로 선택 [![](/docs/_fern-files/_img/12097a437e55f60c199946cf59c9528eb8349d110142394833d67fe93b50e68d.webp)](/docs/ko/eleven-creative/overview) ### ElevenCreative 단계별 가이드로 ElevenCreative 플랫폼 사용 방법 알아보기 [![](/docs/_fern-files/_img/7375358c43ac5dd1a170937123f0874e01b3d8b6cf178c282805588a11d39593.webp)](/docs/ko/eleven-agents/overview) ### ElevenAgents ElevenLabs로 에이전트를 구축, 출시, 확장하는 방법 알아보기 [![](/docs/_fern-files/_img/002b2432fa6ab18befc9f1a6e7fadf348f46506a5a5a72a2358ba1e7f92d8ded.webp)](/docs/ko/eleven-api/quickstart) ### ElevenAPI 예제와 튜토리얼로 ElevenLabs API 통합 방법 알아보기 ## 개념 **음성**은 오디오 생성에 사용되는 음성 페르소나입니다. 각 음성에는 고유 ID가 있으며, 예를 들어 `JBFqnCBsd6RMkjVDRZzb`와 같이 대시보드에서 선택하거나 API 요청에 전달합니다. ElevenLabs는 [10,000개 이상의 음성 라이브러리](https://elevenlabs.io/app/voice-library)를 제공합니다. 오디오 녹음에서 음성을 복제하거나 텍스트 설명을 바탕으로 생성할 수도 있습니다. **모델**은 생성된 오디오의 품질, 지연 시간, 언어 지원 범위를 제어합니다. [`eleven_v4`](/docs/ko/overview/models)는 90개 이상의 언어에서 가장 풍부한 표현력을 제공합니다. [`eleven_v4_turbo`](/docs/ko/overview/models)는 중앙값 약 100ms의 추론 지연 시간으로 실시간 사용에 적합합니다. 음성 텍스트 변환, 음악, 음향 효과 등 각 기능에는 전용 모델이 있습니다. 모델을 선택하려면 [어떤 모델을 사용해야 하나요?](#which-model-should-i-use)를 참고하세요. ## 가격은 어떻게 책정되나요? **크레딧**은 모든 제품에서 공통으로 사용하는 소비 단위입니다. 텍스트 음성 변환은 입력 텍스트 1자당 크레딧 1개가 필요합니다. 다른 작업은 처리된 오디오의 초 단위로 과금됩니다. 크레딧은 매월 초기화되며, 사용하지 않은 크레딧은 최대 2개월간 이월됩니다. 자세한 내역은 [가격](https://elevenlabs.io/pricing/api)을 참고하세요. 월간 구독 없이 API를 사용하려면 [종량제](/docs/ko/overview/administration/pay-as-you-go)를 통해 잔액을 선불로 충전할 수 있습니다. 구독 크레딧을 모두 사용한 후 ElevenLabs 사용량에 따라 잔액이 차감됩니다. ## 프로덕션 환경을 위한 설계 ### ElevenLabs 텍스트 음성 변환은 얼마나 빠른가요? Eleven Flash v2.5는 모델 추론 지연 시간 약 75ms로 오디오를 생성하며, Eleven v4 Turbo의 중앙값은 약 100ms입니다. Scribe v2 Realtime은 약 150ms 내에 부분 트랜스크립트를 반환합니다. 이 수치에는 애플리케이션 및 네트워크 지연 시간이 포함되지 않으므로, 사용자가 오디오를 듣기까지 걸리는 시간은 더 깁니다. [지연 시간 이해하기](/docs/ko/eleven-api/concepts/latency)에서 수치에 포함되는 범위를 설명하며, [지연 시간 최적화](/docs/ko/eleven-api/guides/how-to/best-practices/latency-optimization)에서 종단 간 지연 시간을 줄이는 방법을 다룹니다. ### ElevenLabs는 규모 확장을 어떻게 처리하나요? 요금제에 따라 동시에 처리할 수 있는 요청 수가 결정됩니다. 동시성 한도는 동시 대화 수의 상한이 아닙니다. 일반적으로 한도 5는 사용되는 음성과 사용 사례에 따라 약 100개의 동시 오디오 브로드캐스트를 지원할 수 있습니다. 엔터프라이즈 요금제는 더 높은 한도를 제공합니다. 요금제별 한도와 부하 테스트 지침은 [동시성 및 우선순위](/docs/ko/overview/models#concurrency-and-priority)를 참고하세요. ### 엔터프라이즈 제어 기능 * **[프라이빗 배포](/docs/ko/overview/capabilities/private-deployment)** 는 자체 클라우드 계정 내에서 ElevenAgents, 텍스트 음성 변환, 음성 텍스트 변환을 실행하므로 텍스트, 오디오, 트랜스크립트가 네트워크 내에 유지됩니다. * **[데이터 레지던시](/docs/ko/overview/administration/data-residency)** 는 기본 미국 위치 대신 EU, 인도 또는 싱가포르의 격리된 환경에 데이터를 저장합니다. 엔터프라이즈 기능입니다. * **[워크스페이스](/docs/ko/overview/administration/workspaces/overview)** 는 청구, 공유 리소스, 팀 액세스, API 키 관리를 한곳에 모읍니다. 엔터프라이즈 워크스페이스는 SAML 2.0 또는 OIDC 기반 [SSO](/docs/ko/overview/administration/workspaces/sso)와 OCSF 스키마의 관리 작업 [감사 로그](/docs/ko/overview/administration/workspaces/audit-logs)를 추가로 제공합니다. ## 첫 오디오 생성하기 SDK를 설치하고 API 키를 환경 변수로 설정한 다음, 단일 요청으로 텍스트를 MP3 파일로 변환하세요. 대신 코딩 에이전트가 이 설정을 수행하도록 하려면 [코딩 에이전트로 설정하기](/docs/ko/eleven-api/quickstart#set-up-with-your-coding-agent)를 참고하세요. #### SDK 설치 **`Python`** ```bash title="Python" pip install elevenlabs python-dotenv ``` **`TypeScript`** ```bash title="TypeScript" npm install @elevenlabs/elevenlabs-js dotenv ``` #### API 키 설정 [API 키를 생성](https://elevenlabs.io/app/settings/api-keys)한 후 프로젝트 디렉터리의 `.env` 파일에 추가하세요. **`.env`** ```js title=".env" ELEVENLABS_API_KEY= ``` #### 오디오 생성 및 저장 ```python from dotenv import load_dotenv from elevenlabs.client import ElevenLabs import os load_dotenv() elevenlabs = ElevenLabs( api_key=os.getenv("ELEVENLABS_API_KEY"), ) audio = elevenlabs.text_to_speech.convert( text="The first move is what sets everything in motion.", voice_id="JBFqnCBsd6RMkjVDRZzb", # "George" - browse voices at elevenlabs.io/app/voice-library model_id="eleven_v4", output_format="mp3_44100_128", ) with open("output.mp3", "wb") as f: for chunk in audio: f.write(chunk) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; import "dotenv/config"; import { writeFile } from "node:fs/promises"; const elevenlabs = new ElevenLabsClient(); const audio = await elevenlabs.textToSpeech.convert( "JBFqnCBsd6RMkjVDRZzb", // "George" - browse voices at elevenlabs.io/app/voice-library { text: "The first move is what sets everything in motion.", modelId: "eleven_v4", outputFormat: "mp3_44100_128", } ); await writeFile("output.mp3", Buffer.from(await new Response(audio).arrayBuffer())); ``` `python example.py` 또는 `npx tsx example.mts`로 스크립트를 실행한 후 `output.mp3`를 여세요. 터미널에서 동일하게 수행하려면 [ElevenLabs CLI](/docs/ko/eleven-api/quickstart)를 사용하세요. ```bash elevenlabs text-to-speech convert \ --voice-id JBFqnCBsd6RMkjVDRZzb \ --model-id eleven_v4 \ --text "The first move is what sets everything in motion." \ --output-format mp3_44100_128 \ --output output.mp3 ``` [ElevenAPI 빠른 시작](/docs/ko/eleven-api/quickstart)에서는 CLI 설정과 스피커를 통한 오디오 재생을 포함해 동일한 요청을 더 자세히 다룹니다. ## ElevenAgents로 무엇을 만들 수 있나요? ElevenAgents는 음성 인식, 선택한 LLM, 텍스트 음성 변환, 턴 테이킹을 하나의 음성 에이전트로 결합하며, 대시보드 또는 SDK를 통해 구성할 수 있습니다. * **고객 지원**: 에이전트에 [지식 베이스](/docs/ko/eleven-agents/customization/knowledge-base)를 연결하여 자체 문서의 질문에 답변하세요. * **전화선**: [네이티브 통합](/docs/ko/eleven-agents/phone-numbers/twilio-integration/native-integration)으로 Twilio 번호를 연결해 수신 및 발신 전화를 처리하거나, SIP 트렁킹을 통해 기존 전화 시스템을 연결하세요. * **아웃바운드 캠페인**: [일괄 통화](/docs/ko/eleven-agents/phone-numbers/batch-calls)로 한 번에 여러 발신 전화를 걸 수 있습니다. * **웹사이트 및 앱**: [위젯](/docs/ko/eleven-agents/customization/widget)으로 음성과 텍스트를 모두 처리하는 에이전트를 삽입하세요. [ElevenAgents 빠른 시작](/docs/ko/eleven-agents/quickstart)에서 첫 에이전트를 처음부터 끝까지 구축합니다. ## 어떤 모델을 사용해야 하나요? 사용 사례부터 시작하세요. 아래의 각 모델 ID는 API 요청에서 `model_id`로 전달할 값입니다. | 사용 사례 | 권장 모델 | 모델 ID | 이유 | | ----------------- | ------------------ | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | 실시간 음성 에이전트 | Eleven v4 Turbo | `eleven_v4_turbo` | 가장 풍부한 실시간 전달 품질과 약 100ms†의 중앙값 추론 지연 시간. 가장 낮은 지연 시간이 필요하면 `eleven_flash_v2_5`(\~75ms†)를 사용하세요. | | 표현력 있는 또는 장문 내레이션 | Eleven v4 | `eleven_v4` | 가장 표현력이 풍부한 모델로, 오디오북과 캐릭터 보이스오버에 적합합니다. 요청당 최대 10,000자(약 10분 분량의 오디오)를 지원합니다. 가장 안정적인 장문 출력을 위해서는 `eleven_multilingual_v2`를 사용하세요. | | 다국어 콘텐츠 | Eleven v4 | `eleven_v4` | 언어 전환 시에도 일관된 음성 품질로 90개 이상의 언어를 지원합니다. `eleven_v4_turbo`는 동일한 언어를 실시간으로 지원합니다. | | 최저 비용 | Eleven Flash v2.5 | `eleven_flash_v2_5` | API 생성 시 문자당 가격이 50% 낮고, 32개 언어 및 요청당 최대 40,000자를 지원합니다. | | 음성 텍스트 변환, 일괄 처리 | Scribe v2 | `scribe_v2` | 단어 수준 타임스탬프, 최대 32명 화자의 화자 분리, 핵심 용어 프롬프팅을 포함해 90개 이상의 언어로 트랜스크립션합니다. 임상 오디오에는 `scribe_v2_medical`을 사용하세요. | | 음성 텍스트 변환, 실시간 | Scribe v2 Realtime | `scribe_v2_realtime` | 90개 이상의 언어로 약 150ms† 지연 시간의 트랜스크립트를 스트리밍합니다. | 더 많은 사용 사례는 [적합한 모델 선택하기](/docs/ko/eleven-api/choosing-the-right-model)를, 전체 사양은 [모델 레퍼런스](/docs/ko/overview/models)를 참고하세요. #### [Eleven v4](/docs/ko/overview/models#eleven-v4) 가장 감정 표현이 풍부하고 고품질인 음성 합성 모델 탁월한 음성 복제 기능 90개 이상의 언어 지원 10,000자 제한 자연스러운 다화자 대화 지원 #### [Eleven v4 Turbo](/docs/ko/overview/models#eleven-v4-turbo) 가장 감정 표현이 풍부한 실시간 음성 합성 모델 초저지연(중앙값 추론 지연 시간 약 100ms†) 탁월한 음성 복제 기능 90개 이상의 언어 지원 세밀한 제어를 위한 오디오 태그 #### [Eleven v3](/docs/ko/overview/models#eleven-v3) 감정이 풍부하고 표현력이 뛰어난 음성 합성 모델 극적인 전달력과 연기 70개 이상의 언어 지원 5,000자 제한 자연스러운 다화자 대화 지원 #### [Eleven v3 Conversational](/docs/ko/overview/models#eleven-v3-conversational) 표현력이 뛰어난 실시간 음성 합성 모델 낮은 지연 시간(\~280ms) 극적인 전달력과 연기 70개 이상의 언어 지원 세밀한 제어를 위한 오디오 태그 #### [Eleven Multilingual v2](/docs/ko/overview/models#multilingual-v2) 생생하고 일관된 품질의 음성 합성 모델 자연스러운 출력 29개 언어 지원 10,000자 제한 긴 형식 생성에서 가장 안정적 #### [Eleven Flash v2.5](/docs/ko/overview/models#flash-v25) 빠르고 합리적인 가격의 음성 합성 모델 초저지연(\~75ms†) 32개 언어 지원 40,000자 제한 더 빠른 모델, API 생성 시 문자당 가격 50% 절감 #### [Scribe v2](/docs/ko/overview/models#scribe-v2) 최첨단 음성 인식 모델 90개 이상의 언어에서 정확한 트랜스크립션 최대 1,000개 용어의 키워드 프롬프팅 65개 엔터티 유형의 엔터티 감지 자연어 지침으로 트랜스크립트 편집 정확한 단어 단위 타임스탬프 최대 32명 화자의 화자 분리 동적 오디오 태깅 스마트 언어 감지 #### [Scribe v2 Realtime](/docs/ko/overview/models#scribe-v2-realtime) 실시간 음성 인식 모델 90개 이상의 언어에서 정확한 트랜스크립션 실시간 트랜스크립션 낮은 지연 시간(\~150ms†) 정확한 단어 단위 타임스탬프 65개 엔터티 유형의 엔터티 감지 자연어 지침으로 트랜스크립트 편집 #### [Scribe v2 Medical](/docs/ko/overview/models#scribe-v2-medical) 임상 오디오에 맞춰 미세 조정된 음성 인식 Scribe v2보다 임상 오디오 트랜스크립션 오류 35% 감소 일상 음성에서 Scribe v2와 동일한 정확도 Scribe v2와 동일한 기능, 언어, 가격 및 API [전체 보기](/docs/ko/overview/models) † 애플리케이션 및 네트워크 지연 시간 제외. [지연 시간 이해하기](/docs/ko/eleven-api/concepts/latency)를 참고하세요. ## 기능별 탐색 텍스트 음성 변환 텍스트를 생생한 음성으로 변환 음성 텍스트 변환 음성 오디오를 텍스트로 변환 음악 텍스트로 음악 생성 텍스트 대화 생성 텍스트로 자연스러운 대화 생성 이미지 & 비디오 텍스트로 이미지와 비디오 생성 보이스 체인저 음성 수정 및 변환 보이스 아이솔레이터 배경 소음에서 음성 분리 더빙 오디오와 비디오를 자연스럽게 더빙 음향 효과 영화 같은 음향 효과 제작 음성 맞춤형 음성 복제 및 디자인 음성 리믹싱 기존 음성 변환 및 향상 강제 정렬 텍스트를 오디오에 정렬 음성 엔진 어디에나 음성 추가 ElevenAgents 지능형 음성 에이전트 배포 프라이빗 배포 자체 클라우드에서 ElevenLabs 실행