요약 / 핵심 포인트
- elevenlabs.io/app/settings/api-keys에서 키를 생성하고 xi-api-key 헤더에 포함하여 전송하십시오.
- 키는 엔드포인트 범위, 크레딧 할당량, IP 허용 목록 및 만료 기한으로 제한할 수 있습니다.
- 텍스트 음성 변환 비용은 모든 플랜에서 1,000자당 $0.08(v4, v3, Multilingual v2) 또는 $0.04(Turbo, Flash)입니다.
- 동시성은 플랜별로 제한됩니다: Free 플랜은 Multilingual v2 요청 2개, Scale 및 Business 플랜은 최대 15개까지 가능합니다.
- Free 플랜에는 매월 10,000자의 v4 API 음성 변환이 포함되어 있습니다.
요약: ElevenLabs API 키를 받으려면 로그인 후 API 키 설정 페이지에서 키를 생성하고 복사한 다음, xi-api-key 헤더에 담아 전송하세요. API 텍스트 음성 변환 비용은 Eleven v4, v3 및 Multilingual v2 모델의 경우 1,000자당 $0.08이며, Turbo 및 Flash 모델은 $0.04입니다. 모든 플랜에서 동일한 요율이 적용됩니다. Free 플랜에는 월 10,000자의 v4 사용량이 포함되어 있습니다.
확인 방법: 설정 단계는 ElevenLabs의 퀵스타트, API 인증 및 API 키 문서를 참조했습니다. 가격 및 제한 사항은 API 요금 페이지와 모델 문서를 기반으로 합니다. 모든 내용은 2026년 11월 1일 elevenlabs.io에서 확인되었습니다. 일부 링크는 제휴 링크이며, 가입 시 사용자에게 추가 비용 없이 ElevenLabs로부터 수수료를 받을 수 있습니다.
ElevenLabs API 키 생성 방법
- 1. 계정 생성 또는 로그인: ElevenLabs에 접속하세요. Free 계정으로도 키를 생성할 수 있습니다.
- 2. API 키 페이지 열기: 개인 API 키 설정으로 이동하세요(대시보드의 개발자 섹션에서도 연결됩니다).
- 3. 키 생성: 나중에 알아보기 쉬운 이름을 지정하세요.
- 4. 제한 설정(선택 사항): 호출 가능한 엔드포인트 제한, 크레딧 할당량 설정, IP 허용 목록 추가 또는 15분에서 30일까지의 만료 기간을 선택할 수 있습니다(기본값은 만료 없음).
- 5. 복사 및 보안 저장:
.env파일에ELEVENLABS_API_KEY=...와 같은 형식으로 저장하세요. 브라우저나 앱 코드에 직접 노출하지 마세요. - 6. SDK 설치: Python의 경우
pip install elevenlabs, JavaScript의 경우npm install @elevenlabs/elevenlabs-js를 사용하세요. - 7. 테스트 호출:
curl https://api.elevenlabs.io/v1/models -H "xi-api-key: $ELEVENLABS_API_KEY"를 실행하면 키로 사용할 수 있는 모델 목록이 반환됩니다.
ElevenLabs는 코딩 에이전트를 위한 단축 명령어도 제공합니다. npx -y @elevenlabs/cli@latest onboard init를 실행하면 브라우저를 통해 로그인하고 키를 생성하여 프로젝트의 env 파일에 자동으로 저장합니다.
알아두어야 할 API 키 규칙
- 두 가지 키 유형: 사용자 키는 개인에게 귀속되며 워크스페이스 내 Full Seat가 필요합니다. 서비스 계정 키는 워크스페이스에 귀속되어 프로덕션 백엔드에 적합하며, 다중 사용자 플랜에서 사용할 수 있고 만료되지 않습니다.
- 제한 사항: 모든 키는 특정 엔드포인트로 범위를 지정하고, 크레딧 한도를 설정하며, 최대 100개의 공용 IP 주소 또는 범위로 잠글 수 있습니다. 다른 IP에서 요청 시 403 오류가 발생합니다.
- 만료: 사용자 키는 자동으로 만료될 수 있으며, 만료된 키는 401 오류를 반환합니다.
- 유출: ElevenLabs는 GitHub의 시크릿 스캔 프로그램에 참여하고 있습니다. 공개 저장소에 푸시된 키는 자동으로 비활성화되며(Enterprise 플랜이 아닌 경우 기본값), 즉시 교체해야 합니다.
- 클라이언트 측 앱: 브라우저 연결을 위해 ElevenLabs는 단기 일회용 토큰을 제공하므로 실제 키가 서버 밖으로 노출되지 않습니다.
모델별 ElevenLabs API 요금
| Model | Price per 1,000 characters | Max characters per request | Languages |
|---|---|---|---|
| Eleven v4 | $0.08 | 10,000 | 90+ |
| Eleven v4 Turbo | $0.04 | not stated | 90+ |
| Eleven v3 | $0.08 | 5,000 | 70+ |
| Eleven v3 Conversational | $0.04 | not stated | 70+ |
| Multilingual v2 | $0.08 | 10,000 | 29 |
| Flash / Turbo (v2.5) | $0.04 | 40,000 | 32 |
API 사용량은 크레딧이 아닌 미국 달러로 청구됩니다. 플랜 요금은 포함된 API 사용 비용으로 간주되므로, 포함된 문자 수는 플랜 가격을 모델 요율로 나눈 값입니다.
| Plan | Price | v4 / v3 / v2 characters | Turbo / Flash characters | Scribe v2 hours |
|---|---|---|---|---|
| Free | $0 | 10,000 | 20,000 | 4.5 |
| Starter | $6 | 75,000 | 150,000 | 27 |
| Creator | $22 | 275,000 | 550,000 | 100 |
| Pro | $99 | 1,238,000 | 2,475,000 | 450 |
| Scale | $299 | 3,738,000 | 7,475,000 | 1,359 |
| Business | $990 | 12,375,000 | 24,750,000 | 4,500 |
기타 API 제품: Scribe v2 전사(transcription)는 오디오 시간당 $0.22($0.39 Realtime), 음악은 분당 $0.15, 효과음, Voice Changer 및 Voice Isolator는 분당 $0.12, Dubbing v1은 워터마크 포함 분당 $0.33(미포함 시 $0.50), Dubbing v2는 분당 $2.20입니다. 플랜 허용량을 초과하면 새 계정은 $5부터 시작하는 Pay As You Go 충전 방식으로 선결제합니다. 사용량은 Developers 대시보드의 Analytics 탭에서 추적할 수 있습니다.
플랜별 요금 제한 및 동시성
ElevenLabs는 분당 요청 횟수가 아닌, 동시에 실행되는 요청 수를 제한합니다. 제한을 초과하는 요청은 대기열에 추가되며, ElevenLabs에 따르면 일반적으로 약 50ms가 추가됩니다.
| Plan | Multilingual v2 | Flash | Speech to text | Realtime STT | Music |
|---|---|---|---|---|---|
| Free | 2 | 4 | 8 | 6 | 0 |
| Starter | 3 | 6 | 12 | 9 | 2 |
| Creator | 5 | 10 | 20 | 15 | 2 |
| Pro | 10 | 20 | 40 | 30 | 2 |
| Scale | 15 | 30 | 60 | 45 | 5 |
| Business | 15 | 30 | 60 | 45 | 5 |
| Enterprise | Elevated | Elevated | Elevated | Elevated | Highest |
문서에 따르면 동시성 제한이 5일 경우 각 요청이 짧기 때문에 일반적으로 약 100개의 동시 오디오 스트림을 처리할 수 있습니다. 텍스트 음성 변환(text to speech) WebSocket에서는 오디오 생성에 소요된 시간만 제한에 포함됩니다. 응답에는 current-concurrent-requests 및 maximum-concurrent-requests 헤더가 포함되어 있어 이를 모니터링할 수 있습니다. 한 가지 주의할 점은, 가격 페이지의 플랜 비교에는 Business 플랜의 동시 요청 수가 25개로 기재되어 있으나 문서 표에는 15개로 되어 있다는 것입니다.
요청당 문자 제한
각 텍스트 음성 변환 요청의 최대 길이는 Eleven v4 및 Multilingual v2의 경우 10,000자, v3의 경우 5,000자, Flash v2.5의 경우 40,000자, Flash v2의 경우 30,000자입니다. 더 긴 스크립트는 청크(chunk) 단위로 나누세요.
이 글이 마음에 드셨나요? 매일 아침 이런 글을 메일로 받아보세요.
하루 한 통 · 두 번의 클릭으로 구독 취소 · 제3자 추적 없음
API 작업을 위한 플랜 선택
- 프로토타이핑: 무료, 10,000자의 v4 문자 및 2개의 동시 요청 제공.
- 소규모 앱 또는 자동화: 상업적 라이선스와 75,000자의 v4 문자를 제공하는 Starter($6) 플랜.
- 실제 트래픽이 있는 프로덕션: 주로 동시성(10~15개의 Multilingual v2 요청)과 더 높은 출력 품질을 위한 Pro 또는 Scale 플랜.
실시간 음성 API를 비교 중이라면, Inworld TTS도 개발자 중심의 또 다른 선택지입니다. 당사의 ElevenLabs 가격 가이드에서 각 플랜의 앱 측면을 다루고 있습니다.
자주 묻는 질문
ElevenLabs API 키는 어떻게 얻나요?
로그인 후 API 키 설정(elevenlabs.io/app/settings/api-keys, 대시보드의 Developers 섹션을 통해서도 접근 가능)을 열고, 클릭하여 키를 생성한 뒤 이름을 지정하고 제한 사항을 설정한 후 복사하세요. .env 파일의 ELEVENLABS_API_KEY와 같이 보안이 유지되는 곳에 저장하세요.
ElevenLabs API는 무료인가요?
무료 허용량이 있습니다: Free 플랜에는 10,000자의 Eleven v4 음성(Turbo 및 Flash 모델의 경우 20,000자)과 약 4.5시간 분량의 Scribe v2 전사 서비스가 포함됩니다. Free 플랜의 출력물은 상업적으로 사용할 수 없습니다.
ElevenLabs API 비용은 얼마인가요?
텍스트 음성 변환 비용은 v4, v3 및 Multilingual v2의 경우 1,000자당 $0.08이며, v4 Turbo, v3 Conversational 및 Flash/Turbo의 경우 $0.04입니다. 음성 텍스트 변환(Speech to text)은 Scribe v2의 경우 오디오 시간당 $0.22, Scribe v2 Realtime의 경우 $0.39입니다.
ElevenLabs API 요금 제한은 어떻게 되나요?
ElevenLabs는 분당 요청 횟수가 아닌 동시 요청 수를 제한합니다. Multilingual v2는 Free 플랜에서 2개, Starter에서 3개, Creator에서 5개, Pro에서 10개, Scale 및 Business에서 15개의 동시 요청을 허용하며, Flash는 그 두 배를 허용합니다. 제한을 초과하는 요청은 대기열에 추가됩니다.
요청 시 API 키는 어디에 넣나요?
xi-api-key라는 이름의 HTTP 헤더에 넣습니다. 공식 Python(elevenlabs) 및 JavaScript(@elevenlabs/elevenlabs-js) SDK는 클라이언트를 생성할 때 api_key 또는 apiKey로 이를 입력받습니다.
API 키가 유출되면 어떻게 되나요?
ElevenLabs는 GitHub의 secret scanning 프로그램에 포함되어 있으므로, 공개 저장소에 커밋된 키는 대부분의 플랜에서 자동으로 비활성화됩니다. 키를 교체하려면 새 키를 생성하고 앱을 전환한 다음 이전 키를 삭제하십시오.