| 명령어 | 설명 |
|---|
curl -H "xi-api-key: <api-key>" <endpoint> | API 인증 |
export ELEVEN_API_KEY=<key> | 환경 변수 설정 |
elevenlabs auth login | 계정에 로그인 |
elevenlabs auth logout | 계정에서 로그아웃 |
elevenlabs auth status | 인증 상태 확인 |
| 엔드포인트 | 설명 |
|---|
POST /v1/text-to-speech/{voice_id} | 음성 생성 |
POST /v1/text-to-speech/{voice_id}/stream | 스트림 음성 |
GET /v1/voices | 사용 가능한 음성 목록 |
GET /v1/voices/{voice_id} | 음성 세부 정보 가져오기 |
POST /v1/voices/add | 맞춤 음성 추가 |
| 명령어 | 설명 |
|---|
GET /v1/voices | 모든 음성 목록 |
GET /v1/voices/{voice_id} | 음성 정보 가져오기 |
DELETE /v1/voices/{voice_id} | 사용자 지정 음성 삭제 |
POST /v1/voices/{voice_id}/edit | 음성 설정 편집 |
GET /v1/voices/settings | 음성 설정 가져오기 |
| 명령어 | 설명 |
|---|
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM" -H "xi-api-key: <key>" -H "Content-Type: application/json" -d '{"text": "Hello world"}' | 기본 음성 생성 |
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM/stream" -H "xi-api-key: <key>" | 스트리밍 음성 |
| 명령어 | 설명 |
|---|
pip install elevenlabs | Python SDK 설치 |
from elevenlabs import generate, play | SDK 가져오기 |
generate(text="Hello", voice="Bella") | 음성 생성 |
play(audio) | 생성된 오디오 재생 |
save(audio, "output.mp3") | 오디오 파일 저장 |
| 명령어 | 설명 |
|---|
POST /v1/voices/add | 샘플로부터 음성 클론하기 |
POST /v1/voices/{voice_id}/samples | 음성 샘플 추가 |
DELETE /v1/voices/{voice_id}/samples/{sample_id} | 음성 샘플 삭제 |
GET /v1/voices/{voice_id}/samples | 음성 샘플 목록 |
| 매개변수 | 설명 |
|---|
stability | 음성 일관성 (0.0-1.0) |
similarity_boost | 음성 유사도 (0.0-1.0) |
style | 말하기 스타일 (0.0-1.0) |
use_speaker_boost | 화자 유사성 향상 |
| 형식 | 설명 |
|---|
mp3_44100_128 | MP3 44.1kHz 128kbps |
mp3_22050_32 | MP3 22.05kHz 32kbps |
pcm_16000 | PCM 16kHz |
pcm_22050 | PCM 22.05kHz |
pcm_24000 | PCM 24kHz |
pcm_44100 | PCM 44.1kHz |
| 음성 ID | 이름 | 설명 |
|---|
21m00Tcm4TlvDq8ikWAM | 레이첼 | 미국 여성 |
AZnzlk1XvdvUeBnXmlld | 도미 | 미국 여성 |
EXAVITQu4vr4xnSDxMaL | 벨라 | 미국 여성 |
ErXwobaYiN019PkySvjV | 안토니 | 미국 남성 |
MF3mGyEYCl7XYWbV9V6O | 엘리 | 미국 여성 |
TxGEqnHWrfWFTfGW9XjX | 조시 | 미국 남성 |
VR6AewLTigWG4xSOukaG | 아놀드 | 미국 남성 |
pNInz6obpgDQGcFmaJgB | 아담 | 미국 남성 |
| 명령어 | 설명 |
|---|
npm install elevenlabs | Node.js SDK 설치 |
const { ElevenLabsAPI } = require('elevenlabs') | SDK 가져오기 |
const client = new ElevenLabsAPI({ apiKey: 'key' }) | 클라이언트 초기화 |
client.textToSpeech.generate() | 음성 생성 |
| 명령어 | 설명 |
|---|
POST /v1/text-to-speech/{voice_id}/stream | 오디오 스트림 |
curl -X POST -H "xi-api-key: <key>" --data-raw '{"text":"Hello"}' --output audio.mp3 | 파일로 스트림 |
| 기능 | 설명 |
|---|
Voice Design | 합성 음성 생성하기 |
Voice Cloning | 기존 음성 복제 |
Professional Cloning | 고품질 음성 클로닝 |
Voice Library | 음성 컬렉션 찾아보기 |
| 계획 | 월별 캐릭터 | 동시 요청 |
|---|
Free | 10,000 | 2 |
Starter | 30,000 | 3 |
Creator | 100,000 | 5 |
Pro | 500,000 | 10 |
Scale | 2,000,000 | 25 |
| 오류 코드 | 설명 |
|---|
400 | 잘못된 요청 |
401 | 승인되지 않음 |
403 | 금지됨 |
404 | 찾을 수 없음 |
422 | 처리할 수 없는 엔티티 |
429 | 너무 많은 요청 |
500 | 내부 서버 오류 |
| 매개변수 | 설명 |
|---|
model_id | 사용할 TTS 모델 |
voice_settings | 음성 구성 |
pronunciation_dictionary_locators | 사용자 정의 발음 |
seed | 재현 가능한 생성 |
| 명령어 | 설명 |
|---|
POST /v1/webhooks | 웹훅 생성 |
GET /v1/webhooks | 웹훅 목록 |
DELETE /v1/webhooks/{webhook_id} | 웹훅 삭제 |
PUT /v1/webhooks/{webhook_id} | 웹훅 업데이트 |
| 명령어 | 설명 |
|---|
POST /v1/projects | 프로젝트 생성 |
GET /v1/projects | 프로젝트 목록 |
POST /v1/dubbing | 더빙 프로젝트 생성 |
GET /v1/dubbing/{dubbing_id} | 더빙 상태 가져오기 |
| 명령어 | 설명 |
|---|
GET /v1/user/subscription | 구독 정보 가져오기 |
GET /v1/user | 사용자 정보 가져오기 |
GET /v1/usage/character-stats | 사용 통계 가져오기 |
| 명령어 | 설명 |
|---|
elevenlabs --help | 도움말 표시 |
elevenlabs tts --text "Hello" --voice Rachel | 음성 생성 |
elevenlabs voices list | 음성 목록 |
elevenlabs voices clone --name "MyVoice" | 음성 클론 |
| 코드 | 설명 |
|---|
audio = generate(text="Hello", voice="Bella", model="eleven_monolingual_v1") | 기본 생성 |
play(audio) | 오디오 재생 |
save(audio, "hello.mp3") | 파일로 저장 |
| 코드 | 설명 |
|---|
const audio = await elevenlabs.generate({ text: "Hello", voice: "Rachel" }) | 오디오 생성 |
fs.writeFileSync("audio.mp3", audio) | 파일로 저장 |
| 단계 | 설명 |
|---|
1. Upload samples | 음성 샘플 제공 |
2. Train model | AI가 음성 패턴을 학습합니다 |
3. Test generation | 음성 품질 확인 |
4. Fine-tune settings | 매개변수 조정 |
5. Deploy voice | 프로덕션에서 사용 |
| 연습 | 설명 |
|---|
Clear audio samples | 고품질 녹음 |
Diverse samples | 다양한 감정/스타일 |
Consistent speaker | 전체 과정에서 동일한 사람 |
Proper length | 총 1-5분 |
Good microphone | 전문 녹음 |
| 플랫폼 | 통합 |
|---|
Discord Bot | 음성 메시지 생성 |
Podcast | 자동 내레이션 |
E-learning | 코스 보이스오버 |
Gaming | 캐릭터 보이스 |
Accessibility | 시각 장애인을 위한 텍스트-투-스피치 |
| 문제 | 솔루션 |
|---|
Poor voice quality | 샘플 품질 개선 |
Rate limit exceeded | 업그레이드 계획 또는 대기 |
Authentication failed | API 키 확인 |
Voice not found | 음성 ID 확인 |
Audio distortion | 음성 설정 조정 |
| 변수 | 설명 |
|---|
ELEVEN_API_KEY | API 인증 키 |
ELEVEN_API_URL | API 기본 URL |
ELEVEN_TIMEOUT | 요청 시간 초과 |
| 파일 | 설명 |
|---|
.elevenlabs.json | 구성 파일 |
voices.json | 음성 정의 |
settings.json | 기본 설정 |
| 미터법 | 설명 |
| --------- | ------------- |
Characters used | 월간 사용량 |
API calls | 요청 수 |
Voice generations | 오디오 생성됨 |
Error rate | 실패한 요청들 |
